> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kayanos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# قوالب المستندات

> أنشئ واضبط واختبر وشغّل قوالب DOCX مُدارة في KayanOS لإصدار مستندات خدمة عامة موثوقة.

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

يغطي هذا الدليل دورة حياة القالب والقرارات التشغيلية المرتبطة به. أما قواعد الوسوم الدقيقة وقواعد التأليف في Word والحلقات والصور والروابط ورموز QR والتضمينات وحدود العارض، فراجع [وسوم قوالب المستندات وعرضها](/ar/build/document-template-tags-and-rendering).

## متى تستخدمه

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

اختر آلية أخرى عندما تكون الحاجة مختلفة:

| الحاجة                                  | النهج الأنسب                           | السبب                                                                 |
| --------------------------------------- | -------------------------------------- | --------------------------------------------------------------------- |
| يجب أن يقرر موظف هل يسمح بإصدار المستند | حالة مضبوطة وإجراء وحقول مراجعة مسؤولة | عرض البيانات لا يمنح موافقة.                                          |
| يجب أن يقدم المواطن معلومات             | نموذج أو مسار بوابة عامة               | القالب ينتج مخرجاً ولا يجمع إرسالاً متحققاً منه.                      |
| يلزم إصدار مرجع فريد                    | حقل معرّف تسلسلي                       | استخدم الرقم التسلسلي المخزن في القالب بدلاً من إنشاء رقم داخل Word.  |
| ملاحظة شخصية لمرة واحدة                 | ملاحظة سجل مضبوطة أو مسار مراسلة معتمد | القالب المُدار أفضل عندما تكون القابلية للتكرار وسجل الإصدارات مهمين. |
| تصدير بيانات غير مراجع                  | تقرير أو تصدير له مراجعة وصول مستقلة   | يجب أن يضم القالب فقط البيانات التي يسمح للجمهور المقصود برؤيتها.     |

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

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

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

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

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

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

## الإعداد

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

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

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

![إدارة قالب مستند KayanOS لإقرار خدمة عامة.](https://kayanos.app/docs-images/ar/build/document-templates.png)

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

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

لإقرار طلب، يمكن استخدام الرقم التسلسلي المخزن في اسم واضح:

```jexl theme={null}
'request-acknowledgement-' + $record.request_reference
```

يستطيع إجراء الكيان ضبط تعبير اسم خاص به وسياسة مخرج خاصة به. تبدأ الصيغ المسموح بها بـ DOCX؛ ولا يتاح PDF إلا إذا سمح الإجراء به وكانت خدمة تحويل PDF مضبوطة. يرفض الطلب الذي يطلب صيغة لا يسمح بها الإجراء. اختبر الصيغتين عندما تفعل PDF، لأن التحويل خطوة إضافية بعد عرض DOCX.

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

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

يختلف نمطا التنفيذ اختلافاً جوهرياً:

| النمط    | ما يعنيه                                                                                                               | الخيار الآمن المعتاد                                                           |
| -------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `caller` | تعمل عمليات البحث بالعضو الذي طلب المستند؛ ويبقى نطاق سجلاته ووصوله العادي ساريين.                                     | استخدمه للمستندات التي ينبغي للموظف إنشاؤها فقط من سجلات يستطيع قراءتها أصلاً. |
| `admin`  | يمكن للعرض تشغيل عمليات البحث بصفتها مسؤول النظام. ويحتاج من يضبط أو يطلب هذا النمط إلى صلاحية إدارة القوالب المطلوبة. | استخدمه فقط لغرض خدمة موثق ونطاق بيانات صغير مراجع.                            |

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

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

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

ابدأ بسياق JSON صغير أثناء التأليف:

```json theme={null}
{
  "$record": {
    "request_reference": "CSR-2026-00042",
    "resident_name": "رنا حداد",
    "service_name": "تأكيد إقامة"
  },
  "$organization": { "id": "org-example" },
  "$member": { "id": "member-example" }
}
```

السياق بيانات وليس تجاوزاً للصلاحيات. لا ينبغي أن يظهر في المخرج شيء لا يمكن كشفه بأمان للطالب لمجرد سهولة وضعه في مستند 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` محدودة ومصرحاً بها. تبقى قواعد الموضع والحدود والبروتوكولات والوصول الموضحة في [وسوم قوالب المستندات وعرضها](/ar/build/document-template-tags-and-rendering) ملزمة؛ ولا يستطيع طلب بلغة طبيعية تجاوزها.

كل توليد ناجح ينشئ مراجعة مؤقتة مرقمة، ويمكنك مراجعة ملخص التغيير والوسوم والمخرج، وطلب تعديل آخر، والعودة إلى مراجعة سابقة، وإعادة الضبط إلى المصدر الثابت، وتنزيل 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 عادية، وأبق جملة بشرية واضحة عندما تكون قيمة اختيارية فارغة. استخدم عبارة «تم الاستلام للمراجعة» بدلاً من «تمت الموافقة».

يمكن للنص الأساسي استخدام وسوم مضمنة بسيطة:

```text theme={null}
المرجع: {{ $record.request_reference }}
المقيم: {{ $record.resident_name }}
الخدمة: {{ $record.service_name }}
```

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

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

## الاختبار

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

| الاختبار       | الإعداد                                                                                   | النتيجة المتوقعة                                                                                                                                   |
| -------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| تحقق الرفع     | ارفع DOCX ذا وسوم متوازنة ثم ملفاً فيه وسم خاطئ عمداً                                     | يحصل الإصدار الصحيح على ملخص تحقق سليم وتبلغ صياغة الوسم المعروفة الخاطئة عن مشكلة. لا تستنتج من ملخص سليم أن موضع وسم التحكم في Word مستقل وصحيح. |
| وسم تحكم بنيوي | اعرض سجلاً يستخدم `if` أو `each` أو `else` أو تضميناً في موضع الفقرة أو صف الجدول المقصود | تعمل الكتلة المختارة أو الحلقة أو المتن المضمّن في الملف الناتج. قد يمر وسم تحكم مضمن في سطر واحد من تحقق الرفع، لذا يعد اختبار العرض إلزامياً.    |
| الإصدار الحالي | ارفع مراجعة معتمدة ثم أعد فتح القالب                                                      | يتغير مؤشر الإصدار الحالي. احتفظ بالمصدر المعتمد وسجل الإصدار لأن واجهة البناء الحالية لا تسرد الإصدارات الأقدم للمراجعة.                          |
| سياق السجل     | حمّل سجل كيان محفوظاً في عارض الاختبار                                                    | تظهر قيم `$record` بمفاتيحها المخزنة ولا تخترع بيانات علاقة مباشرة مفترضة.                                                                         |
| وصول الطالب    | اعرض بعضو ذي نطاق حالات محدود                                                             | تتبع عمليات البحث ووصول السجل صلاحيات ذلك العضو.                                                                                                   |
| إجراء المسؤول  | استخدم إجراء مسؤول مراجعاً ذا قائمة كيانات صغيرة                                          | يعمل غرض الخدمة المعتمد فقط ويرفض هدف بحث غير مدرج.                                                                                                |
| المخرج والاسم  | اعرض DOCX المسموح وPDF إذا كان مضبوطاً                                                    | يطابق الامتداد المخرج المختار ولا تمر محارف الاسم غير الآمنة.                                                                                      |
| مراجعة مرئية   | افتح الملف الناتج في عارض Word/PDF المدعوم لدى الجهة                                      | يصبح التخطيط والجداول وفواصل الصفحات واتجاه اللغة والصياغة مقبولاً.                                                                                |

اختبر قاعدة اسم الملف بسجل معروف قبل إضافة أجزاء اختيارية:

```jexl theme={null}
'service-request-' + $record.request_reference + '-' + dateFormat($now, 'YYYY-MM-DD')
```

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

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

| العرض                                 | افحص أولاً                                                                                                    | الاستجابة الآمنة                                                                                                       |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| يبلغ الرفع عن مشكلات تحقق             | هل حزمة DOCX غير آمنة، أو الوسم المعروف فارغاً أو خاطئاً أو غير متوازن، أو XML خاماً، أو `@html` أو `@chart`؟ | صحح مصدر DOCX وارفع إصداراً جديداً وتحقق منه ثانية. ثم اعرض كل وسم تحكم بنيوي؛ فتحقق الرفع وحده لا يثبت موضعه في Word. |
| يظهر حقل فارغاً                       | هل يحتوي السجل المحفوظ على المفتاح المخزن الدقيق وهل يكشفه السياق المختار؟                                    | ابدأ بوسم حقل واحد وافحص سياق الاختبار المحمّل.                                                                        |
| تظهر صياغة مستند خاطئة                | ما الإصدار الحالي، وما الملف المصدر أو سجل الإصدار المعتمد المستخدم؟                                          | أوقف الإجراء عند الحاجة وقارن تنزيل المصدر الحالي بالملف المعتمد المحتفظ به ثم أطلق تصحيحاً مختبراً.                   |
| يفشل PDF بينما ينجح DOCX              | هل يسمح الإجراء بـ PDF وهل خدمة التحويل متاحة؟                                                                | تحقق من سياسة المخرج وضبط التحويل قبل وعد المستفيدين بـ PDF.                                                           |
| اسم الملف غير متوقع                   | هل يعيد تعبير JEXL نصاً صالحاً؟                                                                               | اختبر مفتاحاً مخزناً بسيطاً ثم أضف التنسيق جزءاً جزءاً.                                                                |
| يرفض بحث بنمط مسؤول                   | هل مفتاح الكيان موجود في قائمة الكيانات المسموح بها؟                                                          | ضيق القائمة واعتمدها ولا تزل الضوابط لمجرد إنجاح العرض.                                                                |
| زر توليد AI غير متاح                  | هل اخترت كياناً صالحاً أو أدخلت كائن JSON صالحاً، وكتبت تعليمة، وأقررت الكشف؟                                 | أكمل العناصر الإلزامية. اختيار سجل ممثل اختياري ولا ينبغي أن يكون علاجاً لصلاحية مفقودة.                               |
| اقترح المساعد تغييراً أوسع من المطلوب | هل طلبت إعادة صياغة أو إعادة هيكلة صريحة، وهل الهدف محدد؟                                                     | لا تعتمد المسودة. أعد الضبط أو ارجع إلى مراجعة صالحة واطلب تغييراً محدوداً باسم الفقرة أو الصف أو الكتلة.              |
| يمنع الاعتماد رغم نجاح العرض          | هل توجد مشكلة تعيين قابلة للمراجعة أو ملتبسة، أو فشل PDF بلا إقرار DOCX فقط، أو بيانات وصفية ناقصة؟           | احسم كل تعيين، وراجع DOCX وأقر بالبديل عند الحاجة، ثم أكمل البيانات المعروضة. لا تتجاوز الحاجز بتوسيع الصلاحيات.       |
| انتهت الجلسة أو اختفت بعد الإهمال     | هل مر 24 ساعة بلا نشاط أو بلغ عمر المسودة سبعة أيام؟                                                          | ابدأ جلسة جديدة من المصدر المعتمد. لا تتوقع استعادة JSON أو التعليمات الحساسة من سجل التدقيق.                          |

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

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

نمط `caller` هو الخيار المعتاد للأقل صلاحية. ويمكن لنمط `admin` أن يقرأ على نطاق أوسع أثناء العرض، لذلك احمه بسبب عمل صريح وقائمة كيانات مسموح بها ومرشحات بحث ضيقة ومخرج مختبر ومراجعة وصول دورية. لا تضع رموز وصول أو كلمات مرور أو بيانات شخصية غير مراجعة أو ملاحظات داخلية سرية في القالب أو اسم الملف أو قيمة QR أو رابط الصورة.

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

## أدلة ذات صلة

* اكتب وسوماً مضمنة وحلقات وتضمينات آمنة في [وسوم قوالب المستندات وعرضها](/ar/build/document-template-tags-and-rendering).
* اختر حقولاً وتخطيطات مستقرة في [حقول الكيانات وتخطيطاتها](/ar/build/entity-fields-and-layouts).
* تعلّم الصياغة الكاملة والدوال في [صياغة لغة التعبيرات](/ar/reference/expressions/language-syntax).
* اضبط مراجع قابلة للتتبع للمستندات في [المعرّفات التسلسلية](/ar/build/serial-ids).