תפריטים מותאמים אישית ב-Google Workspace

סקריפטים יכולים להרחיב מוצרים מסוימים של Google על ידי הוספת רכיבי ממשק משתמש שכאשר לוחצים עליו, הוא מפעיל פונקציית Apps Script. הדוגמה הנפוצה ביותר היא להריץ סקריפט מפריט מותאם אישית בתפריט ב-Google Docs, Sheets, Slides, או ב-Forms, אבל אפשר להפעיל פונקציות של סקריפטים גם על ידי לחיצה על תמונות שרטוטים ב-Google Sheets.

תפריטים מותאמים אישית ב-Google Docs , Sheets , Slides או Forms

אפשר להשתמש ב-Apps Script כדי להוסיף תפריטים חדשים ב-Google Docs,‏ Sheets,‏ Slides או Forms, כאשר כל פריט בתפריט מקושר לפונקציה בסקריפט. (ב-Google Forms, תפריטים מותאמים אישית) גלויות רק לעורך שפותח את הטופס כדי לשנות אותו, לא למשתמש פותח את הטופס כדי להשיב.)

סקריפט יכול ליצור תפריט רק אם מקושרים למסמך, לגיליון האלקטרוני או לטופס. כדי להציג את התפריט כשהמשתמש פותח קובץ, כותבים את קוד התפריט בתוך פונקציית onOpen().

הדוגמה הבאה מראה איך להוסיף תפריט עם פריט אחד, ואחריו מפריד חזותי, ואז תפריט משנה שכולל פריט אחר. (לתשומת ליבכם: ב-Google Sheets, אלא אם אתם משתמשים new version, צריך להשתמש addMenu() במקום זאת, ולא ניתן להשתמש בתפריטי משנה.) כשהמשתמש בוחר באחת מהאפשרויות אפשרות בתפריט, פונקציה מתאימה פותחת התראה. לקבלת מידע נוסף מידע על סוגי תיבות הדו-שיח שאפשר לפתוח, המדריך לתיבות דו-שיח ולסרגלי צד.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
     .alert('You clicked the second menu item!');
}

כל מסמך, גיליון אלקטרוני, מצגת או טופס יכול להכיל רק תפריט אחד עם יש לו שם נתון. אם אותו סקריפט או סקריפט אחר מוסיפים תפריט עם אותו השם, התפריט החדש יחליף את התפריט הישן. אי אפשר להסיר תפריטים בזמן שהקובץ פתוחה, למרות שאפשר לכתוב את הפונקציה onOpen() כדי לדלג על התפריט את העתיד, אם יוגדר נכס מסוים.

תמונות ושרטוטים ב-Google Sheets שאפשר ללחוץ עליהם

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

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

      function showMessageBox() {
        Browser.msgBox('You clicked it!');
      }
    
  3. חוזרים אל Sheets ומוסיפים תמונה או שרטוט על ידי בחירה באפשרות הוספה > תמונה או הוספה > שרטוט.

  4. לאחר הוספת התמונה או השרטוט, לוחצים עליהם. תפריט נפתח קטן הבורר מופיע בפינה השמאלית העליונה. לוחצים עליו ובוחרים הקצאת סקריפט.

  5. בתיבת הדו-שיח שמופיעה, מקלידים את השם של פונקציית Apps Script שרוצים להריץ, ללא סוגריים – במקרה הזה, showMessageBox. לוחצים על אישור.

  6. לוחצים שוב על התמונה או השרטוט. הפונקציה תופעל עכשיו.