Skip to main content
تحوّل قوالب المستندات بيانات سجل معتمدة إلى مستند DOCX أو PDF مضبوط. استخدمها عندما يجب أن تكون الصياغة والتخطيط متسقين، مثل إقرار الاستلام أو إشعار الموعد أو شهادة الخدمة أو تعليمات المعاينة أو خطاب القرار، مع بقاء السجل الذي برر المستند متاحاً للمراجعة. القالب ملف DOCX مُدار له بيانات وصفية وإصدارات ونتائج تحقق ونمط تنفيذ افتراضي وتعبير اختياري لاسم الملف. وهو لا يحل محل قرار بشري أو سياسة حفظ مستندات أو مراجعة للمستند الناتج. يغطي هذا الدليل دورة حياة القالب والقرارات التشغيلية المرتبطة به. أما قواعد الوسوم الدقيقة وقواعد التأليف في Word والحلقات والصور والروابط ورموز QR والتضمينات وحدود العارض، فراجع وسوم قوالب المستندات وعرضها.

متى تستخدمه

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

أعد استخدام نص المحرر بقوالب الكتابة الشخصية

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

الإعداد

إنشاء القالب والتحقق منه وإصدار نسخته

افتح قوالب المستندات في البناء، وارفع ملفاً من نوع .docx، ثم أدخل اسماً ووصفاً واضحين. تقبل الخدمة قوالب DOCX وتفحص أمان الحزمة وتحلل نص الوسوم المعروفة وتخزن ملخص التحقق وجرد الوسوم مع الإصدار المرفوع. يشير القالب المُدار إلى إصدار حالي واحد؛ يجعل رفع إصدار جديد هذا الإصدار حالياً. تحتفظ الخدمة بالإصدارات الأقدم، لكن شاشة البناء الحالية تعرض معرّف الإصدار الحالي وتنزيل مصدره ولا تعرض قائمة قابلة للاستعراض بالإصدارات السابقة. احتفظ بالملف المصدر المعتمد وسجل الإصدار خارج الشاشة حتى يمكن تتبع أي تغيير في الصياغة ومراجعته. يرفض تحقق الرفع حزم DOCX غير الآمنة وعدداً من مشكلات الوسوم، منها الوسم الفارغ وإدراج XML الخام وصياغة if أو each غير الصحيحة والكتل غير المتوازنة وأمرا @html و@chart المعروفان وغير المدعومين. لكنه لا يثبت أن وسم التحكم يشغل فقرة Word كاملة أو صف جدول كاملاً، ولا يتعرف بشكل موثوق إلى أمر مجهول عشوائي بصيغة @.... كما لا يثبت أن السجل الفعلي يملك كل قيمة اختيارية أو أن العلاقة تأتي بالشكل المتوقع أو أن تخطيط Word النهائي مقبول. اعرض دائماً سجلاً محفوظاً ممثلاً بعد نجاح التحقق؛ فهذا العرض هو اختبار إلزامي لكل موضع if أو each أو else أو تضمين. إدارة قالب مستند KayanOS لإقرار خدمة عامة.

اسم الملف وسياسة المخرج

تعبير اسم الملف هو تعبير JEXL. يستخدم سياق السجل نفسه المستخدم في العرض، ثم ينظف KayanOS محارف اسم الملف غير الآمنة ويقصر النتيجة على طول آمن ويفرض امتداد المخرج المختار. إذا كان التعبير فارغاً أو أخفق، يكون اسم الملف المرفوع هو البديل. لا تجعل سياسة الامتداد معرفة محفوظة لدى الموظفين: اضبط المخرج المطلوب DOCX أو PDF ودع الخدمة تفرض .docx أو .pdf. لإقرار طلب، يمكن استخدام الرقم التسلسلي المخزن في اسم واضح:
يستطيع إجراء الكيان ضبط تعبير اسم خاص به وسياسة مخرج خاصة به. تبدأ الصيغ المسموح بها بـ DOCX؛ ولا يتاح PDF إلا إذا سمح الإجراء به وكانت خدمة تحويل PDF مضبوطة. يرفض الطلب الذي يطلب صيغة لا يسمح بها الإجراء. اختبر الصيغتين عندما تفعل PDF، لأن التحويل خطوة إضافية بعد عرض DOCX.

ربط إجراء بنوع سجل

يربط إعداد إجراء الكيان مفتاح كيان وحقل إجراء بقالب مُدار. ويمكنه تفعيل الإجراء أو إيقافه واختيار تنفيذ caller أو admin وتقييد صيغ المخرج وضبط صيغة افتراضية وتعبير اسم ملف وقائمة كيانات مسموح بها لعمليات البحث المرتفعة. تتبع إجراءات الكيان إصدار القالب المُدار الحالي عمداً؛ فلا تفترض أن الإجراء سيبقى مثبتاً على مسودة سابقة بعد جعل إصدار جديد حالياً. يختلف نمطا التنفيذ اختلافاً جوهرياً: إذا كان لإجراء بنمط المسؤول قائمة كيانات مسموح بها، يرفض استدعاء getRecords الذي يستهدف كياناً خارجها. املأ القائمة بقصد وأبق كل عملية بحث محددة بمرشح ضيق؛ فالوصول المرتفع ليس مبرراً لإتاحة دليل واسع أو سجل حالات كامل في مستند.

معرفة سياق العرض

يمكن لعارض الاختبار قبول JSON أو تحميل سجل كيان محفوظ. يوفر سياق سجل الكيان المحمّل $record و$inverseRelations و$organization و$member و$now. في سياق إجراء الكيان، يسوى $record بحيث تصبح مفاتيح حقوله المخزنة متاحة مباشرة، ويعرّف $organization.id و$member.id المؤسسة والعضو الحاليين، ويكون $relations كائناً فارغاً حالياً. تزود العلاقات العكسية كمجموعات سجلات مهيأة، ولذلك اختبر مفاتيحها وتوقيتها على سجل محفوظ فعلي. ابدأ بسياق JSON صغير أثناء التأليف:
السياق بيانات وليس تجاوزاً للصلاحيات. لا ينبغي أن يظهر في المخرج شيء لا يمكن كشفه بأمان للطالب لمجرد سهولة وضعه في مستند Word.

الإنشاء والمراجعة بمساعد الذكاء الاصطناعي

يوفر مساعد 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. تعامل معه كمحتوى حساس؛ يرفض النظام مواد المصادقة المعروفة، مثل رموز التفويض والمفاتيح الخاصة، ويحذر من أسماء المفاتيح الشبيهة بالأسرار.
قبل أول طلب AI في الجلسة، يجب أن تقر صراحة بأن نص المستند المطبّع وكتالوج السياق المصرح به أو عينته وتعليماتك سترسل إلى مزود الذكاء الاصطناعي المضبوط للمؤسسة. لا يرسل النظام أرشيف DOCX الخام أو XML الخام. إذا لم تقر، يمكنك إلغاء المساعد والعودة إلى الرفع والتحقق العاديين من دون استدعاء AI.

قاعدة الحفظ ونطاق التغييرات

القاعدة الافتراضية هي حفظ صياغة المستند المصدر وترتيبه وتنسيقه وتخطيطه. يستطيع المساعد استبدال قيم نموذجية أو عناصر نائبة بوسوم من دون اعتبار ذلك إعادة صياغة. أما إعادة كتابة نص أو نقل بنية أو حذفها أو تكرارها أو إنشاء جدول، فتتطلب تعليمات صريحة تحدد فقرة أو خلية أو صفاً أو كتلة محدودة؛ ولا يسمح بإعادة كتابة المستند كله إلا إذا طلبت ذلك صراحة. كل عملية مقيدة بمسار سياق مصرح به وهدف معروف وبصمة تمنع تطبيق الخطة على عقدة تغيرت. يمكن للمساعد اقتراح السطح نفسه الذي يدعمه العارض اليدوي: تعبيرات 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 عادية، وأبق جملة بشرية واضحة عندما تكون قيمة اختيارية فارغة. استخدم عبارة «تم الاستلام للمراجعة» بدلاً من «تمت الموافقة». يمكن للنص الأساسي استخدام وسوم مضمنة بسيطة:
قبل إتاحة الإجراء، حمّل طلباً محفوظاً ذا مرجع حقيقي، واعرض DOCX وافحص الملف الناتج، ثم اعرض PDF المسموح به إن كان مفعلاً. تحقق من اسم الملف وقيم البيانات واتجاه النص العربي أو الإنجليزي عند الحاجة والحقول الاختيارية الفارغة والصياغة التي تظهر عندما لا يكون الطلب مقبولاً بعد. دوّن إصدار القالب المعتمد والشخص الذي اعتمد المحتوى. عند تعديل الصياغة القانونية لاحقاً، ارفع إصداراً جديداً وشغّل التحقق واختبر السجل نفسه وحالة حدودية واحصل على اعتماد المحتوى ثم اجعل الإصدار الجديد حالياً. سجل الملف المصدر المعتمد وتاريخ الإصدار والاعتماد خارج شاشة البناء الحالية؛ فالشاشة لا توفر مساراً لتصفح الإصدارات الأقدم. ولأن إجراءات الكيان تتبع الإصدار الحالي، أخطر مالك الخدمة بوقت الإصدار ولا تفترض أن المسودة معزولة عن الإجراءات الحية.

الاختبار

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

استكشاف الأخطاء وإصلاحها

الأذونات وحدود جودة البيانات

إدارة القوالب قدرة إدارية مضبوطة على مستوى البناء: إنشاء القوالب ورفع الإصدارات والتحقق وتنزيل الملفات المصدرية الحالية وضبط الإجراءات واستخدام العرض التجريبي المُدار تتطلب وصول البناء المناسب والأفعال الإدارية المعينة. تنطبق الصلاحيات نفسها على مساعد AI؛ فالمساعد لا يمنح إذناً إضافياً ولا يحول مسودة إلى إجراء نشط. تعامل مع ملف القالب ووسومه وتعبير اسم ملفه كإعداد مضبوط. راجع التغييرات ومخرج DOCX أو PDF مع إنسان مسؤول ومالك الخدمة ومالك صياغة المستند. نمط caller هو الخيار المعتاد للأقل صلاحية. ويمكن لنمط admin أن يقرأ على نطاق أوسع أثناء العرض، لذلك احمه بسبب عمل صريح وقائمة كيانات مسموح بها ومرشحات بحث ضيقة ومخرج مختبر ومراجعة وصول دورية. لا تضع رموز وصول أو كلمات مرور أو بيانات شخصية غير مراجعة أو ملاحظات داخلية سرية في القالب أو اسم الملف أو قيمة QR أو رابط الصورة. يسجل كل تشغيل مُدار نجاحه أو فشله والقالب والإصدار المستخدمين والعضو ونمط التنفيذ وصيغة المخرج المطلوبة والفعلية وعدد صفوف البحث والمدة وحجم المخرج ومرحلة ورسالة الخطأ عند الفشل. استخدم سجل التشغيل للتحقيق في حادث، لكن احتفظ بقرار الخدمة وسياسة الحفظ في سجلاتهما المضبوطة.

أدلة ذات صلة