تجسم های خود را سریعتر با dscc-gen بنویسید

گردش کار معمول برای مشاهده تغییرات در تجسم جامعه شما این است که فایل‌های خود را در GCS بارگذاری کنید ، سپس گزارش Data Studio خود را به‌روزرسانی کنید. این روش جواب می‌دهد، اما به این معنی است که باید زمان زیادی را برای مشاهده تغییرات صرف کنید. dscc-gen به یک گردش کار امکان می‌دهد تا بلافاصله تغییرات کد تجسم شما را مشاهده کند و زمان لازم برای نوشتن تجسم جامعه را کاهش دهد.

برای شروع، مطمئن شوید که npm 5.2.0 یا بالاتر و gsutil نصب شده‌اند. سپس، دستور زیر را اجرا کنید:

npx @google/dscc-gen viz

پیکربندی برای اولین بار

dscc-gen با یک مجموعه داده محلی پیش‌فرض ارائه می‌شود که احتمالاً نماینده داده‌هایی نیست که می‌خواهید مصورسازی کنید. برای به‌روزرسانی این مجموعه داده مطابق با نیازهایتان:

  1. پیکربندی خود را در src/index.json به‌روزرسانی کنید.
  2. دستور npm run update_message اجرا کنید. این دستور یک تصویرسازی (visualization) در dev bucket شما ایجاد می‌کند که پیام را با فرمتی نمایش می‌دهد که کپی کردن آن آسان است.
  3. یک گزارش جدید ایجاد کنید و به مجموعه داده‌ای متصل شوید که نماینده داده‌هایی است که می‌خواهید تجسم کنید.
  4. با استفاده از dev bucket خود به عنوان شناسه کامپوننت ، یک تجسم اجتماعی اضافه کنید .
  5. محتویات بصری‌سازی را در 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 را بررسی کنید.

آزمایشگاه کد dscc-gen