רמת תכנות: למתחילים
משך: 5 דקות
סוג הפרויקט: פונקציה מותאמת אישית
מטרות
- להבין מה הפתרון עושה.
- להבין מה שירותי Apps Script עושים במסגרת לפתרון הבעיה.
- מגדירים את הסקריפט.
- מריצים את הסקריפט.
מידע על הפתרון הזה
אם יש נתונים מובְנים דומים בכמה גיליונות בגיליון אלקטרוני, למשל בתור מדדים של תמיכת לקוחות בשביל חברי צוות, אפשר להשתמש בפונקציה המותאמת אישית כדי ליצור סיכום של כל גיליון. הפתרון הזה מתמקד בתמיכת לקוחות אבל אפשר להתאים אותו אישית לפי הצרכים שלך.
איך זה עובד
הפונקציה המותאמת אישית, שנקראת getSheetsData()
, מסכמת את הנתונים מכל גיליון
בגיליון האלקטרוני, על סמך העמודה סטטוס שלו. הסקריפט מתעלם
גיליונות שלא צריכים להיכלל במאגר הנתונים, כמו ReadMe
גיליונות סיכום.
שירותי Apps Script
הפתרון הזה משתמש בשירות הבא:
- שירות גיליונות אלקטרוניים – מקבל את הגיליונות שצריך לסכם אותם ולספור את מספר הפריטים שתואמים המחרוזת שצוינה. לאחר מכן, הסקריפט מוסיף את המידע המחושב לטווח ביחס למיקום שבו נקראה הפונקציה המותאמת אישית בגיליון האלקטרוני.
דרישות מוקדמות
כדי להשתמש בדוגמה הזו, צריך לעמוד בדרישות המוקדמות הבאות:
- חשבון Google (חשבונות Google Workspace עשויים נדרש אישור של האדמין).
- דפדפן אינטרנט עם גישה לאינטרנט.
הגדרת הסקריפט
יש ללחוץ על הלחצן שלמטה כדי ליצור עותק של סיכום הנתונים של הגיליון האלקטרוני
גיליון אלקטרוני עם פונקציה מותאמת אישית. פרויקט Apps Script עבור
הפתרון הזה מצורף לגיליון האלקטרוני.
יצירת עותק
מריצים את הסקריפט
- בגיליון האלקטרוני שהעתקתם, נכנסים לגיליון סיכום.
- לוחצים על התא
A4
. הפונקציהgetSheetsData()
נמצאת בתא הזה. - נכנסים לאחד מגיליונות הבעלים ומעדכנים או מוסיפים נתונים לגיליון. במידה מסוימת
תוכלו לנסות את הפעולות הבאות:
- מוסיפים שורה חדשה עם פרטי כרטיס לדוגמה.
- בעמודה סטטוס, משנים את הסטטוס של כרטיס קיים.
- משנים את המיקום של העמודה סטטוס. לדוגמה, ב הגיליון Owner1, מעבירים את העמודה Owner1 מעמודה ג' לעמודה ד'.
- עוברים לגיליון סיכום ובודקים את טבלת הסיכום המעודכנת
הפונקציה
getSheetsData()
נוצרה מהתאA4
. אולי יהיה צורך לסמן את תיבת הסימון בשורה 10 כדי לרענן את התוצאות שנשמרו במטמון של הפונקציה המותאמת אישית. Google שומרת במטמון פונקציות מותאמות אישית כדי לשפר את הביצועים.- אם הוספתם או עדכנתם שורות, הסקריפט יעדכן את הפנייה ואת הסטטוס. סופרים.
- אם שיניתם את המיקום של העמודה סטטוס, הסקריפט עדיין פועל כמתוכנן באינדקס העמודות החדש.
בדיקת הקוד
כדי לבדוק את קוד Apps Script של הפתרון הזה, לוחצים על הצגת קוד מקור למטה:
הצגת קוד המקור
Code.gs
שינויים
אפשר לערוך את הפונקציה המותאמת אישית כמה שרוצים. נמצא למטה היא תוספת אופציונלית לרענון ידני של תוצאות של פונקציות מותאמות אישית.
רענון של התוצאות שנשמרו במטמון
בניגוד לפונקציות מובנות, Google שומרת במטמון פונקציות מותאמות אישית כדי לבצע אופטימיזציה או של ביצועים. המשמעות היא שאם אתם משנים משהו בתוך של הפונקציה, כגון ערך שמחושב, ייתכן שהוא לא לאלץ עדכון. כדי לרענן את התוצאה של הפונקציה באופן ידני, מבצעים את הפעולות הבאות שלבים:
- כדי להוסיף תיבת סימון לתא ריק, לוחצים על הוספה. > תיבת סימון.
- מוסיפים את התא שבו מופיעה תיבת הסימון כפרמטר של הפונקציה המותאמת אישית.
לדוגמה,
getSheetsData(B11)
. - כדי לרענן את התוצאות של הפונקציה המותאמת אישית, מסמנים את התיבה או מבטלים את הסימון שלה.
תורמים
הדוגמה הזו מתוחזקת על ידי Google בעזרת מומחי המפתחים של Google.