گردش کار معمول برای مشاهده تغییرات در تجسم جامعه شما این است که فایلهای خود را در GCS بارگذاری کنید ، سپس گزارش Data Studio خود را بهروزرسانی کنید. این روش جواب میدهد، اما به این معنی است که باید زمان زیادی را برای مشاهده تغییرات صرف کنید. dscc-gen به یک گردش کار امکان میدهد تا بلافاصله تغییرات کد تجسم شما را مشاهده کند و زمان لازم برای نوشتن تجسم جامعه را کاهش دهد.
برای شروع، مطمئن شوید که npm 5.2.0 یا بالاتر و gsutil نصب شدهاند. سپس، دستور زیر را اجرا کنید:
npx @google/dscc-gen viz
پیکربندی برای اولین بار
dscc-gen با یک مجموعه داده محلی پیشفرض ارائه میشود که احتمالاً نماینده دادههایی نیست که میخواهید مصورسازی کنید. برای بهروزرسانی این مجموعه داده مطابق با نیازهایتان:
- پیکربندی خود را در
src/index.jsonبهروزرسانی کنید. - دستور
npm run update_messageاجرا کنید. این دستور یک تصویرسازی (visualization) درdevbucket شما ایجاد میکند که پیام را با فرمتی نمایش میدهد که کپی کردن آن آسان است. - یک گزارش جدید ایجاد کنید و به مجموعه دادهای متصل شوید که نماینده دادههایی است که میخواهید تجسم کنید.
- با استفاده از
devbucket خود به عنوان شناسه کامپوننت ، یک تجسم اجتماعی اضافه کنید . - محتویات بصریسازی را در
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 با فعال بودن قابلیت ذخیرهسازی موقت (caching) بسازید. |
npm run push:prod | فایلها را از build به مخزن prod خود کپی کنید. |
دستور update_message به صورت پیشفرض روی objectFormat تنظیم شده است. برای استفاده از tableFormat ، پارامترهای موجود در اسکریپت update_message در package.json را از -f object به -f table تغییر دهید.
کدلب
برای یادگیری نحوه استفاده از این ابزار، codelab مربوط به dscc-gen را بررسی کنید.
