ضع لوحة معلومات على شاشة مرسومة

الهدف

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

لماذا هذا موجود

لوحة المعلومات بطاقات وأرقام ومخطّطات وسطحان أو ثلاثة من سطوح السجلات. كانت الشاشة المرسومة تملك الأوّلين ولا تملك الأخيرين، فصارت تملك الاثنين: أداة مخطّط وأداة عرض جدول أو نموذج.

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

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

الرقم استعلام يعُدّ

loadRecords("par_ticket", "probe", {
  top: 1,
  where: { par_status: 100000002 },
  countInto: "statusActive"
});

countInto هو مكان عدد الصفوف المطابقة — لا عدد ما عاد. وtop: 1 هو ما يُبقي ذلك صادقًا: العدّ على كل شيء، والصفحة التي لا يقرؤها أحد أصغر ما تكون. وprobe حقل حالة تعلنه مرّة ولا تنظر إليه أبدًا.

ثم ارسم نصًّا كبيرًا واربط النص فيه بـtext(state.statusActive).

عدّ ما هو فارغ. لا يقارن where إلا بالمساواة، لذا فإن «ما ليس في حقله شيء» خيار قائم بذاته: empty، وهو قائمة بالحقول التي يجب ألّا تحمل قيمة.

loadRecords("pbo_position", "probe", {
  top: 1,
  where: { state: 0 },
  empty: ["pbo_currentoccupant"],
  countInto: "vacant"
});

هذا يعدّ الوظائف المفتوحة التي لا يشغلها أحد. وهو الشرط نفسه لمرشّح «فارغ» في طريقة العرض، فتتّفق البطاقة والقائمة التي بجانبها.

مخطّط

ضع المكوّنات ← مخطّط. في تبويب التطبيق:

• المخطّط — أعمدة، أعمدة متراكمة، خط، مساحة، دائري أو حلقي.

• القيمة — قائمة من { label, value }:

  [
    { label: "New", value: state.statusNew },
    { label: "Active", value: state.statusActive },
    { label: "Resolved", value: state.statusResolved }
  ]

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

ضع الكلمات داخل الأداة. أي نص ترسمه داخل المخطّط يصير اسمه الميسَّر — بدونه يعلن قارئ الشاشة «رسم» فقط. ولا يُرسَم فوق المخطّط؛ العنوان الظاهر في اللوحة فوقه.

لا محور مزدوج ولن يكون. مقياسان في إطار واحد يدعوان إلى مقارنة لا تسندها الهندسة. مقياسان مختلفا الحجم مخطّطان.

شبكة أو نموذج من جدول

ضع المكوّنات ← عرض جدول أو نموذج. في تبويب التطبيق:

الحقل	المعنى
يعرض	صفوف عرض، أو نموذج لسجل جديد، أو نموذج لسجل واحد
الجدول	يُختار من جداول البيئة — اكتب للتصفية بالاسم أو الاسم المنطقي
العرض / النموذج	يُختار من عروض ذلك الجدول أو نماذجه، أو الافتراضي للجدول

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

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

الخطوات

1. ارسم الصفحة: عنوانًا، وصفًّا من البطاقات، ولوحات للمخطّطات ولوحات للسطوح.
2. أعلِن الحالة — حقلًا لكل رقم، مع probe.
3. ضع كل استعلام عدّ في معالج التحميل للشاشة، والأسطر نفسها خلف زرّ تحديث.
4. ضع المخطّطات والسطوح واملأ حقولها.
5. أعطِ كل كائن قيودًا لتملأ الصفحة النافذة — تنتشر البطاقات وتحفظ المخطّطات والسطوح حوافّها.

استورد النموذج أوّلًا

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

حل المشكلات

• السطح يقول إنه لا يعرف الجدول. — حقل الجدول فارغ. يحذّر الحفظ من ذلك ولا يرفضه، لتُكمل لاحقًا.
• السطح يقول لا يوجد جدول كهذا. — حُذف الجدول منذ اختياره، أو استُورد التطبيق إلى بيئة لا تحويه. ما زال حقل الجدول يعرض الاسم القديم؛ اختر جدولًا موجودًا في البيئة.
• السطح يقول إن هذا المضيف لا يستطيع عرض سطح مبني على النموذج. — أنت تنظر إلى معاينة المصمّم، ولا بيئة خلفها. افتح التطبيق في القشرة.
• المخطّط فارغ. — القيمة فيه ليست قائمة من { label, value }. الصف الذي ليس بهذا الشكل يُسقَط ولا يُرسَم صفرًا، فيظهر الشكل الخاطئ كعمود ناقص.
• الأرقام لا تتحرّك بعد إضافة سجل. — لا شيء أعاد تشغيل الاستعلامات. ضعها خلف زرّ تحديث، أو أعِد تشغيلها في المعالج الذي كتب السجل.
• الأرقام تحرّكت لكن الشبكة المضمّنة لا. — السطح المضمّن هو شبكة المنصة أو نموذجها، وهو يملك استعلامه الخاص، فإعادة تشغيل استعلاماتك أنت لا تمسّه. أنهِ المعالج بـ reloadSurfaces()، فيَعرض كل جدول ونموذج مضمّن في الشاشة من جديد. افعل ذلك في المعالج الذي أنشأ السجلات كما في زرّ التحديث — أربعة وعشرون سجلًّا جديدًا بجانب جدول فارغ هو أكثر ما يُربك في لوحة معلومات.

سيناريوهات ذات صلة

• اعرض القائمة صفحةً صفحة.
• اجعل الشاشة تتفاعل.