متى تستخدمه
استخدم قالباً مُداراً عندما يجب إنشاء المستند المعتمد نفسه مراراً من سجل. من الأمثلة إقرار طلب خدمة مواطن أو إشعار زيارة معاينة عقار أو خطاب أهلية أو جدول دفعات أو شهادة إتمام خدمة. ينبغي أن يقرأ القالب مفاتيح مخزنة من السجل؛ ولا ينبغي أن يكون المكان الوحيد الذي تتذكر فيه المؤسسة قراراً أو رقم مستند. اختر آلية أخرى عندما تكون الحاجة مختلفة:
أبق الاستخدام محدوداً. فالمستند الواحد «لكل الأغراض» يصعب اختباره واعتماده ويصبح خطراً عند استخدامه مع وصول مرتفع. فضّل قالب إقرار وقالب شهادة منفصلين، يرتبط كل منهما بنوع سجل وقرار إصدار واضحين.
أعد استخدام نص المحرر بقوالب الكتابة الشخصية
تختلف قوالب الكتابة عن قوالب المستندات المُدارة التي يشرحها باقي هذا الدليل. يعيد قالب الكتابة استخدام محتوى محرر غني داخل ملاحظة أو وصف أو رسالة أو محرر آخر يفعّل أداة القوالب. ولا ينشئ ملف DOCX أو PDF، ولا يقرأ سياق كيان، ولا ينشئ إصداراً ثابتاً، ولا يجري عمليات بحث بصلاحية مرتفعة. افتح منتقي قوالب الكتابة من شريط أدوات المحرر الغني، أو استخدم مدخل قائمة الشرطة المائلة عندما يكون متاحاً. ابحث عن قالب مدمج أو محفوظ واختره لإدراج المحتوى في موضع المحرر الحالي. لإنشاء قالب شخصي، جهز المحتوى القابل لإعادة الاستخدام وافتح المنتقي واختر الحفظ كقالب، ثم امنحه اسماً فريداً واضحاً. ويمكن إعادة تسمية القوالب المحفوظة أو حذفها من المنتقي نفسه. تقتصر قوالب الكتابة الشخصية على العضو الحالي داخل المؤسسة النشطة. لا تشارك تلقائياً مع الزملاء، وعند تبديل سياق المؤسسة تُحمّل قوالب ذلك العضو في المؤسسة الجديدة. وقد تظهر أيضاً قوالب مدمجة يوفرها المحرر، لكنها لا تقبل إعادة التسمية أو الحذف مثل القالب الشخصي. ينشئ الإدراج محتوى قابلاً للتحرير، لا بياناً نهائياً مضبوطاً. قبل الحفظ أو الإرسال، راجع الأسماء والتواريخ والمستلمين والمراجع واتجاه اللغة وأي صياغة ربما تقادمت. لا تحفظ بيانات اعتماد أو بيانات شخصية أو عبارة خاصة بحالة حية كقالب قابل لإعادة الاستخدام.الإعداد
إنشاء القالب والتحقق منه وإصدار نسخته
افتح قوالب المستندات في البناء، وارفع ملفاً من نوع.docx، ثم أدخل اسماً ووصفاً واضحين. تقبل الخدمة قوالب DOCX وتفحص أمان الحزمة وتحلل نص الوسوم المعروفة وتخزن ملخص التحقق وجرد الوسوم مع الإصدار المرفوع. يشير القالب المُدار إلى إصدار حالي واحد؛ يجعل رفع إصدار جديد هذا الإصدار حالياً. تحتفظ الخدمة بالإصدارات الأقدم، لكن شاشة البناء الحالية تعرض معرّف الإصدار الحالي وتنزيل مصدره ولا تعرض قائمة قابلة للاستعراض بالإصدارات السابقة. احتفظ بالملف المصدر المعتمد وسجل الإصدار خارج الشاشة حتى يمكن تتبع أي تغيير في الصياغة ومراجعته.
يرفض تحقق الرفع حزم DOCX غير الآمنة وعدداً من مشكلات الوسوم، منها الوسم الفارغ وإدراج XML الخام وصياغة if أو each غير الصحيحة والكتل غير المتوازنة وأمرا @html و@chart المعروفان وغير المدعومين. لكنه لا يثبت أن وسم التحكم يشغل فقرة Word كاملة أو صف جدول كاملاً، ولا يتعرف بشكل موثوق إلى أمر مجهول عشوائي بصيغة @.... كما لا يثبت أن السجل الفعلي يملك كل قيمة اختيارية أو أن العلاقة تأتي بالشكل المتوقع أو أن تخطيط Word النهائي مقبول. اعرض دائماً سجلاً محفوظاً ممثلاً بعد نجاح التحقق؛ فهذا العرض هو اختبار إلزامي لكل موضع if أو each أو else أو تضمين.
اسم الملف وسياسة المخرج
تعبير اسم الملف هو تعبير JEXL. يستخدم سياق السجل نفسه المستخدم في العرض، ثم ينظف KayanOS محارف اسم الملف غير الآمنة ويقصر النتيجة على طول آمن ويفرض امتداد المخرج المختار. إذا كان التعبير فارغاً أو أخفق، يكون اسم الملف المرفوع هو البديل. لا تجعل سياسة الامتداد معرفة محفوظة لدى الموظفين: اضبط المخرج المطلوب DOCX أو PDF ودع الخدمة تفرض.docx أو .pdf.
لإقرار طلب، يمكن استخدام الرقم التسلسلي المخزن في اسم واضح:
ربط إجراء بنوع سجل
يربط إعداد إجراء الكيان مفتاح كيان وحقل إجراء بقالب مُدار. ويمكنه تفعيل الإجراء أو إيقافه واختيار تنفيذcaller أو admin وتقييد صيغ المخرج وضبط صيغة افتراضية وتعبير اسم ملف وقائمة كيانات مسموح بها لعمليات البحث المرتفعة. تتبع إجراءات الكيان إصدار القالب المُدار الحالي عمداً؛ فلا تفترض أن الإجراء سيبقى مثبتاً على مسودة سابقة بعد جعل إصدار جديد حالياً.
يختلف نمطا التنفيذ اختلافاً جوهرياً:
إذا كان لإجراء بنمط المسؤول قائمة كيانات مسموح بها، يرفض استدعاء
getRecords الذي يستهدف كياناً خارجها. املأ القائمة بقصد وأبق كل عملية بحث محددة بمرشح ضيق؛ فالوصول المرتفع ليس مبرراً لإتاحة دليل واسع أو سجل حالات كامل في مستند.
معرفة سياق العرض
يمكن لعارض الاختبار قبول JSON أو تحميل سجل كيان محفوظ. يوفر سياق سجل الكيان المحمّل$record و$inverseRelations و$organization و$member و$now. في سياق إجراء الكيان، يسوى $record بحيث تصبح مفاتيح حقوله المخزنة متاحة مباشرة، ويعرّف $organization.id و$member.id المؤسسة والعضو الحاليين، ويكون $relations كائناً فارغاً حالياً. تزود العلاقات العكسية كمجموعات سجلات مهيأة، ولذلك اختبر مفاتيحها وتوقيتها على سجل محفوظ فعلي.
ابدأ بسياق JSON صغير أثناء التأليف:
الإنشاء والمراجعة بمساعد الذكاء الاصطناعي
يوفر مساعد DOCX بالذكاء الاصطناعي مساراً مؤقتاً يسبق إنشاء القالب المُدار أو إصدار نسخته. عند إنشاء قالب جديد، اختر Create with AI helper بجانب مسار الرفع المباشر. وعند إعداد إصدار لقالب موجود، افتح Versions واختر Revise with AI helper لبدء المراجعة من الإصدار المُدار الحالي. إذا كنت قد اخترت ملف DOCX بديلاً في Versions، يبقى اختيارك محفوظاً عند العودة من المساعد، لكنه لا يصبح مصدر مراجعة AI؛ استخدم Validate and upload للتحقق من ذلك الملف ورفعه عبر المسار المباشر المنفصل. يبقى مسارا الرفع المباشر والتحقق المعتادان متاحين بلا تغيير.السياق والكشف قبل التوليد
لا يبدأ التوليد حتى تختار مصدراً واحداً صالحاً للسياق:- سياق كيان: اختيار الكيان إلزامي، أما اختيار سجل ممثل فاختياري. يستخدم السجل المختار قيماً واقعية يمكن للعضو الحالي قراءتها. وإذا لم تختر سجلاً، ينشئ النظام معاينة عينة حتمية ومعلّمة بوضوح بحسب أنواع الحقول؛ ولا تُكتب قيم العينة في الوسوم أو بيانات القالب الوصفية ولا توسع الحقول المتاحة.
- سياق JSON يدوي: أدخل كائن JSON صالحاً. الحد 256 KiB بترميز UTF-8 وعمق التداخل 12 وحد كل مصفوفة 1,000 عنصر وطول السلسلة 32 KiB. تعامل معه كمحتوى حساس؛ يرفض النظام مواد المصادقة المعروفة، مثل رموز التفويض والمفاتيح الخاصة، ويحذر من أسماء المفاتيح الشبيهة بالأسرار.
قاعدة الحفظ ونطاق التغييرات
القاعدة الافتراضية هي حفظ صياغة المستند المصدر وترتيبه وتنسيقه وتخطيطه. يستطيع المساعد استبدال قيم نموذجية أو عناصر نائبة بوسوم من دون اعتبار ذلك إعادة صياغة. أما إعادة كتابة نص أو نقل بنية أو حذفها أو تكرارها أو إنشاء جدول، فتتطلب تعليمات صريحة تحدد فقرة أو خلية أو صفاً أو كتلة محدودة؛ ولا يسمح بإعادة كتابة المستند كله إلا إذا طلبت ذلك صراحة. كل عملية مقيدة بمسار سياق مصرح به وهدف معروف وبصمة تمنع تطبيق الخطة على عقدة تغيرت. يمكن للمساعد اقتراح السطح نفسه الذي يدعمه العارض اليدوي: تعبيرات JEXL المضمنة، وكتلif/else، وحلقات each، والصور، والروابط، ورموز QR، وفواصل الصفحات، وتضمين قالب مُدار متاح، واستدعاءات getRecords محدودة ومصرحاً بها. تبقى قواعد الموضع والحدود والبروتوكولات والوصول الموضحة في وسوم قوالب المستندات وعرضها ملزمة؛ ولا يستطيع طلب بلغة طبيعية تجاوزها.
كل توليد ناجح ينشئ مراجعة مؤقتة مرقمة، ويمكنك مراجعة ملخص التغيير والوسوم والمخرج، وطلب تعديل آخر، والعودة إلى مراجعة سابقة، وإعادة الضبط إلى المصدر الثابت، وتنزيل DOCX للمراجعة في Word. لا تستبدل محاولة AI أو تصحيح أو تحقق أو عرض فاشلة آخر مراجعة صالحة. إذا كان لمسار تسمية أكثر من معنى أو لم يوجد مسار مصرح به، تظهر مشكلة تعيين reviewable أو ambiguous؛ وقد يعرض المستند، لكن يبقى الاعتماد محظوراً حتى يحسم إنسان كل مشكلة.
الاعتماد والحفظ المؤقت
اقتراح AI مسودة تحتاج إلى مراجعة بشرية، وليس قراراً أو موافقة. لا يوسع المساعد صلاحيات العضو، ولا يكشف حقولاً غير مقروءة، ولا يغير ارتباطات الإجراءات أو نمط التنفيذ أو الكيانات المسموح بها. عند اعتماد إصدار لقالب موجود تبقى إعدادات القالب والإجراءات الحالية كما هي. وعند اعتماد قالب جديد يجب تأكيد بياناته الوصفية المطلوبة، ومنها الاسم، وأي وصف أو افتراضات تعرضها نافذة الإنشاء، قبل الحفظ. الاعتماد متكرر بأمان: إعادة الطلب الناجح نفسه تعيد القالب والإصدار نفسيهما بدلاً من إنشاء نسخة مكررة. يتطلب Approve and save مراجعة بشرية لمراجعة صالحة بلا مشكلات تعيين حاجبة ونجاح عرض ممثل. إذا تعذر تحويل PDF، يبقى تنزيل DOCX متاحاً، لكن يجب تنزيله ومراجعته ثم الإقرار صراحة بمراجعة DOCX فقط قبل الاعتماد. لا يؤدي فشل الحفظ إلى تغيير الإصدار المُدار النشط. تنتهي المسودة بعد 24 ساعة من آخر نشاط، مع حد أقصى صارم يبلغ سبعة أيام من إنشائها. يؤدي Discard draft إلى تعليم البيانات الحساسة والكائنات المؤقتة للحذف الفوري، كما يحذف الاعتماد الناجح الملفات المؤقتة ويمحو السياق اليدوي والتعليمات الحساسة. يبقى فقط سجل تدقيق غير حساس يلزم لتتبع الفاعل ومعرّفات الجلسة والمراجعة وملخص العمليات والنتيجة، ولا يبقى فيه السجل الممثل أو حمولة JSON الخام.مثال عملي
ترسل جهة خدمة عامة سورية إقراراً بعد تسجيل الموظف طلب خدمة مقيم. يحتوي الكيانcitizen_service_requests على request_reference وresident_name وservice_name وreceived_at وsubmission_status المضبوط. يجب أن يعرض الإقرار المرجع المخزن ويبين للمقيم ما استُلم ويتجنب الادعاء بالموافقة قبل إتمام المراجع للعملية.
اضبط قالباً باسم إقرار طلب خدمة بنمط caller. اربطه بحقل إجراء «إنشاء الإقرار» في كيان الطلب، واسمح بـ DOCX وPDF فقط إذا اختبرت الجهة المخرجين، واستخدم تعبير اسم الملف أعلاه. ضع المرجع واسم المقيم في فقرات Word عادية، وأبق جملة بشرية واضحة عندما تكون قيمة اختيارية فارغة. استخدم عبارة «تم الاستلام للمراجعة» بدلاً من «تمت الموافقة».
يمكن للنص الأساسي استخدام وسوم مضمنة بسيطة:
الاختبار
اختبر المستند كدورة حياة كاملة لا كتعبير وسم فقط. استخدم سجلاً غير إنتاجي يشبه سجل الخدمة المقصود من دون كشف بيانات شخصية فعلية.
اختبر قاعدة اسم الملف بسجل معروف قبل إضافة أجزاء اختيارية:
استكشاف الأخطاء وإصلاحها
الأذونات وحدود جودة البيانات
إدارة القوالب قدرة إدارية مضبوطة على مستوى البناء: إنشاء القوالب ورفع الإصدارات والتحقق وتنزيل الملفات المصدرية الحالية وضبط الإجراءات واستخدام العرض التجريبي المُدار تتطلب وصول البناء المناسب والأفعال الإدارية المعينة. تنطبق الصلاحيات نفسها على مساعد AI؛ فالمساعد لا يمنح إذناً إضافياً ولا يحول مسودة إلى إجراء نشط. تعامل مع ملف القالب ووسومه وتعبير اسم ملفه كإعداد مضبوط. راجع التغييرات ومخرج DOCX أو PDF مع إنسان مسؤول ومالك الخدمة ومالك صياغة المستند. نمطcaller هو الخيار المعتاد للأقل صلاحية. ويمكن لنمط admin أن يقرأ على نطاق أوسع أثناء العرض، لذلك احمه بسبب عمل صريح وقائمة كيانات مسموح بها ومرشحات بحث ضيقة ومخرج مختبر ومراجعة وصول دورية. لا تضع رموز وصول أو كلمات مرور أو بيانات شخصية غير مراجعة أو ملاحظات داخلية سرية في القالب أو اسم الملف أو قيمة QR أو رابط الصورة.
يسجل كل تشغيل مُدار نجاحه أو فشله والقالب والإصدار المستخدمين والعضو ونمط التنفيذ وصيغة المخرج المطلوبة والفعلية وعدد صفوف البحث والمدة وحجم المخرج ومرحلة ورسالة الخطأ عند الفشل. استخدم سجل التشغيل للتحقيق في حادث، لكن احتفظ بقرار الخدمة وسياسة الحفظ في سجلاتهما المضبوطة.
أدلة ذات صلة
- اكتب وسوماً مضمنة وحلقات وتضمينات آمنة في وسوم قوالب المستندات وعرضها.
- اختر حقولاً وتخطيطات مستقرة في حقول الكيانات وتخطيطاتها.
- تعلّم الصياغة الكاملة والدوال في صياغة لغة التعبيرات.
- اضبط مراجع قابلة للتتبع للمستندات في المعرّفات التسلسلية.

