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