ربط AppSheet باستخدام "برمجة تطبيقات Google"

1. مقدمة

في هذا الدرس التطبيقي حول الترميز، ستنشئ مشروعًا في "برمجة تطبيقات Google" باسم "Hello World"، ثم ستضيف دالة بسيطة، logThis، تسجّل رسالة تم تمريرها إليها. بعد ذلك، يمكنك إنشاء عملية تلقائية في AppSheet وجعلها تستدعي النص البرمجي. بعد استدعاء النص البرمجي، ستعود إلى أداة تعديل النصوص البرمجية وتؤكّد تنفيذه.

ما ستتعلمه

• كيفية إنشاء مشروع "برمجة تطبيقات Google" باستخدام دالة بسيطة
• كيفية إنشاء تطبيق بسيط على AppSheet استنادًا إلى جدول بيانات Google حالي
• كيفية إنشاء عملية AppSheet Automation تستدعي دالة النص البرمجي
• كيفية التحقّق من تنفيذ النص البرمجي بنجاح من AppSheet

المتطلبات

• الوصول إلى بيئة تطوير AppSheet (appsheet.com)
• الوصول إلى بيئة تطوير "برمجة تطبيقات Google" (script.google.com)

2. إنشاء مشروع في "برمجة تطبيقات Google"

أولاً، أنشئ مشروعًا في "برمجة تطبيقات Google" باسم "Hello World"، ثم أضِف دالة بسيطة، logThis، تسجّل رسالة تم تمريرها إليها.

1. انتقِل إلى الصفحة الرئيسية لبرمجة تطبيقات، ثم انقر على + مشروع جديد.
2. غيِّر عنوان المشروع إلى Hello World.
3. عدِّل النص البرمجي في المحرّر على النحو التالي:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. انقر على حفظ المشروع.

لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المشاريع وحذفها.

3- إنشاء تطبيق AppSheet

بعد ذلك، يمكنك إنشاء تطبيق AppSheet جديد بسرعة استنادًا إلى مثال منسوخ من "جدول بيانات Google"، ثم تعديله لاستدعاء مشروع برمجة تطبيقات Google الذي أنشأته من قبل.

1. افتح جدول بيانات مثال على طلبات القمصان، ثم انقر على إنشاء نسخة لتنزيل نسخة وفتحها في "جداول بيانات Google". يمكنك اختياريًا إعادة تسمية جدول البيانات إذا أردت ذلك (مثلاً، "طلبات القمصان").
2. سجِّل الدخول إلى AppSheet.
3. في صفحة "تطبيقاتي"، انقر على + إنشاء تطبيق جديد. سيظهر مربّع الحوار إنشاء تطبيق جديد.
4. انقر على البدء ببياناتك الخاصة.
5. يمكنك اختياريًا تعديل اسم التطبيق واختيار فئة.
6. انقر على اختيار بياناتك.

7. انقر على google للوصول إلى Google Drive.
8. انتقِل إلى جدول بيانات طلبات القمصان الذي نسخته سابقًا واختَره.

تتولّى AppSheet إعداد تطبيقك.

9. انقر على تخصيص تطبيقك لفتح التطبيق في "محرّر AppSheet".

4. إنشاء عملية تشغيل آلي

بعد ذلك، يمكنك إنشاء عملية تشغيل آلي في AppSheet وجعلها تستدعي النص البرمجي.

1. اختَر التشغيل الآلي > برامج التتبّع.
2. انقر على + برنامج تتبُّع جديد.
3. اختَر العنصر الأول في قائمة الاقتراحات: عند إنشاء سجلّ "طلبات القمصان" أو تعديله، أرسِل إشعارًا.

4. انقر على خطوة إرسال إشعار لتعديلها.
5. غيِّر الاسم إلى Call a script.

6. ضمن الإعدادات، غيِّر نوع المهمة إلى تنفيذ نص برمجي.

7. في حقل مشروع برمجة تطبيقات، انقر على استعراض (رمز الملف).
8. انتقِل إلى مشروع Hello World Apps Script في Drive واختَره.
9. انقر على اختيار، وإذا طُلب منك منح الإذن، انقر على تفويض واتّبِع التعليمات التي تظهر على الشاشة.

تتم إضافة مشروع "برمجة تطبيقات Google" ويتم ملء الحقل اسم الدالة بقائمة من الدوال المتاحة.

10. اختَر logThis(msg) من قائمة اسم الدالة.

يظهر الحقل وسيطات الدالة.

11. بالنسبة إلى الوسيطة msg، أدخِل التعبير التالي باستخدام "مساعد التعبير": Hello from AppSheet

12. انقر على حفظ لحفظ التطبيق.
13. في "لوحة المعاينة"، انقر على رمز الجهاز الجوّال أو الجهاز اللوحي لعرض محاكي التطبيق.

14. أضِف طلبًا جديدًا للقمصان وانقر على حفظ.
15. انقر على مزامنة لمزامنة التغييرات.

5- تأكيد تنفيذ نص برمجي في "برمجة تطبيقات Google"

بعد استدعاء النص البرمجي، ارجع إلى أداة تعديل النصوص البرمجية في برمجة تطبيقات وأكِّد تنفيذه.

1. ارجع إلى الصفحة الرئيسية في برمجة تطبيقات واطّلِع على مشروع Hello World.
2. انقر على عمليات التنفيذ في شريط التنقّل للتأكّد من اكتمال وظيفة logThis بنجاح. انقر على إعادة التحميل إذا لم يظهر السجلّ.

6. خطوات إضافية اختيارية

كخطوة إضافية في ورشة العمل هذه، راجِع مشروع "أمثلة على برمجة تطبيقات Google" ونفِّذ بعض الأمثلة من AppSheet.

بدء استخدام "أمثلة على برمجة التطبيقات"

1. للبدء، عليك أولاً إنشاء نسخة من مشروع أمثلة برمجة تطبيقات.
2. انقر على رمز النسخ.
3. احفظ المشروع الجديد وانقر على تشغيل لمنح الإذن للتطبيقات في المشروع.

تجربة عدة أمثلة

• createCalendarEvent(): إنشاء حدث جديد في "تقويم Google"
• createDoc(): إنشاء مستند جديد تلقائيًا
• ‫createSheet(): لإنشاء ورقة جديدة
• createSlideDeck(): لإنشاء عرض تقديمي جديد باستخدام صورة ونص

لمزيد من المعلومات حول هذه الميزة المهمة، يُرجى الاطّلاع على المقالة استدعاء "برمجة تطبيقات Google" من عملية التشغيل الآلي التي تقدّم نظرة عامة مفصّلة وفيديو عن الميزة وبرامج تعليمية ومشروع "برمجة تطبيقات Google" يمكن نسخه ويتضمّن العديد من الأمثلة العملية على استخدام AppSheet و"برمجة تطبيقات Google".