Cargolake
المساعدة والأدلة/الشحنات

منشئ النماذج

تصميم النماذج التي تعرضها الانتقالات — الأقسام، وأنواع الحقول، والتحقق، والإظهار الشرطي.

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

البنية

للنموذج عنوان، واسم مخطط يحدد ما يجمعه، وتخطيط من ١ إلى ٤ أعمدة يحوي أقسامًا.

ولكل قسم:

الإعدادالغرض
الاسمعنوانه.
الأعمدةعدد الأعمدة داخل القسم (١–٤).
الامتدادما يشغله من عرض الأصل (١–٤).
اسم المخططالكيان الذي تنتمي إليه حقول القسم.
علاقة الكيانكيف يرتبط ذلك الكيان — انظر أدناه.

فالقسم قد يجمع بيانات عن شيء غير الشحنة نفسها. وعلاقة الكيان تصف الرابط: أي حقل في السجل الرئيسي يشير إليه، وهل هو سجل مفرد أم مصفوفة منها، وأي مفتاح يربطهما.

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

أنواع الحقول

النوعلأجل
textنص حر
numberإدخال رقمي
dateالتواريخ
textareaنص طويل
selectقائمة ثابتة
checkboxمربع نعم/لا
toggleمفتاح نعم/لا
tableصفوف متكررة
documentرفع ملف
autoCompleteSelectorبحث أثناء الكتابة في قائمة
fetcher-combobox-with-configبحث أثناء الكتابة في بيانات حيّة من وحدة أخرى
dynamicComboBoxقائمة تعتمد خياراتها على إجابات أخرى
calculatedقيمة مشتقة بمعادلة من حقول أخرى
customمكوّن مخصص

ولكل حقل تسمية ونص إرشادي وامتداد (١–٤)، وعلامة إدراج تتيح إبقاء الحقل معرَّفًا خارج النموذج.

الحقول المحسوبة

الحقل calculated يقيّم معادلة على حقول أخرى — أرقام وعمليات وأقواس. استخدمه لأي شيء لا ينبغي كتابته مرتين: إجمالي، أو وزن خاضع للاحتساب، أو فرق بين تاريخين.

فكل ما يمكن اشتقاقه ينبغي حسابه لا إدخاله. وكل قيمة مشتقة مكتوبة يدويًا هي تعارض مستقبلي.

التحقق

القاعدةتنطبق على
مطلوبأي حقل
الحد الأدنى / الأقصىالأرقام
أدنى / أقصى طولالنصوص
النمطنص بصيغة محددة
منع المستقبلتواريخ لا يمكن أن تقع في المستقبل

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

الإظهار الشرطي

يمكن إظهار حقل أو إخفاؤه حسب قيمة حقل آخر، بشرط على صورة حقل · عملية · قيمة، والعمليات:

eq · neq · gt · lt · gte · lte · contains · notContains · exists

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

والإظهار الشرطي أفضل من نموذج أطول أو نموذج ثانٍ. فالمشغّلون يملؤون ما أمامهم، والنموذج الذي لا يعرض إلا الحقول ذات الصلة يُملأ صحيحًا.

إرشادات التصميم

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

أين تُربط النماذج

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

آخر تحديث ١٠ أغسطس ٢٠٢٦