مستوى الترميز: مبتدئ
المدة: 15 دقيقة
نوع المشروع: التشغيل الآلي باستخدام قائمة مخصّصة
الأهداف
- فهم دور الحلّ
- فهم ما تفعله خدمات Apps Script ضمن الحلّ
- إعداد النص البرمجي
- شغِّل النص البرمجي.
لمحة عن هذا الحل
لتوفير الوقت وتقليل الأخطاء الناتجة عن النسخ واللصق يدويًا، يمكنك استيراد المحتوى تلقائيًا من عدة مستندات إلى مستند رئيسي واحد. يركز هذا الحلّ على تجميع تقارير حالة المشاريع، ولكن يمكنك تعديله لتناسب احتياجاتك.
آلية العمل
ينشئ النص البرمجي مجلدًا لتخزين المستندات التي تريد استيراد المحتوى منها ومستند نموذج لبدء الاستيراد منه. يتضمّن النص البرمجي أيضًا دوالّ تنشئ نماذج مستندات لعرض هذا الحلّ بشكل تجريبي.
عندما يختار المستخدم استيراد الملخصات من القائمة المخصّصة، يحصل النص البرمجي على جميع ملفات "مستندات Google" في المجلد وينتقل من ملف إلى آخر. يبحث النص البرمجي عن سلسلة ونوع عنوان معيّنين لتحديد نص الملخّص الذي يحتاج إلى نسخه. بعد نسخ النص، يغيّر النص البرمجي لون النص في سلسلت المعرّف للحدّ من تكرار النص. يلصق النص البرمجي الملخصات في المستند الرئيسي، وكل ملخص في جدول خلية واحدة.
خدمات "برمجة تطبيقات Google"
يستخدم هذا الحلّ الخدمات التالية:
- خدمة المستندات: لإنشاء النموذج و عيّنات المستندات المصدر ينتقل إلى كل مستند مصدر بحثًا عن ملخّصات مشاريع جديدة لاستيرادها. استيراد الملخّصات إلى المستند الرئيسي تعديل المستندات المصدر لمنع استيراد الملخصات أكثر من مرّة
- خدمة Drive: لإنشاء مجلد لتخزين المستندات المصدر تُضيف مستند النموذج وعينات المستندات المصدر إلى المجلد.
- خدمة المرافق: تُعدّل تنسيق التاريخ الذي يُضيفه النص البرمجي إلى المستند الرئيسي في كل مرة يستورد فيها النص البرمجي الملخصات من المستندات المصدر.
- الخدمة الأساسية: تستخدِم فئة
Session
للحصول على المنطقة الزمنية للنص البرمجي. يستخدم النص البرمجي المنطقة الزمنية عند إضافة تاريخ الاستيراد إلى المستند الرئيسي.
المتطلبات الأساسية
لاستخدام هذا العيّنة، يجب استيفاء المتطلبات الأساسية التالية:
- حساب Google (قد تحتاج حسابات Google Workspace إلى موافقة المشرف).
- متصفح ويب يمكنه الوصول إلى الإنترنت
إعداد النص البرمجي
انقر على الزر أدناه لإنشاء نسخة من مستند تجميع المحتوى.
إنشاء نسخة
تشغيل النص البرمجي
إجراء عرض توضيحي باستخدام نماذج مستندات
- انقر على استيراد الملخصات > ضبط > بدء الإعداد التجريبي باستخدام نماذج المستندات. قد تحتاج إلى إعادة تحميل الصفحة لكي تظهر هذه القائمة المخصّصة.
امنح الإذن للنصّ البرمجي عند مطالبتك بذلك. إذا ظهرت الرسالة التحذيرية لم يتم التحقّق من هذا التطبيق على شاشة موافقة OAuth، يمكن المتابعة من خلال النقر على الإعدادات المتقدّمة > الانتقال إلى {Project Name} (غير آمن).
انقر على استيراد الملخصات > ضبط > بدء الإعداد التجريبي باستخدام نماذج المستندات مرة أخرى.
عند ظهور طلب، انسخ عنوان URL لمجلد Drive لاستخدامه في خطوة لاحقة.
انقر على موافق.
انقر على استيراد الملخصات > استيراد الملخّصات.
انقر على حسنًا عندما يُطلب منك ذلك.
راجِع ملخّصات المشاريع التي تم استيرادها من نماذج المستندات.
إضافة ملخّص واستيراده
- في علامة تبويب جديدة في المتصفّح، الصِق عنوان URL للمجلد لفتح مجلد حالة المشروع.
- افتح ملف Project ABC.
- أنشئ ملخّصًا جديدًا لاستيراده من خلال إضافة المحتوى التالي إلى نهاية
المستند:
- اكتب
Summary
واضبط نمط النص على العنوان 3. - أسفل
Summary
مباشرةً، أدخِل جدولاً بالتنسيق 1×1. تأكَّد من عدم وجود أسطر فارغة بينSummary
والجدول. - في الجدول، اكتب
Hello world!
.
- اكتب
- انتقِل مرة أخرى إلى المستند الرئيسي وانقر على استيراد الملخصات > استيراد الملخصات.
- انقر على حسنًا عندما يُطلب منك ذلك.
- يمكنك الاطّلاع على آخر عملية استيراد في نهاية المستند.
مراجعة الرمز
لمراجعة رمز Apps Script لهذا الحل، انقر على عرض رمز المصدر أدناه:
عرض رمز المصدر
Code.gs
Menu.gs
Setup.gs
Utilities.gs
المساهمون
تُعدّ Google هذه العينة بمساعدة خبراء Google Developers.