ابدأ بسياق السجل
عندما ينشئ KayanOS قالب مستند مُداراً لسجل كيان، فإنه يزوّد:
$record لا جذر قواعد الكيان $. تتحول قيمة null أوundefined داخل الإدراج إلى فراغ، لذلك أضف بديلاً مراجعاً في المستندات العامة أو الرسمية.
الوقت الثابت والتنسيق
استخدم$now عندما يجب أن يعرض كل جزء من المستند الطابع نفسه. تتاح now() كدالة أيضاً، لكنها تقيم من قبل العارض وقد تختلف قليلاً بين التعبيرات.
البحث المضبوط عن السجلات
تتلقى دالةgetRecords الخاصة بالقالب كائناً واحداً:
entityKey وq الاختيارية وfilters وlimit وsorting وsearch. تكون قيمة sorting قائمة كائنات، يحوي كل منها field وdirection: "asc" | "desc"؛ وليست كائناً مفهرساً باسم الحقل. يحصر كل استدعاء limit بين 1 و500. اجعل البحث ضيقاً، واختر البيانات اللازمة للمستند فقط، واجعل غياب النتيجة مفهوماً.
وضعي المتصل والمدير
في وضع المتصل يقيّم البحث كعضو متصل. وفي وضع المدير يستخدم هوية تنفيذ إدارية. هذا قرار حوكمة بيانات جوهري لا تفضيل تنسيق. لا يتقيد بحث المدير بقائمة الكيانات المسموحة إلا عندما تكون القائمة غير فارغة. ليست القائمة المحذوفة أو الفارغة قاعدة منع: فهي تسمح بالبحث في كل كيان في المؤسسة تستطيع هوية التنفيذ الإدارية قراءته. لا تختر وضع المدير قبل أن يراجع مالك الخدمة هذا الحد الأوسع. وعند الحاجة إليه، أضف قائمة قصيرة غير فارغة ومعتمدة من مفاتيح الكيانات، واعتبر أي تغيير لاحق فيها تغييراً في الوصول. قبل نشر قالب يستخدمgetRecords:
- اختر وضع المتصل ما لم يوافق مالك الخدمة على حاجة إدارية أضيق.
- في وضع المدير اضبط قائمة غير فارغة من الكيانات المسموحة بأشد شكل ممكن؛ لا تتركها فارغة متوقعاً أنها قيد.
- اختبر بعضو ينبغي أن يرى أقل كمية بيانات، ثم اختبر كياناً خارج القائمة غير الفارغة وتأكد من رفض البحث.
- افحص المستند الناتج بحثاً عن بيانات شخصية أو مالية أو تشغيلية غير مقصودة.
- لا تجعل البحث الفارغ ينتج عبارة مضللة.
البيانات المرتبطة والحلقات
تناسب العلاقات العكسية المهيأة قسماً صغيراً للسجلات المرتبطة. تنتمي حلقة قالب المستند إلى صياغة الوسم، بينما يزود التعبير المجموعة. يكشف العارض حالياً$relations ككائن محفوظ فارغ، لذلك لا تستخدمه كعقد لبيانات العلاقات المباشرة. ضع القيمة المباشرة المطلوبة على السجل عند ملاءمة ذلك، أو استخدم علاقة عكسية مهيأة، أو بحث getRecords مراجعاً.