בדרך כלל, כדי לראות את השינויים בתצוגה החזותית של הקהילה, צריך להעלות את הקבצים ל-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.