פיתוח מקומי

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

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

דרישות

שימוש ב-dscc-gen

אפשר ליצור פרויקטים חדשים של מחבר קהילתי ב-dscc-gen או להשתמש בפרויקטים קיימים.

מחברים קיימים

אפשר להשתמש בפרויקט dscc-gen גם בפרויקטים קיימים. קודם כול, מעתיקים את scriptId ואז מריצים את הפקודה הבאה (מחליף את YOUR_SCRIPT_ID ב-scriptId):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

תתבקש לספק מספר פרטים עבור המחבר שלך. אם עדיין לא עשיתם זאת, המערכת תיצור עבורכם פריסה בשם 'ייצור'. הקוד הקיים שלכם לא ישתנה, אבל תוכלו לגשת לכל מה ש-dscc-gen יכול לעשות.

מחברים חדשים

כדי ליצור מחבר קהילה חדש באמצעות dscc-gen, מריצים את הפקודה הבאה:

npx @google/dscc-gen connector

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

אחרי ביצוע ההנחיות, מערכת dscc-gen תיצור פרויקט חדש ב-Apps Script ותדפיס את כל מה שאפשר לעשות.

מה אפליקציית dscc-gen יכולה לעשות

פקודה התיאור
npm run open פותחים את הפרויקט ב-Apps Script.
npm run push דחיפת השינויים המקומיים ב-Apps Script.
npm run watch שימו לב לשינויים מקומיים ודחו אותם ל-Apps Script.
npm run prettier מעצבים את הקוד לפי תקנים קהילתיים.
npm run try_latest פותחים את הפריסה עם הקוד העדכני ביותר ב-Looker Studio.
npm run try_production פותחים את הפריסה בסביבת ייצור ב-Looker Studio.
npm run update_production כדי להשתמש בקוד העדכני ביותר, צריך לעדכן את הפריסה בסביבת הייצור.

איך משתמשים בו?

השימוש ב-dscc-gen בדרך כלל נראה כך:

  1. זהה תכונה שברצונך להוסיף למחבר שלך.
  2. מריצים את npm run watch כדי שהשינויים המקומיים יועברו ל-Apps Script.
  3. מבצעים את השינויים בקוד באמצעות JavaScript JavaScript המועדף.
  4. מריצים את הפקודה npm run tryLatest ובודקים שהתכונה החדשה פועלת כצפוי.
  5. מריצים את npm run updateProduction כדי לעדכן את פריסת הייצור כך שתכלול את התכונה החדשה.
  6. מריצים את הפקודה npm run tryProduction ומוודאים שהתכונה החדשה פועלת.

קבלת מזהה הסקריפט

כדי למצוא את scriptId, צריך לעבור לפרויקט הקיים ולהעתיק את הקטע של כתובת ה-URL אחרי /d/ ולפני /edit. לדוגמה: כתובת ה-URL הבאה:

  • כתובת ה-URL המקורית: https://script.google.com/a/google.com/d/example-script-id/edit
  • מזהה סקריפט: example-script-id