إنّ سير العمل المعتاد للاطّلاع على التغييرات في التمثيل البصري للمنتدى هو تحميل ملفاتك إلى 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.
| Command | الإجراء |
|---|---|
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.
درس تطبيقي حول الترميز
للتعرّف على كيفية استخدام الأداة، يمكنك الاطّلاع على الدرس التطبيقي حول الترميز لـ dscc-gen.
