تعديل الحقول

تعدّل النموذج في صفحة الطبقة الدلالية، في وضع البناء أو وضع الكود. ويعدّل الوضعان ملف YAML نفسه، ولا يسري تغيير حتى تحفظ.

الكيانات في وضع البناء

تحت كيانات العمل، انقر إضافة كيان، ثم افتح الكيان واملأ حقوله:

الاسم: معرّف بحروف صغيرة، مثل orders. تشير المؤشرات والعلاقات إلى الكيان بهذا الاسم، وإذا أعدت تسميته في وضع البناء، حُدّثت المؤشرات والعلاقات التي تشير إليه.
قاعدة البيانات والجدول: تأتي قائمة الجداول من مخطط الاتصال الفعلي، وتعني رسالة غير موجود في قاعدة البيانات هذه أن الجدول لم يعد فيها.
المفتاح الأساسي: العمود الذي يميّز الصف الواحد، ويلزم لعدّ الصفوف ولربط الكيانات الأخرى بهذا الكيان.
الوصف: ما يمثّله الصف الواحد، مثل «صف واحد لكل طلب»، ويقرؤه المساعد.
معتمد: يعطيه المساعد الأولوية: يوسم الكيان بأنه التعريف الذي يعتمده فريقك.
الأبعاد: الأعمدة التي تقسّم بها الأرقام. انقر إضافة بُعد، واختر العمود، واكتب التسمية، وحدد النوع: تصنيف أو تاريخ أو وقت أو رقم أو موقع أو نعم أو لا.
العلاقات: روابط بكيانات أخرى. انقر إضافة علاقة، واختر هذا العمود في هذا الكيان، والكيان في يطابق الكيان، وعموده في على العمود، وهو افتراضيًا مفتاح ذلك الكيان الأساسي. ثم سمِّ العلاقة في اسم العلاقة وحدد نوع العلاقة: متعدد إلى واحد أو واحد إلى متعدد أو واحد إلى واحد.

اختر جدولًا قبل أن تضيف الأبعاد أو العلاقات، وأضف كيانًا ثانيًا قبل أن تضيف علاقة. وباسم العلاقة تصل المؤشرات إلى أبعاد الكيان الآخر، مثل store.region.

ويزيل حذف هذا الكيان الكيانَ والمؤشراتِ المبنية عليه من الملف.

المؤشرات في وضع البناء

تحت المؤشرات، انقر إضافة مؤشر. وتشرح صفحة تعريفات المؤشرات حقوله كلها.

العمل في وضع الكود

يعرض وضع الكود ملف YAML نفسه.

اختر إدراج لتضيف قاعدة بيانات أو كيان أو علاقة أو مؤشر، فيسألك كيوبت عن التفاصيل، ويضع الأسطر الجديدة في قسمها الصحيح ويبرزها.
اضغط Ctrl+Space لتظهر الاقتراحات وأنت تكتب.
يشرح تبويب دليل الصياغة الحقول كلها.

إذا كان في ملف YAML خطأ في الصياغة، فلن يفتحه وضع البناء حتى تصحّحه في وضع الكود.

ومن الإعدادات ما لا يُكتب إلا في وضع الكود، وكل تعديل في وضع البناء يعيد كتابة الملف بدونها:

is_visible_to_ai: false على البُعد، ويخفيه عن المساعد
description_ar على الكيان
join_type وdescription على العلاقة
التصفية المكتوبة في أكثر من كتلة all

وتُحذف التعليقات كذلك إذا عدّلت في وضع البناء. فإن كنت تعتمد على شيء من هذا، فأجرِ تعديلاتك في وضع الكود.

الفحص والحفظ

انقر فحص، فيطابق كيوبت الملف بالمخطط الفعلي لكل اتصال دون أن يحفظ شيئًا.
أصلح المشكلات المعروضة تحت المحرر، وانقر رقم سطر المشكلة لتنتقل إليه في وضع الكود. وتمنع الأخطاءُ الحفظ، أما الملاحظات، كالتنبيه على علاقة بين قاعدتَي بيانات، فلا تمنعه.
انقر حفظ، فيعرض كيوبت راجع قبل التطبيق وفيه ما سيُنشأ وما سيُحدَّث وما سيُحذف.
انقر تأكيد وحفظ.

إذا تغيّر النموذج المحفوظ وأنت تعدّله، كأن يحفظ المساعد تغييرًا، احتفظ كيوبت بتعديلاتك وأظهر تنبيهًا، فراجع قائمة التغييرات بعناية قبل الحفظ. وإذا أغلقت التبويب أو أعدت تحميله وفيه تعديلات غير محفوظة، طُلب منك التأكيد.

التعديل بالمساعد

افتح المساعد وأنت في صفحة الطبقة الدلالية، فيقترح عليك بدايات مثل اشرح هذا النموذج وابنِ نموذجًا من بياناتي وعرّف مؤشرًا واربط الجداول ذات الصلة.

يقرأ المساعد النموذج ويفحصه ويحفظ الإضافات والتعديلات، لكنه لا يستطيع حفظ تغيير يحذف من النموذج شيئًا؛ فإن كان التغيير سيحذف شيئًا، طلب منك أن تجريه في المحرر.

ولا يغيّر المساعد النموذج إلا إذا كانت قدرة المؤشرات والنموذج الدلالي مفعّلة وكان دورك المالك أو المسؤول. راجع صلاحيات المساعد.