רכיבי מאקרו ב-Google Sheets

ב-Google Sheets אפשר להקליט פקודות מאקרו שמשכפלות סדרה ספציפית של אינטראקציות עם ממשק המשתמש שאתם מגדירים. אחרי שהקלטת המאקרו, ניתן לקשר אותו למקשי קיצור שמופיעים בצורה Ctrl+Alt+Shift+Number אתם יכולים להשתמש במקש הקיצור הזה כדי להפעיל במהירות בשלבי מאקרו מדויקים, בדרך כלל במקום אחר או על נתונים שונים. אפשר גם להפעיל את המאקרו דרך התוספים של Google Sheets. > התפריט רכיבי מאקרו.

כשמקליטים פקודת מאקרו, מערכת Google Sheets יוצרת באופן אוטומטי Apps Script (פונקציית המאקרו) שמחחזרת את שלבי המאקרו. המאקרו נוספה לפרויקט Apps Script כפוף לגיליון, בקובץ בשם macros.gs. במקרה שכבר קיים קובץ פרויקט שמקושר לגיליון בשם הזה, פונקציית המאקרו שמצורף אליה. מערכת Google Sheets גם תעדכן את הסקריפט באופן אוטומטי מניפסט של פרויקט, תיעוד השם ומקשי הקיצור שהוקצו למאקרו.

מכיוון שכל מאקרו מוקלט מוגדר במלואו ב-Apps Script, אפשר לערוך אותם ישירות בתוך עורך Apps Script. אפשר אפילו לכתוב פקודות מאקרו מאפס ב-Apps Script, או להשתמש בפונקציות שכבר כתבתם להפוך אותן לרכיבי מאקרו.

יצירת פקודות מאקרו ב-Apps Script

אפשר להשתמש בפונקציות שנכתבו ב-Apps Script ולהשתמש בהן כפונקציות מאקרו. הדרך הקלה ביותר לעשות זאת היא ייבוא של פונקציה קיימת עורך ב-Google Sheets.

לחלופין, אפשר ליצור פקודות מאקרו בעורך Apps Script באמצעות באמצעות השלבים הבאים:

1. בממשק המשתמש של Google Sheets, בוחרים באפשרות תוספים >. Apps Script כדי לפתוח את שמקושר לגיליון בעורך Apps Script.
2. כותבים את פונקציית המאקרו. פונקציות מאקרו לא יכולות לקבל ארגומנטים ולהחזיר אין ערכים.
3. עורכים את מניפסט הסקריפט כדי ליצור את המאקרו ולקשר אותו לפונקציית המאקרו. כדאי להקצות לו שם ייחודי מקש קיצור ושם.
4. שומרים את פרויקט הסקריפט. לאחר מכן פקודת המאקרו זמינה לשימוש בגיליון.
5. בודקים את פונקציית המאקרו בגיליון כדי לוודא שהיא פועלת כצפוי.

עריכה של רכיבי מאקרו

כדי לערוך פקודות מאקרו שמצורפים לגיליון, מבצעים את הפעולות הבאות:

1. בממשק המשתמש של Google Sheets, בוחרים באפשרות תוספים >. רכיבי מאקרו > ניהול פקודות מאקרו.
2. מחפשים את פקודת המאקרו שרוצים לערוך ולוחצים על. > עריכה של פקודת המאקרו. תיפתח עורך Apps Script לקובץ הפרויקט שמכיל את פונקציית המאקרו.
3. כדי לשנות את התנהגות המאקרו, עורכים את פונקציית המאקרו.
4. שומרים את פרויקט הסקריפט. לאחר מכן פקודת המאקרו זמינה לשימוש בגיליון.
5. בודקים את פונקציית המאקרו בגיליון כדי לוודא שהיא פועלת כצפוי.

ייבוא פונקציות בתור רכיבי מאקרו

אם כבר יש סקריפט שמקושר לגיליון, אפשר לייבא פונקציה בסקריפט כמאקרו חדש ואז להקצות אותה מקש קיצור. כדי לעשות זאת, צריך עריכת המניפסט ולהוסיף עוד רכיב sheets.macros[].

לחלופין, בצעו את השלבים הבאים כדי לייבא פונקציה כמאקרו ממשק המשתמש של Sheets:

1. בממשק המשתמש של Google Sheets, בוחרים באפשרות תוספים >. רכיבי מאקרו > ייבוא.
2. בוחרים פונקציה מהרשימה המוצגת ולוחצים על Add function.
3. בוחרים באפשרות כדי לסגור את תיבת הדו-שיח.
4. בוחרים באפשרות תוספים > רכיבי מאקרו > ניהול פקודות מאקרו.
5. מאתרים ברשימה את הפונקציה שייבאתם עכשיו. הקצאת מקלדת ייחודית מקש קיצור למאקרו. ניתן גם לשנות את השם של המאקרו כאן; השם ברירת המחדל היא שם הפונקציה.
6. לוחצים על Update (עדכון) כדי לשמור את הגדרת המאקרו.

מבנה מניפסט לפקודות מאקרו

קטע הקוד לדוגמה של קובץ המניפסט הבא את הקטע מניפסט שמגדיר פקודות מאקרו של Google Sheets. הקטע sheets במניפסט מגדיר את השם ומקשי הקיצור למאקרו ולשם של פונקציית המאקרו.

הערה: המניפסטים כוללים רכיבים אחרים שקשורים למאפיינים של Apps Script. השדות בקטע sheets קשורים ישירות לפונקציונליות של Sheets. דוגמה זו היא רק חלק מקובץ מניפסט מלא ולא מניפסט של פונקציונליות מלאה.

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

מידע על המשאב למניפסט המאקרו של Sheets .תוכלו לקבל פרטים נוספים על המבנה של מניפסטי מאקרו של Sheets.

שיטות מומלצות

כשיוצרים או מנהלים פקודות מאקרו ב-Apps Script, מומלץ לפעול בהתאם להנחיות הבאות.

1. הביצועים של רכיבי מאקרו טובים יותר כשהם קלים. כשהדבר אפשרי, הגבילו מספר הפעולות שמבצע מאקרו.
2. פקודות מאקרו מתאימות במיוחד לפעולות רוטציה שצריכות לחזור על עצמן לעיתים קרובות ללא הגדרות אישיות, או ללא הגדרות אישיות. לגבי פעולות אחרות, כדאי באמצעות אפשרות מותאמת אישית בתפריט.
3. זכרו תמיד שמקשי הקיצור של המאקרו צריכים להיות ייחודיים, הגיליון יכול לכלול עשר פקודות מאקרו עם קיצורי דרך בכל רגע נתון. כל סוג נוסף של ניתן להריץ פקודות מאקרו רק דרך תוספים > התפריט רכיבי מאקרו.
4. אפשר להחיל רכיבי מאקרו שמבצעים שינויים בתא יחיד על טווח קודם צריך לבחור את הטווח המלא ואז להפעיל את פקודת המאקרו. פירוש הדבר הוא שבמקרים רבים אין צורך ליצור פקודות מאקרו שמשכפלות פעולה זהה בטווח מוגדר מראש של תאים.

דברים שאסור לעשות

יש מספר הגבלות על הפעולות שניתן לבצע באמצעות פקודות מאקרו:

שימוש בפקודות מאקרו מחוץ לסקריפטים תחומים

פקודות מאקרו מוגדרים בסקריפטים שמקושרים ל-Google Sheets ספציפיים. מאקרו המערכת מתעלמת מהגדרות אם הן מוגדרות סקריפט עצמאי או אפליקציית אינטרנט.

הגדרה של פקודות מאקרו בתוספים ל-Sheets

לא ניתן להפיץ הגדרות מאקרו באמצעות תוסף של Sheets. הגדרות מאקרו ב-Sheets המשתמשים באותו תוסף מתעלמים ממנו.

הפצה של פקודות מאקרו בספריות סקריפטים

לא ניתן להפיץ הגדרות מאקרו באמצעות Apps Script ספריות.

שימוש בפקודות מאקרו מחוץ ל-Google Sheets

פקודות מאקרו הן תכונה בלבד ב-Google Sheets, והן לא קיימות ב-Google Docs. Forms או Slides.