בדרך כלל, כדי לראות את השינויים בתצוגה החזותית של הקהילה, צריך להעלות את הקבצים ל-GCS, ולאחר מכן לרענן את הדוח של Looker Studio. זה עובד, אבל זה אומר שאתם יכולים להמתין זמן רב עד שרואים שינויים. הקוד dscc-gen מאפשר לכם לראות באופן מיידי את השינויים בקוד של התצוגה החזותית, וכך מקצר את הזמן שנדרש לכתיבה של נתוני הקהילה.
כדי להתחיל, יש לוודא ש-npm 5.2.0 ואילך ו-gsutil מותקנים. לאחר מכן, מריצים את:
npx @google/dscc-gen viz
הגדרה בפעם הראשונה
dscc-gen כולל מערך נתונים מקומי שמוגדר כברירת מחדל, שכנראה לא מייצג את הנתונים שרוצים להמחיש. כדי לעדכן את מערך הנתונים הזה לפי הצרכים שלך:
- לעדכן את ההגדרות ב-
src/index.json. - מריצים את
npm run update_message. הפעולה הזו פורסת המחשה חזותית בקטגוריהdev, שמציגה את ההודעה בפורמט שקל להעתיק. - יוצרים דוח חדש ומתחברים למערך נתונים שמייצג את הנתונים שרוצים להמחיש.
- מוסיפים תצוגה חזותית של הקהילה תוך שימוש בקטגוריה
devכמזהה הרכיב. - מעתיקים את תוכן התצוגה החזותית אל
scripts/data/localData.js. ייעשה שימוש בנתונים האלה במהלך הפיתוח המקומי.
סקריפטים
הסקריפטים הבאים זמינים לפרויקטים להמחשה שנוצרו באמצעות dscc-gen.
| פקודה | פעולה |
|---|---|
npm run start
|
הפעילו את השרת המקומי ועיינו בתצוגה מקדימה של התצוגה החזותית |
npm run update_message |
מעדכנים את ההודעה באמצעות הפרמטר objectFormat |
npm run build:dev
|
כדי לבנות קבצים מ-./src אל ./build, השמירה במטמון מושבתת. |
npm run push:dev |
מעתיקים את הקבצים מ-build לקטגוריה dev. |
npm run build:prod
|
אפשר לבנות קבצים מ-./src לתוך ./build
כשמופעלת שמירה במטמון. |
npm run push:prod
|
מעתיקים את הקבצים מ-build לקטגוריה
prod. |
ברירת המחדל של הפקודה update_message היא objectFormat. כדי להשתמש ב-tableFormat, עליך לערוך את הפרמטרים בסקריפט update_message ב-package.json מ--f object עד -f table.
Codelab
כדי ללמוד איך להשתמש בכלי, אפשר לעיין ב-codelab של dscc-gen.
