1. مقدمة
في هذا الدرس التطبيقي حول الترميز، يمكنك إنشاء مشروع "برمجة تطبيقات Google" باسم "Hello World". ثم أضف دالة بسيطة، logThis
، تُسجل رسالة تم تمريرها إليها. بعد ذلك، يمكنك إنشاء عملية تشغيل آلي Appsheet وجعلها استدعاء النص البرمجي. بعد طلب النص البرمجي، يمكنك الرجوع إلى محرِّر "برمجة تطبيقات Google" وتأكيد تنفيذه.
المعلومات التي ستطّلع عليها
- كيفية إنشاء مشروع "برمجة تطبيقات Google" بوظيفة بسيطة
- كيفية إنشاء تطبيق AppSheet بسيط استنادًا إلى جدول بيانات Google حالي.
- كيفية إنشاء عملية أتمتة في AppSheet تستدعي دالة النص البرمجي.
- كيفية التحقّق من التنفيذ الناجح للنص البرمجي من AppSheet
المتطلبات
- الوصول إلى بيئة تطوير AppSheet (
appsheet.com
) - الوصول إلى بيئة تطوير "برمجة تطبيقات Google" (
script.google.com
)
2. إنشاء مشروع "برمجة تطبيقات Google"
أولاً، أنشئ مشروعًا لبرمجة التطبيقات باسم "Hello World" (أهلاً بالعالم). ثم أضف دالة بسيطة، logThis
، تُسجل رسالة تم تمريرها إليها.
- انتقِل إلى الصفحة الرئيسية لبرمجة التطبيقات، ثم انقر على + مشروع جديد.
- تغيير عنوان المشروع إلى
Hello World.
- عدِّل النص البرمجي في المحرِّر على النحو التالي:
function logThis(msg) {
Logger.log('Message from AppSheet was: ' + msg);
}
- انقر على حفظ المشروع.
لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء المشاريع وحذفها.
3- إنشاء تطبيق AppSheet
بعد ذلك، يمكنك إنشاء تطبيق AppSheet جديد بسرعة استنادًا إلى مثال منسوخ لـ "جدول بيانات Google"، ثم تحديثه لطلب مشروع "برمجة التطبيقات" الذي أنشأته من قبل.
- افتح جدول البيانات مثال على طلبات القمصان ثم انقر على إنشاء نسخة لتنزيل نسخة وفتحها في "جداول بيانات Google". يمكنك اختياريًا إعادة تسمية جدول البيانات، إن أردت (على سبيل المثال، "طلبات القمصان").
- سجِّل الدخول إلى AppSheet.
- في صفحة "تطبيقاتي"، انقر على + إنشاء تطبيق جديد. سيظهر مربّع الحوار إنشاء تطبيق جديد.
- انقر على البدء باستخدام بياناتك الخاصة.
- يمكنك اختياريًا تعديل اسم التطبيق واختيار فئة له.
- انقر على اختيار البيانات.
- انقر على google للوصول إلى Google Drive.
- انتقِل إلى جدول بيانات طلبات القمصان الذي نسخته سابقًا واختَره.
تعمل خدمة AppSheet على إعداد تطبيقك.
- انقر على تخصيص التطبيق لفتح التطبيق في محرّر AppSheet.
4. إنشاء عملية تشغيل آلي
بعد ذلك، يمكنك إنشاء عملية تشغيل آلي Appsheet وجعلها استدعاء النص البرمجي.
- اختَر التشغيل الآلي > برامج التتبُّع
- انقر على + برنامج تتبُّع جديد.
- اختَر العنصر الأول في قائمة الاقتراحات: عند إنشاء سجل طلبات القميص أو تعديله، أرسِل إشعارًا.
- انقر على خطوة إرسال إشعار لتعديلها.
- يجب تغيير الاسم إلى
Call a script
.
- ضمن الإعدادات، غيِّر نوع المهمة إلى طلب نص برمجي.
- في الحقل مشروع برمجة التطبيقات، انقر على تصفّح (رمز الملف).
- انتقِل إلى مشروع "برمجة تطبيقات Google"
Hello World
في Drive واختَره. - انقر على اختيار، وإذا طُلب منك التفويض، انقر على تفويض واتّبِع التعليمات.
تمت إضافة مشروع "برمجة تطبيقات Google" وتتم تعبئة الحقل اسم الدالة بقائمة من الدوال المتاحة.
- اختَر logThis(msg) من قائمة اسم الدالة.
سيتم عرض حقل وسيطات الدوال.
- بالنسبة إلى الوسيطة msg، أدخِل التعبير التالي باستخدام "مساعد التعبير": "مرحبًا من AppSheet".
- انقر على حفظ لحفظ التطبيق.
- في لوحة المعاينة، انقر على الرمز جهاز جوّال أو جهاز لوحي لعرض محاكي التطبيق.
- أضِف طلب قميص جديد وانقر على حفظ.
- انقر على مزامنة لمزامنة التغييرات.
5- تأكيد تنفيذ "برمجة تطبيقات Google"
بعد طلب النص البرمجي، ارجع إلى محرِّر "برمجة تطبيقات Google" وأكِّد تنفيذه.
- ارجع إلى الصفحة الرئيسية لبرمجة التطبيقات واعرض مشروع Hello World.
- انقر على عمليات التنفيذ في شريط التنقّل للتأكّد من اكتمال دالة
logThis
بنجاح. انقر على إعادة تحميل في حال عدم ظهور السجلّ.
6- خطوات إضافية اختيارية
كخطوة إضافية في ورشة العمل هذه، يمكنك مراجعة مشروع "أمثلة لبرمجة التطبيقات" وتنفيذ بعض الأمثلة من AppSheet.
بدء استخدام أمثلة "برمجة تطبيقات Google"
- للبدء، يجب أولاً إنشاء نسخة من مشروع أمثلة "برمجة التطبيقات".
- انقر على رمز النسخ.
- احفظ المشروع الجديد وانقر على تشغيل لتفويض التطبيقات في المشروع.
تجربة العديد من الأمثلة
createCalendarEvent()
: إنشاء حدث جديد في التقويمcreateDoc()
: إنشاء مستند جديد تلقائيًاcreateSheet()
- إنشاء ورقة بيانات جديدةcreateSlideDeck()
- إنشاء مجموعة شرائح جديدة باستخدام صورة ونص
لمزيد من المعلومات عن هذه الميزة المهمة، يُرجى الاطِّلاع على مقالة برمجة تطبيقات الاتصال من خلال التشغيل الآلي التي تقدِّم نظرة عامة تفصيلية وفيديو مميزًا وبرامج تعليمية ومشروع "برمجة تطبيقات Google" قابل للنسخ يحتوي على العديد من أمثلة العمل لبرمجة تطبيقات AppSheet.