חיבור AppSheet ל-Apps Script

1. מבוא

ב-codelab הזה תיצרו פרויקט Apps Script בשם Hello World, ואז תוסיפו פונקציה פשוטה, logThis, שמתעדת הודעה שהועברה אליה. לאחר מכן יוצרים אוטומציה ב-AppSheet ומגדירים אותה להפעיל את הסקריפט. אחרי שמפעילים את הסקריפט, חוזרים לכלי לעריכת סקריפטים של Apps Script ומאשרים את ההרצה שלו.

מה תלמדו

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

מה תצטרכו

• גישה לסביבת הפיתוח של AppSheet‏ (appsheet.com).
• גישה לסביבת הפיתוח של Apps Script‏ (script.google.com).

2. יצירת פרויקט Apps Script

קודם כול, יוצרים פרויקט Apps Script בשם Hello World, ואז מוסיפים פונקציה פשוטה, logThis, שמתעדת ביומן הודעה שהועברה אליה.

1. עוברים אל דף הבית של Apps Script ולוחצים על + פרויקט חדש.
2. משנים את שם הפרויקט לHello World.
3. מעדכנים את הסקריפט בכלי העריכה באופן הבא:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. לוחצים על שמירת הפרויקט.

מידע נוסף זמין במאמר יצירה ומחיקה של פרויקטים.

3. יצירת אפליקציית AppSheet

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

1. פותחים את הגיליון האלקטרוני Shirt Orders Example (דוגמה להזמנות חולצות) ולוחצים על Make a copy (יצירת עותק) כדי להוריד ולפתוח עותק ב-Google Sheets. אם רוצים, אפשר לשנות את השם של הגיליון האלקטרוני (לדוגמה, 'הזמנות חולצות').
2. נכנסים ל-AppSheet.
3. בדף 'האפליקציות שלי', לוחצים על + יצירת אפליקציה חדשה. מוצגת תיבת הדו-שיח יצירת אפליקציה חדשה.
4. לוחצים על Start with your own data (התחלת העבודה עם הנתונים שלכם).
5. אפשר גם לערוך את שם האפליקציה ולבחור קטגוריה.
6. לוחצים על בחירת הנתונים.

7. לוחצים על Google כדי לגשת ל-Google Drive.
8. עוברים לגיליון האלקטרוני Shirt Orders שהעתקתם קודם ובוחרים בו.

מערכת AppSheet מגדירה את האפליקציה.

9. לוחצים על התאמה אישית של האפליקציה כדי לפתוח את האפליקציה ב-AppSheet Editor.

4. יצירת פעולה אוטומטית

לאחר מכן, יוצרים אוטומציה ב-Appsheet ומגדירים אותה להפעלת הסקריפט.

1. בוחרים באפשרות אוטומציה > בוטים.
2. לוחצים על + בוט חדש.
3. בוחרים את הפריט הראשון ברשימת ההצעות: When a Shirt Orders record is created or updated, send a notification. (כשנוצר או מתעדכן רשומה של הזמנות חולצות, נשלחת התראה).

4. לוחצים על השלב שליחת התראה כדי לערוך אותו.
5. משנים את השם ל-Call a script.

6. בקטע הגדרות, משנים את סוג המשימה להתקשרות לסקריפט.

7. בשדה Apps Script Project (פרויקט Apps Script), לוחצים על Browse (עיון) (סמל הקובץ).
8. מנווטים אל פרויקט Apps Script ב-Drive ובוחרים בו.Hello World
9. לוחצים על בחירה ואם מתבקשים לאשר, לוחצים על אישור ופועלים לפי ההנחיות.

פרויקט Apps Script מתווסף והשדה שם הפונקציה מתמלא ברשימה של פונקציות זמינות.

10. בוחרים באפשרות logThis(msg) מהרשימה שם הפונקציה.

מוצג השדה Function Arguments (ארגומנטים של הפונקציה).

11. בארגומנט msg, מזינים את הביטוי הבא באמצעות הכלי Expression Assistant: ‎‘Hello from AppSheet'

12. לוחצים על שמירה כדי לשמור את האפליקציה.
13. בחלונית התצוגה המקדימה, לוחצים על הסמל נייד או טאבלט כדי להציג את אמולטור האפליקציה.

14. מוסיפים הזמנה חדשה של חולצה ולוחצים על שמירה.
15. לוחצים על סנכרון כדי לסנכרן את השינויים.

5. אישור ההפעלה של Apps Script

אחרי שמפעילים את הסקריפט, חוזרים לכלי לעריכת סקריפטים של Apps Script ומאשרים את ההרצה שלו.

1. חוזרים לדף הבית של Apps Script וצופים בפרויקט Hello World.
2. לוחצים על הפעלות בסרגל הניווט כדי לוודא שהפונקציה logThis הושלמה בהצלחה. אם היומן לא מופיע, לוחצים על רענון.

6. שלבים אופציונליים נוספים

בשלב נוסף בסדנה הזו, כדאי לעיין בפרויקט Apps Script Examples ולהריץ כמה מהדוגמאות מ-AppSheet.

איך מתחילים להשתמש בדוגמאות של Apps Script

1. כדי להתחיל, קודם צריך ליצור עותק של פרויקט הדוגמאות של Apps Script.
2. לוחצים על סמל ההעתקה.
3. שומרים את הפרויקט החדש ולוחצים על Run כדי לתת הרשאה לאפליקציות בפרויקט.

כדאי לנסות כמה מהדוגמאות

• ‫createCalendarEvent() – יצירת אירוע חדש ביומן.
• ‫createDoc() – יצירה אוטומטית של מסמך חדש.
• ‫createSheet() – יצירת גיליון חדש.
• ‫createSlideDeck() – יצירת מצגת חדשה באמצעות תמונה וטקסט.

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