> ## 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.

# إجراءات النماذج ومنطقها وتواقيعها

> توجيه جلسة نموذج متحقق منها إلى خطوة لاحقة مضبوطة، وضبط دليل توقيع واضح الجاهزية والنطاق وقواعد الموقّعين.

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

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

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

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

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

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

## الإعداد

### ضبط إجراء حول نتيجة واحدة

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

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

#### بدء نموذج

استخدم هذا الإجراء لتسليم جلسة مؤهلة إلى نموذج متابعة منشور. يملك النموذج الهدف قراره الخاص بالتحقق والوصول؛ فتمرير متغير راحة للمستخدم لا منح صلاحية.

![إعداد إجراء بدء نموذج في KayanOS ضمن منشئ استقبال طلب خدمات المواطنين.](https://kayanos.app/docs-images/ar/build/form-actions/initiate-form-settings.png)

#### تغيير القيم

استخدمه لتحديث ضيق قابل للمراجعة، مثل تعليم المعاينة بأنها جاهزة بعد صلاحية الوقائع اللازمة. سمِّ الإجراء بالنتيجة العملية واختبر القيم الدقيقة قبل التنفيذ وبعده.

![إعداد إجراء تغيير القيم في KayanOS ضمن منشئ استقبال طلب خدمات المواطنين.](https://kayanos.app/docs-images/ar/build/form-actions/change-values-settings.png)

#### فتح رابط

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

![إعداد إجراء فتح رابط في KayanOS ضمن منشئ استقبال طلب خدمات المواطنين.](https://kayanos.app/docs-images/ar/build/form-actions/open-link-settings.png)

#### تنزيل قالب مستند

استخدمه بعد ضبط قالب مستند جلسة النموذج واعتماده. تحقق من ربط القالب ونمط التنفيذ وتعبير اسم الملف وتنسيقات المخرج المسموحة بجلسة آمنة نموذجية.

![إعداد إجراء قالب مستند في KayanOS ضمن منشئ استقبال طلب خدمات المواطنين.](https://kayanos.app/docs-images/ar/build/form-actions/docx-template-settings.png)

#### تصدير PDF

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

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

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

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

#### ضبط المظهر الرسمي لملف PDF

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

تحفظ هذه الإعدادات مع إصدار النموذج. تستخدم إصدارات النماذج التي لا تملك إعداداً محفوظاً القالب الرسمي بالإعدادين الافتراضيين «مضغوط» و«تلقائي». وتتضمن لقطة التوقيع المحضّرة إعداد PDF المطبع ضمن دليلها غير القابل للتعديل، لذلك لا تعيد تغييرات المنشئ اللاحقة تنسيق ذلك المستند المحضّر. لا تحفظ إصداراً معدلاً وتطلقه قبل تصدير جلسات تمثيلية باتجاهي LTR وRTL تتضمن جدولاً عريضاً. تعتمد الهوية والعلامة المائية على شعار مؤسسة صالح؛ ويمكن حذف زخرفة اختيارية عند تعذر مصدرها، لكن يجب معاملة فشل عرض العربية كفشل في التصدير.

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

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

للإجراءات أيضاً شرطان هما **ظاهر** و**قابل للنقر**. يحدد الظهور ما إذا كان الإجراء يعرض، ويحدد قابل النقر ما إذا كان يمكن استعماله بعد ظهوره. اجعل الرسالتين متسقتين. مثلاً، اعرض «بدء معاينة» فقط عندما تكون المعاينة مطلوبة، واجعله قابلاً للنقر فقط بعد اكتمال التفاصيل التمهيدية. يفترض شرط الظهور الآتي للتوضيح أن قيمة `site_service` هي القيمة المخزنة الفعلية:

```jexl theme={null}
$.request_type.value == 'site_service'
```

ولشرط قابلية النقر استخدم قيمة منطقية ثابتة يلتقطها النموذج أو يشتقها فعلاً. يفترض المثال أن `inspection_ready` مفتاح فعلي:

```jexl theme={null}
$.inspection_ready.value == true
```

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

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

```jexl theme={null}
$.guidance_url.value
```

لا تستخدم إجراءات النموذج لتحويل النموذج إلى متاهة تنقل. يجب أن تعرض الشاشة الخطوات التالية التي يفهمها المستخدم ويسمح له بأدائها فقط. واستخدم إجراء قالب المستند بعد مراجعة حقول القالب وتنسيقات المخرج المسموحة وسياسة الوصول الخاصة به في [قوالب المستندات](/ar/build/document-templates).

### ضبط طلبات الموافقة والدليل لكل إجراء

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

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

ابدأ بمجموعة صغيرة. مثال شائع هو **موافقة** بنتيجة `approved` وتقدم `continue` وتوقيع مطلوب، و**طلب تغييرات** بنتيجة `needs_changes` وتقدم `complete` وتعليق مطلوب من دون توقيع.

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

عندما يعدل المنشئ بيانات نموذج مؤثرة في الموافقة، يحل النظام الجولة النشطة محل جولة قديمة. تبقى الاستجابات السابقة مرتبطة بلقطتها الثابتة ولا تحذف. بعد التصحيح يختار المنشئ صراحة **إعادة الإرسال للموافقة**. يرفض النظام الإرسال إن لم توجد تغييرات مؤثرة؛ أما الإرسال الصحيح فينشئ الجولة N+1 ويربطها بالجولة السابقة ويبني ملخص التغييرات ويعيد حل المراجعين ويبدأ من المرحلة الأولى.

### اضبط كتلة الموافقة ودليل التوقيع

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

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

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

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

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

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

يجب أن يصبح تعبير الجاهزية صحيحاً قبل أن يستطيع عضو المؤسسة تحضير الطلب. قد يكون شرط الجاهزية التالي للتوضيح مناسباً إذا كان `review_complete` مفتاحاً فعلياً:

```jexl theme={null}
$.review_complete.value == true
```

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

مثلاً يمكن إدراج موقّع مالي لاحق فقط عندما تساوي قيمة حقل الكمية الرقمية المخزنة `25` تماماً:

```jexl theme={null}
$.amount.value == 25
```

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

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

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

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

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

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

## مثال عملي

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

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

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

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

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

![ إعدادات منطق نموذج KayanOS والتوقيع لطلب خدمة مواطن في مديرية خدمات عامة سورية. ](https://kayanos.app/docs-images/ar/build/form-actions-logic-and-signatures.png)

## الاختبار

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

| الاختبار             | الإعداد                                                                                                                        | النتيجة المتوقعة                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ظهور الإجراء         | نفذ جانبي كل تعبير ظهور                                                                                                        | يظهر الإجراء فقط حيث تقول سياسة الخدمة إنه ذو صلة.                                                                                                                     |
| قابلية نقر الإجراء   | اترك حقلاً صالحاً مختاراً غير صالح ثم اجعله صالحاً                                                                             | يحجب الإجراء قبل صلاحية المتطلبات ويصبح قابلاً للاستعمال بعدها.                                                                                                        |
| بدء نموذج            | ابدأ نموذج الهدف من الإجراء                                                                                                    | يفتح النموذج المنشور المقصود مع القيم الافتراضية المعتمدة فقط.                                                                                                         |
| تغيير القيم          | نفذ الإجراء في جلسة اختبار                                                                                                     | تتغير القيم المضبوطة ولا تتغير الحقول غير المرتبطة.                                                                                                                    |
| فتح الرابط           | اختبر الوضع الثابت ووضع التعبير إذا كانا مضبوطين                                                                               | تكون الوجهة المحلولة معتمدة ولا تحوي قيمة خاصة غير مقصودة.                                                                                                             |
| تنزيل المستند        | نفذه بعد جلسة اختبار محفوظة                                                                                                    | ينشأ المخرج المسموح من القالب وسياق الجلسة المقصودين.                                                                                                                  |
| تصدير PDF            | نفذ إجراءً للنموذج الكامل وآخر بنطاق مقيّد من جلستي اختبار باتجاهي LTR وRTL مع حقل حساس مستبعد وعناصر مخفية ومحتوى متكرر/جدولي | تحفظ الجلسة، ولا يظهر إلا المحتوى المرئي داخل النطاق، ويبقى المستبعد غائباً والتخطيط والاتجاه مقروءين، وينزّل المتصفح ملف PDF المتوقع.                                 |
| جاهزية التوقيع       | حاول التحضير قبل وبعد صحة تعبير الجاهزية                                                                                       | يرفض التحضير قبل الجاهزية ويتاح بعدها.                                                                                                                                 |
| ظهور التحضير         | قيّم تعبير ظهور التحضير بقيمتي خطأ وصحيح للبادئ                                                                                | تختفي ضوابط التحضير وإعادة الإرسال/إعادة التحضير ويرفض الخادم طلب العضو المباشر عند الخطأ، بينما تبقى ضوابط المراجع والموقّع متاحة للمؤهلين.                           |
| قاعدة الموقّع        | اختبر كل موقّع أو سعة مؤهلة وغير مؤهلة                                                                                         | يتاح مسار القرار المضبوط للموقّع المؤهل فقط.                                                                                                                           |
| قاعدة موقّع مشروطة   | حضّر جلسة نموذج تكون فيها نتيجة `$.amount.value == 25` خاطئة وأخرى تكون فيها صحيحة                                             | عند النتيجة الخاطئة تغيب القاعدة المالية عن الطلب وواجهة التوقيع والإشعارات والتذكيرات وحساب الاكتمال؛ وعند النتيجة الصحيحة تدرج وتتبع مسار المتطلبات السابقة المضبوط. |
| مخطط الموافقة الزمني | أكمل مرحلة بتوقيع وارفض جولة اختبار أخرى، ثم أعد فتح الجلستين المحفوظتين كمشاهد مخول                                           | يحفظ المخطط ترتيب المراحل وصاحب الاستجابة ووقتها وتعليقها ودليل بطاقة التوقيع الموثّق؛ وتظهر المراحل بعد الرفض بالحالة «لا ينطبق» من دون إتاحة ضابط استجابة.           |
| تغير النطاق          | حضر أو رد ثم غيّر بيانات ضمن النطاق                                                                                            | يحدث التحديث أو البقاء أو الإحلال تماماً كما يتطلب إعداد الإبطال وحالة الرد.                                                                                           |

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

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

| العرض                                            | افحص أولاً                                                                                                                                     | الاستجابة الآمنة                                                                                                                                                                      |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| الإجراء ظاهر لكن لا ينفذ                         | هل كل الحقول والأقسام الصالحة المختارة صالحة، وهل شرط قابلية النقر صحيح؟                                                                       | افحص البوابة المختارة وصحح الإدخال المفقود أو غير الصالح، ولا تزل بوابة بلا مراجعة مالك الخدمة.                                                                                       |
| لا يملك إجراء بدء النموذج هدفاً قابلاً للاستخدام | هل نموذج الهدف منشور ومختار؟                                                                                                                   | انشر نموذج الهدف واختبره أولاً، ثم اضبط متغيراته المعتمدة فقط.                                                                                                                        |
| يرفض إجراء الرابط أو يحل خطأ                     | هل الرابط الثابت معتمد، أو هل يعيد التعبير الرابط المقصود لكل مسار؟                                                                            | استخدم رابطاً ثابتاً مراجعاً حيث يمكن، وبسّط التعبير وأعد اختباره.                                                                                                                    |
| تنزيل المستند غير مكتمل                          | هل حفظت الجلسة وهل أعد القالب لسياق جلسة النموذج والمخرج المسموح؟                                                                              | تحقق من إعداد القالب وبيانات الجلسة قبل تغيير الإجراء.                                                                                                                                |
| يفتقد تصدير PDF محتوى أو يفشل تنزيله             | هل يقع العنصر ضمن نطاق محتوى PDF لهذا الإجراء وهل هو ظاهر للعضو الحالي، وهل حفظت الجلسة، وهل يستطيع المتصفح عرض الخطوط/الصور والسماح بالتنزيل؟ | صحح نطاق الإجراء أو مشكلة الجلسة/الوصول أو المتصفح وأعد المحاولة ببيانات معتمدة. إذا حذفت كل أهداف النطاق المحفوظ، فاختر نطاقاً جديداً عمداً بدلاً من توقع العودة إلى النموذج الكامل. |
| اتجاه PDF أو ألوانه أو زخارفه غير متوقعة         | أي إصدار نموذج أنشأ المستند، وهل الاتجاه تلقائي أم مفروض، وهل يتاح شعار المؤسسة والتذييل المترجم؟                                              | صحح إعدادات إصدار النموذج الحالي واختبرها؛ ولا تعِد بناء دليل الموافقة غير القابل للتعديل أو تغير مظهره.                                                                              |
| لا يعرض محرر إجراءات الموافقة حقل مفتاح النتيجة  | هل أضيفت الاستجابة من الإعداد المسبق المقصود أم كإجراء مخصص، وهل تقدمها صحيح؟                                                                  | راجع مفتاح الإجراء الثابت الظاهر وسلوكه؛ يحتفظ KayanOS بمعرّف النتيجة المعيّن كبيانات تدقيق.                                                                                          |
| لا يمكن تحضير توقيع                              | هل يظهر التحضير، وهل تعبير الجاهزية صحيح، وهل يوجد نطاق موقع، وهل المحضر عضو مؤسسة؟                                                            | عالج شرط الظهور أو الجاهزية أو النطاق أو العضوية، ولا تتجاوز فحوص الخادم واللقطة.                                                                                                     |
| لا يستطيع أي موقّع الرد                          | هل يحل تعبير المحدد العضو أو المنصب المقصود، وهل تتوافق السعة والقرارات؟                                                                       | اختبر المحدد ببيانات آمنة وصحح القاعدة بدلاً من التعيين الالتفافي.                                                                                                                    |
| تقول مرحلة موافقة لاحقة «لا ينطبق»               | هل رفضت مرحلة سابقة وأنهت الجولة؟                                                                                                              | افتح الرفض المسجل وراجع تعليقه ودليله. صحح وأعد الإرسال صراحة عبر مسار المالك المضبوط فقط؛ ولا تعامل المرحلة اللاحقة كموافقة.                                                         |
| أصبح رد سابق قديماً                              | هل تغير محتوى ضمن النطاق بعد تحضير الطلب أو الرد؟                                                                                              | راجع المراجعة الحالية ونتيجة الإبطال المضبوطة، وحضر طلباً جديداً عندما تتطلب السياسة ذلك.                                                                                             |

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

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

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

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

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

* خطط مسارات النشر العام والموظفين في [النماذج](/ar/build/forms).
* اضبط شروط الحقول والتحقق والصفوف المتكررة في [حقول النماذج والعناصر المتكررة](/ar/build/form-fields-and-repeatables).
* اضبط محتوى المخرج وقواعد الوصول في [قوالب المستندات](/ar/build/document-templates).
* تعلّم اللغة المستخدمة في شروط الإجراءات والتوقيعات في [صياغة لغة التعبيرات](/ar/reference/expressions/language-syntax).