مستوى الترميز: متوسط
المدة: 15 دقيقة
نوع المشروع: تشغيل آلي باستخدام عامل تشغيل مستند إلى الوقت
الأهداف
- فهم ما يفعله الحلّ.
- فهم ما تفعله خدمات برمجة التطبيقات ضمن الحلّ.
- قم بإعداد النص البرمجي.
- شغِّل النص البرمجي.
لمحة عن هذا الحلّ
يمكنك استيراد البيانات من ملفات CSV تلقائيًا إلى جدول بيانات واحد من "جداول بيانات Google". إذا كنت تعمل مع عدة ملفات CSV ذات بنية متشابهة، فيمكنك استخدام هذا الحل لتمركز البيانات في جداول البيانات.
آلية العمل
يتم تشغيل النص البرمجي يوميًا على عامل تشغيل يستند إلى الوقت. يتكرر من خلال ملفات CSV في مجلد مخصص ويضيف البيانات من كل ملف إلى جدول بيانات. يزيل البرنامج النصي تلقائيًا صف العنوان لكل مجموعة بيانات CSV قبل إضافة البيانات إلى الصف الأخير من الورقة. يرسل النص البرمجي رسالة إلكترونية موجزة تسرد الملفات التي تم استيرادها وينقلها إلى مجلد مختلف لمنع المعالجة المتكررة.
يتضمن النص البرمجي أيضًا دوال تقوم بإعداد نماذج ملفات CSV لتوضيح هذا الحل.
خدمات "برمجة تطبيقات Google"
يستخدم هذا الحلّ الخدمات التالية:
- خدمة النص البرمجي: تُنشئ المشغل المستند إلى الوقت.
- خدمة Drive - تحصل على المجلدات التي يستخدمها النص البرمجي لتخزين ملفات CSV التي تمت معالجتها وغير المعالجة، ويتم إنشاؤها في حال عدم توفّرها. الحصول على عنوان URL لمشروع برمجة التطبيقات لتضمينه في رسالة البريد الإلكتروني الملخصة.
- خدمة جدول البيانات - تحصل على جدول البيانات حيث يضيف النص البرمجي البيانات من كل ملف CSV.
- الخدمة الأساسية - تستخدم الفئة
Session
للحصول على عنوان البريد الإلكتروني للمستخدم والمنطقة الزمنية للنص البرمجي.- يستند المستخدم إلى مَن يشغّل النص البرمجي. نظرًا لأن النص البرمجي يعمل على مشغل قائم على الوقت، يتم تعريف المستخدم على أنه الشخص الذي أنشأ المشغل.
- يستخدم النص البرمجي المنطقة الزمنية لإضافة التاريخ والوقت اللذين تم تشغيل النص البرمجي فيهما إلى الرسالة الإلكترونية للملخص.
- خدمات الأدوات المساعدة - تحلّل كل ملف CSV في مصفوفة. لتنسيق التاريخ الذي يضيفه النص البرمجي إلى الرسالة الإلكترونية للملخص.
- خدمة البريد - تُرسِل رسالة إلكترونية موجزة بعد استيراد البيانات من ملفات CSV إلى جدول البيانات.
المتطلبات الأساسية
لاستخدام هذا النموذج، يجب استيفاء المتطلبات الأساسية التالية:
- حساب على Google (قد تتطلب حسابات Google Workspace موافقة المشرف).
- متصفح ويب يمكنه الوصول إلى الإنترنت.
إعداد النص البرمجي
- انقر على الزر التالي لفتح مشروع استيراد بيانات ملف CSV.
فتح المشروع - انقر على رمز نظرة عامة .
- في صفحة النظرة العامة، انقر على رمز إنشاء نسخة .
تشغيل النص البرمجي
- في مشروع "برمجة التطبيقات" المنسوخ، انتقِل إلى ملف SetupSample.gs.
- في القائمة المنسدلة للدالة، اختَر setupSample وانقر على setupSample. تنشئ هذه الدالة المشغل القائم على الوقت وملفات CSV وجدول البيانات والمجلد الذي يستخدمه النص البرمجي للتشغيل بنجاح.
امنح الإذن للنص البرمجي عندما يُطلب منك ذلك. إذا كانت شاشة طلب موافقة OAuth تعرض التحذير، لم يتم التحقّق من هذا التطبيق، يمكنك المتابعة من خلال اختيار إعدادات متقدّمة > الانتقال إلى {Project Name} (اسم المشروع) (غير آمن).
للاطّلاع على العامل المشغِّل المستند إلى الوقت بعد اكتمال الإعداد، انقر على رمز العوامل المشغِّلة
.لعرض الملفات التي تم إنشاؤها، افتح مجلد [عيّنة لبرمجة التطبيقات] استيراد ملفات CSV في Google Drive.
ارجِع إلى مشروع "برمجة تطبيقات Google" وفي المحرِّر، انتقِل إلى ملف Code.gs.
في القائمة المنسدلة للدالة، اختَر updateApplicationSheet وانقر على Run (تشغيل).
لعرض الرسالة الإلكترونية الملخصة التي تحتوي على رابط إلى جدول البيانات الذي يحتوي على البيانات التي تم استيرادها، تحقق من صندوق بريدك الإلكتروني.
(اختياري) إعادة ضبط الحلّ
يمكنك إعادة ضبط الحلّ لتعديله ببياناتك الخاصة أو إعادة محاولة العرض التوضيحي.
- في مشروع "برمجة تطبيقات Google"، انتقِل إلى ملف SetupSample.gs.
- في القائمة المنسدلة للدالة، اختَر removeSample وانقر على removeSample. تحذف هذه الدالة المشغل والملفات والمجلد الذي تم إنشاؤه في القسم السابق.
مراجعة الرمز
لمراجعة رمز برمجة التطبيقات لهذا الحلّ، انقر على عرض رمز المصدر أدناه:
عرض رمز المصدر
Code.gs
SampleData.gs
SetupSample.gs
Utilities.gs
المساهمون
تحتفظ Google بهذا النموذج بمساعدة خبراء التطوير في Google.