1. قبل البدء
قاعدة بيانات AppSheet (ASDB) هي قاعدة بيانات أصلية تابعة للطرف الأول في AppSheet لتنظيم وإدارة البيانات التي تشغّل تطبيقات AppSheet. توفّر واجهته وأداؤه المحسّن تجربة أفضل لكل من منشئ التطبيق والمستخدم النهائي مقارنةً بمصادر البيانات الخارجية الأخرى الشائعة الاستخدام، مثل "جداول بيانات Google" وBigQuery وCloud SQL. تتوفّر قاعدة بيانات AppSheet كخيار تلقائي للبيانات في أي تطبيق من تطبيقات AppSheet.
ما ستتعلمه
- كيفية إنشاء قاعدة بيانات AppSheet جديدة باستخدام بيانات نموذجية أو بيانات مستورَدة من "جدول بيانات Google"
- كيفية تخصيص البيانات في "محرّر قاعدة بيانات AppSheet"
- كيفية إنشاء تطبيق AppSheet من قاعدة بيانات AppSheet
- كيفية تعديل قاعدة البيانات وإعادة إنشاء الجداول في AppSheet لتضمين تغييرات في بنية الجدول
ما ستنشئه
يرشدك هذا الدرس التطبيقي حول الترميز إلى كيفية إنشاء قاعدة بيانات جديدة في AppSheet وتخصيصها، أولاً من البداية باستخدام البيانات التلقائية التي توفّرها قاعدة بيانات AppSheet، ثم من البيانات الحالية في جدول بيانات Google. بعد ذلك، يوضّح كيفية إنشاء تطبيق AppSheet جديد من قاعدة بيانات AppSheet. وأخيرًا، يوضّح كيفية تعديل جدول قاعدة بيانات في أداة تعديل قاعدة البيانات ثم إعادة إنشاء الجدول في أداة تعديل تطبيقات AppSheet.
المتطلبات
- الوصول إلى بيئة تطوير AppSheet ( appsheet.com)
2. إنشاء قاعدة بيانات جديدة في AppSheet وتخصيصها من البداية
للبدء، يمكنك إنشاء قاعدة بيانات جديدة في AppSheet وتخصيصها من البداية باستخدام قاعدة البيانات التلقائية المخصّصة للمبتدئين. يمنحك ذلك فرصة تجربة أداة تعديل قاعدة البيانات بدون إيقاف أي من الخطوات اللاحقة في الدرس التطبيقي حول الترميز.
- انتقِل إلى الصفحة الرئيسية في AppSheet ( appsheet.com)، ثم انقر على إنشاء > قاعدة بيانات > قاعدة بيانات جديدة.

- يتم إنشاء قاعدة بيانات نموذجية جديدة ويظهر محرر قاعدة بيانات AppSheet.

- خصِّص قاعدة البيانات عن طريق تغيير اسمها من قاعدة بيانات بدون عنوان إلى قاعدة بيانات المهام. (انقر مرّتين على العنوان التلقائي، قاعدة بيانات بلا عنوان، لتعديل اسم قاعدة البيانات).
- غيِّر اسم الجدول الجدول 1 إلى المهام. (انقر مرّتين على علامة التبويب لتعديلها).
- غيِّر العمود الأول من العنوان إلى المهمة.
- أضِف سجلاً جديدًا من خلال النقر على + في أعلى يمين الصفحة .

- انقر مرّتين على عمود الحالة لمعرفة كيفية استخدام النوعين Enum Type وDropdown Item.

- اختياري: انقر على الأزرار بعد علامات = لتلوين كل خيار من خيارات القائمة المنسدلة.

- اختياري: يمكنك تجربة المزيد من الخيارات في المحرّر من خلال إضافة خيارات جديدة إلى تعداد الحالة (انقر على إضافة خيار) بالإضافة إلى ألوان جديدة.
- اختياري: جرِّب أنواعًا مختلفة من الأعمدة، مثل اللون ومستوى التقدّم ونعم/لا والهاتف، ثم راقِب سلوكها.

يمكنك تجربة المزيد من الخيارات في "محرّر قاعدة البيانات". في الخطوات التالية، ستنشئ قاعدة بيانات جديدة.
3- إنشاء قاعدة بيانات جديدة وتخصيصها من خلال الاستيراد من "جدول بيانات Google"
توضّح الخطوات التالية كيفية استيراد البيانات من جدول بيانات Google.
إنشاء قاعدة البيانات من جدول بيانات
- أولاً، أنشئ نسخة من جدول بيانات Google العلني هذا وأعِد تسميته باسم
ASDB: IO Codelab.
يُرجى العِلم أنّها تحتوي على علامتَي التبويب المهام والمالكون.
- كما في السابق، انتقِل إلى صفحة AppSheet الرئيسية ( appsheet.com)، ثم انقر على إنشاء > قاعدة بيانات > استيراد من "جداول بيانات Google".

- في "أداة اختيار الملفات" في Google Drive، اختَر نسختك من "جدول بيانات Google"
ASDB: IO Codelabأو الاسم الذي اخترته.
يؤدي ذلك إلى إنشاء قاعدة بيانات جديدة في AppSheet من البيانات الموجودة في جدول البيانات.

إضافة مرجع إلى جدول "مهام Google"
بعد ذلك، أضِف مرجعًا إلى جدول "المالكون" من جدول "المهام".
- في جدول "المهام" في قاعدة بيانات AppSheet، انقر مرّتين على عمود المالك لتعديل إعداداته.
- غيِّر النوع من نص إلى مراجع > مرجع.

- اضبط الجدول المرجعي على المالكون، ثم انقر على حفظ.

- يظهر تحذير بشأن تغيير نوع العمود. في هذه الحالة، تكون البيانات في هذا العمود متوافقة مع نوع العمود الجديد، لذا يمكنك النقر على نعم للمتابعة.

- تحاول قاعدة بيانات AppSheet بعد ذلك مطابقة الصفوف المقابلة في جدول "المالكون" مع الأسماء في جدول "المهام". بما أنّ مجموعة البيانات هذه تتطابق، يجب أن تملأ قاعدة بيانات AppSheet عمود "المالك" بالمراجع الصحيحة لصفوف "المالكين".

- لاختبار المستند المرجعي، انقر على خلية "المالك" وعدِّلها إلى مالك آخر، مثل سارة.

بعد الاختيار، تظهر القيمة الجديدة (سارة) في خلية "المالك" (في جدول "المهام").

تغيير عمود "التصنيف" في الجدول المرجعي
تتيح لك قاعدة بيانات AppSheet اختيار عمود تصنيف لأي جدول. يتيح لك ذلك تحديد العمود الذي تريد أن يظهر في جدول رئيسي. يتحكّم هذا الإعداد أيضًا في المحتوى المعروض في جدول الأب في تطبيق واجهة أمامية مرتبط من AppSheet. بدلاً من عرض عمود الاسم من جدول "المالكون" في جدول "المهام" (الموضّح سابقًا)، يمكنك بدلاً من ذلك عرض عمود البريد الإلكتروني من جدول "المالكون".
- لإجراء ذلك، غيِّر عمود التصنيف في جدول المالكين إلى البريد الإلكتروني من خلال تمرير مؤشر الماوس على الجانب الأيسر من عنوان عمود البريد الإلكتروني والنقر على علامة الحذف العمودية.

يؤدي ذلك إلى استدعاء قائمة السياق الخاصة بالعمود.

- انقر على استخدام العمود كتصنيف في قائمة السياق لضبط تصنيف العمود على عمود البريد الإلكتروني.

- للتأكّد من اختيار عمود "البريد الإلكتروني" كتصنيف العمود الذي يشير إلى جدول "المهام"، انقر على علامة تبويب جدول المهام ولاحظ أنّ عمود "المالك" يعرض الآن عناوين البريد الإلكتروني. قد تحتاج إلى إعادة تحميل المتصفّح للاطّلاع على عمود "المالك" المعدَّل.

4. إنشاء تطبيق AppSheet من قاعدة بيانات AppSheet
بعد الانتهاء من تخصيص قاعدة البيانات، يمكنك إنشاء تطبيق AppSheet مباشرةً من قاعدة البيانات. يكون ذلك مفيدًا إذا كنت تريد واجهة مستخدم أمامية مخصّصة، أو إذا كنت بحاجة إلى إضافة عمليات مبرمَجة أو فلاتر أمان أو غير ذلك. ولإجراء ذلك، اتّبِع الخطوات التالية:
- انقر على التطبيقات على يسار محرّر ASDB.

يؤدي ذلك إلى استدعاء قائمة الاختصارات السياقية على اليسار لإنشاء تطبيق جديد.

- انقر على تطبيق AppSheet جديد لإنشاء تطبيق جديد.

أثناء إنشاء التطبيق، لاحظ أنّ التطبيق يتضمّن تحذيرًا:
Column "Owner" in Tasks_Schema has a reference to an unknown table or slice "Owners". Open the column definition to select a source table.
ويرجع ذلك إلى أنّ التطبيق الذي تم إنشاؤه يحتوي على جدول "المهام" فقط، ويحتوي عمود "المالك" على مرجع إلى جدول غير معروف، وهو "المالكون".
لحلّ هذه المشكلة، أضِف جدول "المالكون" إلى تطبيق AppSheet.
- في صفحة البيانات ضمن محرر AppSheet، انقر على +.

- في القائمة السياقية إضافة بيانات، اختَر قاعدة بيانات AppSheet كمصدر البيانات.

- بعد ذلك، اختَر قاعدة بيانات ASDB: IO Codelab (أو أي اسم اخترته لقاعدة البيانات في الخطوات السابقة).

- في مربّع الحوار التالي، ضَع علامة في مربّع الاختيار التلقائي اختيار الكل، ثم انقر على إضافة إلى التطبيق.

بعد إضافة جدول "المالكون" إلى التطبيق، لن يظهر الخطأ Reference.

- بعد إضافة جدول المالكين الجديد في AppSheet، يمكنك إنشاء "طريقة عرض" جديدة لعرض هذه البيانات من خلال النقر على صفحة طرق العرض في AppSheet والنقر على + بجانب شريط التنقّل الأساسي.

- في مربّع الحوار إضافة طريقة عرض جديدة، انقر على إنشاء طريقة عرض جديدة.

- عند إنشاء طريقة العرض الجديدة، اضبط الخيارات التالية:
اسم العرض: المالكون لهذه البيانات: المالكون نوع العرض: بطاقة

تهانينا، اكتمل تطبيقك الآن.
- لاختبار المرجع بين "المهام" و"المالكين"، انقر على طريقة عرض المالكين أو طريقة عرض المهام في المعاينة على الجهاز الجوّال، ثم اختَر سجلاً للاطّلاع على السجلات ذات الصلة (المشار إليها).

على سبيل المثال، يمكنك النقر على طريقة العرض المالكون، ثم النقر على سجلّ للتوغّل والاطّلاع على سجلّات المهام ذات الصلة.

5- تعديل قاعدة البيانات وإعادة إنشاء جدول "المهام"
بعد إنشاء قاعدة بيانات AppSheet وإنشاء تطبيق جديد منها، جرِّب تعديل جدول في قاعدة البيانات. غيِّر نوع بيانات عمود ولاحظ ما يحدث في تطبيق AppSheet المرتبط.
- في جدول المهام في قاعدة البيانات، غيِّر نوع عمود تاريخ التسليم إلى التاريخ والوقت > التاريخ.

عند الرجوع إلى تطبيق AppSheet، ستلاحظ أنّه تم تعديل قاعدة البيانات مع ظهور تحذير:
App Schema for table 'Tasks' is out of sync with the schema in AppSheet database. Please regenerate the table structure

- لإعادة إنشاء الرد، انقر على رمز إعادة الإنشاء
في أعلى يسار الصفحة. - سيؤدي ذلك إلى ظهور مربّع حوار تحذيري:

- انقر على إعادة إنشاء للمتابعة. يؤدي ذلك إلى تعديل نوع عمود تاريخ الاستحقاق في التطبيق إلى النوع تاريخ، ويتيح عنصر إدخال أداة اختيار التاريخ في نموذج التعديل لسجلات المهام.

6. تهانينا
لقد أكملت الدرس التطبيقي حول الترميز لقاعدة بيانات AppSheet (ASDB).
Further reading
- موقع الوثائق الرسمي لقاعدة بيانات AppSheet