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

1. مقدمة

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

المعلومات التي ستطّلع عليها

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

المتطلبات

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

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

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

  1. انتقِل إلى الصفحة الرئيسية لبرمجة التطبيقات، ثم انقر على + مشروع جديد.
  2. تغيير عنوان المشروع إلى Hello World. إعادة تسمية مربّع حوار المشروع بالاسم الجديد
  3. عدِّل النص البرمجي في المحرِّر على النحو التالي:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. انقر على حفظ المشروع.

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

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

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

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

اختيار "اختيار البيانات" في مربّع الحوار الجديد الخاص بإنشاء تطبيق

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

تعمل خدمة AppSheet على إعداد تطبيقك. نافذة المعاينة الأولية للتطبيق الذي تم إنشاؤه.

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

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

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

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

5037cdd726e326e9.png

  1. انقر على خطوة إرسال إشعار لتعديلها.
  2. يجب تغيير الاسم إلى Call a script.

خطوات التشغيل الآلي لاستدعاء نص برمجي.

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

تحديد خيار "استدعاء نص برمجي" نوع المهمة في إعدادات "التشغيل الآلي".

  1. في الحقل مشروع برمجة التطبيقات، انقر على تصفّح (رمز الملف).
  2. انتقِل إلى مشروع "برمجة تطبيقات Google" Hello World في Drive واختَره.
  3. انقر على اختيار، وإذا طُلب منك التفويض، انقر على تفويض واتّبِع التعليمات.

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

  1. اختَر logThis(msg) من قائمة اسم الدالة. تحديد دالة برمجة التطبيقات 'logThis()' في القائمة المنسدلة.

سيتم عرض حقل وسيطات الدوال.

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

إضافة وسيطات إلى استدعاء دالة "برمجة تطبيقات Google"

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

68471f4646fc8fbe.png

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

النقر على رمز المزامنة في أعلى يسار لوحة المعاينة للمزامنة مع مصدر البيانات

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

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

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

يتم عرض سجلات التنفيذ في بيئة محرِّر "برمجة تطبيقات Google" للتحقّق من تنفيذ الوظيفة من استدعاء AppSheet.

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

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

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

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

تجربة العديد من الأمثلة

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

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