רמת קידוד: מתחילים
משך: 15 דקות
סוג הפרויקט: אוטומציה עם תפריט מותאם אישית
מטרות
- להבין מה הפתרון עושה.
- הסבר על הפעולות של שירותי Apps Script בתוך הפתרון.
- מגדירים את הסקריפט.
- מריצים את הסקריפט.
מידע על הפתרון הזה
כדי לחסוך זמן ולצמצם את מספר השגיאות שנובעות מהעתקה והדבקה ידניות, אפשר לייבא תוכן ממספר מסמכים למסמך ראשי אחד באופן אוטומטי. הפתרון הזה מתמקד בצבירה של דוחות סטטוס של פרויקטים, אבל אפשר לערוך אותו בהתאם לצרכים שלכם.
איך זה עובד
הסקריפט יוצר תיקייה לאחסון המסמכים שמהם רוצים לייבא תוכן, ומסמך תבנית שמשמש להתחלת הייבוא. הסקריפט כולל גם פונקציות ליצירת מסמכים לדוגמה כדי להדגים את הפתרון הזה.
כשמשתמש בוחר באפשרות ייבוא סיכומים בתפריט המותאם אישית, הסקריפט מקבל את כל קובצי Docs בתיקייה ומעבד כל אחד מהם. הסקריפט מחפש מחרוזת ספציפית וסוג כותרת ספציפי כדי לזהות את טקסט הסיכום שצריך להעתיק. אחרי שהטקסט מועתק, הסקריפט משנה את צבע הטקסט של מחרוזת המזהה כדי לצמצם את הכפילויות. התסריט מדביק את הסיכומים למסמך הראשי, כל אחד בטבלה נפרדת עם תא אחד.
שירותי Apps Script
הפתרון הזה משתמש בשירותים הבאים:
- שירות ניהול מסמכים – יצירת התבנית ומסמכי המקור לדוגמה. הפונקציה עוברת על כל מסמך המקור ומחפשת סיכומי פרויקטים חדשים לייבוא. ייבוא הסיכומים למסמך הראשי. מעדכן את מסמכי המקור כדי למנוע ייבוא של סיכומים יותר מפעם אחת.
- שירות Drive – יצירת תיקייה לאחסון מסמכי המקור. הוספת מסמך התבנית ומסמכי המקור לדוגמה לתיקייה.
- שירות כלי עזר – הפורמט של התאריך שהסקריפט מוסיף למסמך הראשי בכל פעם שהסקריפט מייבא סיכומים מהמסמכים המקוריים.
- Base service – השירות משתמש בכיתה
Session
כדי לקבל את אזור הזמן של הסקריפט. הסקריפט משתמש באזור הזמן כשמוסיף את תאריך הייבוא למסמך הראשי.
דרישות מוקדמות
כדי להשתמש בדוגמה הזו, צריך לעמוד בדרישות המוקדמות הבאות:
- חשבון Google (יכול להיות שחשבונות Google Workspace ידרשו אישור אדמין).
- דפדפן אינטרנט עם גישה לאינטרנט.
הגדרת הסקריפט
לוחצים על הלחצן שלמטה כדי ליצור עותק של המסמך תוכן מצטבר.
יצירת עותק
מריצים את הסקריפט
הפעלת הדגמה עם מסמכים לדוגמה
- לוחצים על ייבוא סיכומים > הגדרה > הרצת ההגדרה של הדגמה עם מסמכים לדוגמה. יכול להיות שתצטרכו לרענן את הדף כדי שהתפריט המותאם אישית יופיע.
כשמוצגת בקשה, מאשרים את הסקריפט. אם במסך ההסכמה ל-OAuth מוצגת האזהרה This app isn't verified, ממשיכים על ידי בחירה באפשרות Advanced > Go to {Project Name} (unsafe).
לוחצים שוב על ייבוא סיכומים > הגדרה > הרצת ההגדרה של הדגמה עם מסמכים לדוגמה.
כשמוצגת בקשה, מעתיקים את כתובת ה-URL של התיקייה ב-Drive לשימוש בשלב מאוחר יותר.
לוחצים על אישור.
לוחצים על ייבוא סיכומים > ייבוא סיכומים.
כשמופיעה בקשה, לוחצים על OK.
בודקים את סיכומי הפרויקטים שיובאו מהמסמכים לדוגמה.
הוספה וייבוא של סיכום
- בכרטיסייה חדשה בדפדפן, מדביקים את כתובת ה-URL של התיקייה כדי לפתוח את התיקייה סטטוס הפרויקט.
- פותחים את הקובץ Project ABC.
- כדי ליצור סיכום חדש לייבוא, מוסיפים את התוכן הבא לסוף המסמך:
- מקלידים
Summary
ומגדירים את סגנון הטקסט בתור Heading 3. - ישירות מתחת ל-
Summary
, מוסיפים טבלה בגודל 1x1. מוודאים שאין שורות ריקות ביןSummary
לבין הטבלה. - בטבלה, מקלידים
Hello world!
.
- מקלידים
- חוזרים למסמך הראשי ולוחצים על ייבוא סיכומים > ייבוא סיכומים.
- כשמופיעה בקשה, לוחצים על OK.
- הייבוא האחרון מופיע בסוף המסמך.
בדיקת הקוד
כדי לבדוק את הקוד של Apps Script לפתרון הזה, לוחצים על הצגת קוד המקור בהמשך:
הצגת קוד המקור
Code.gs
Menu.gs
Setup.gs
Utilities.gs
תורמים
Google שומרת על הדוגמה הזו בעזרת מומחי הפיתוח של Google.