في حين أنه يمكنك إنجاز جميع المهام المتعلقة بالموصِّل باستخدام بيئة برمجة التطبيقات على الإنترنت، يمكن أن يصبح بعضها مكرّرًا وعرضة للأخطاء بمرور الوقت.
dscc-gen هي أداة تتضمّن رأيًا تهدف إلى معالجة هذه المهام المتكرّرة كي تتمكّن من التركيز على حلّ مشاكل نشاطك التجاري بدلاً من الأخطاء التي يمكن تجنُّبها من خلال الأساليب المبرمَجة.
المتطلّبات
- npm 5.2.0 أو إصدار أحدث
- بعض الإلمام بسطر الأوامر.
جارٍ استخدام dscc-gen
يمكن لـ dscc-gen إنشاء مشاريع جديدة للتواصل مع المنتدى أو استخدامها مع المشاريع الحالية.
الموصِّلات الحالية
يمكن أيضًا استخدام "dscc-gen" مع المشاريع الحالية. أولاً،
انسخ scriptId، ثم شغِّل الأمر التالي (مع استبدال
YOUR_SCRIPT_ID بـ scriptId):
npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID
سيُطلب منك تقديم بعض التفاصيل حول الموصِّل. إذا لم يكن لديك بالفعل عملية نشر تسمى "الإنتاج"، فسيتم إنشاء عملية لك. لن يتم تعديل أي من التعليمات البرمجية الحالية، ولكن سيكون بإمكانك الوصول إلى كل ما يمكن لـ dscc-gen فعله.
أدوات الربط الجديدة
لإنشاء موصل منتدى جديد باستخدام dscc-gen، قم بتشغيل الأمر التالي:
npx @google/dscc-gen connector
سيُطلب منك تقديم بعض التفاصيل حول الموصِّل الجديد. وسيُطلب من المستخدمين للمرة الأولى
مصادقة clasp. clasp هي أداة لإنشاء مشاريع
برمجة التطبيقات وتعديلها من سطر الأوامر.
بعد إكمال الطلبات، سينشئ dscc-gen مشروعًا جديدًا لبرمجة التطبيقات
ويطبع كل المهام التي يمكنه تنفيذها.
كيف يتحكّم تطبيق "dscc-gen" في جهازك؟
| Command | الوصف |
|---|---|
npm run open |
افتح مشروعك في "برمجة التطبيقات". |
npm run push |
تطبيق التغييرات المحلية على "برمجة التطبيقات" |
npm run watch
|
انتبه للتغييرات المحلية، وادفعها إلى لغة برمجة التطبيقات. |
npm run prettier |
تنسيق الرمز باستخدام معايير المنتدى. |
npm run try_latest
|
افتح عملية النشر باستخدام أحدث رمز في Looker Studio. |
npm run try_production
|
افتح عملية نشر الإنتاج في Looker Studio. |
npm run update_production
|
يُرجى تحديث عملية نشر الإنتاج لاستخدام أحدث رمز |
كيف يمكنني استخدامها؟
غالبًا ما يكون استخدام dscc-gen على النحو التالي:
- حدد الميزة التي تريد إضافتها إلى الموصِّل.
- نفِّذ
npm run watch، لكي يتم تطبيق التغييرات المحلية على "برمجة التطبيقات". - أجرِ التغييرات على الرمز باستخدام محرِّر JavaScript المفضل.
- شغِّل
npm run tryLatestوتحقَّق من أنّ الميزة الجديدة تعمل على النحو المتوقّع. - يمكنك تشغيل
npm run updateProductionلتحديث عملية نشر الإنتاج للحصول على الميزة الجديدة. - يُرجى تشغيل
npm run tryProductionوالتأكّد من عمل الميزة الجديدة.
الحصول على رقم تعريف النص البرمجي
للحصول على scriptId، انتقِل إلى مشروعك الحالي، ثم انسخ قسم
عنوان URL بعد /d/ وقبل /edit. على سبيل المثال: عنوان URL التالي:
- عنوان URL الأصلي:
https://script.google.com/a/google.com/d/example-script-id/edit - رقم تعريف النص البرمجي:
example-script-id