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

# النماذج دون اتصال

> صمم نموذج عمل ميداني مقيداً يخزن العمل والملفات محلياً ثم يزامن إرسالة قابلة للتدقيق عند عودة الاتصال.

## عدم الاتصال نوع نموذج مقصود

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

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

![نموذج KayanOS دون اتصال لمعاينة ميدانية.](https://kayanos.app/docs-images/ar/build/offline-forms.png)

## قرر هل النموذج مناسب

اختر نموذجاً غير متصل فقط بعد الإجابة عن الأسئلة التالية:

| السؤال                                                     | إجابة آمنة لعدم الاتصال                                               | اختر نموذجاً عادياً عندما…                                                            |
| ---------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| هل يستطيع العامل إكمال الحقول بلا بيانات حية؟              | نعم—تكفي التسميات والقيم المحلية والخيارات الثابتة والحسابات الحتمية. | يحتاج العامل إلى استعلام كيان متغير أو جلسة مختارة أو مصدر خيارات حي أو نتيجة صلاحية. |
| هل يستطيع سير العمل استخدام مسار الإرسال/المزامنة القياسي؟ | نعم—يمكن مراجعة الإرسالة بعد وصولها إلى KayanOS.                      | يجب عليه استدعاء إجراء مخصص أو سير عمل متصل آخر لحظة الإرسال.                         |
| هل الجمهور عضو ميداني مخول؟                                | نعم—تجهز الحزمة لعمل ميداني مضبوط.                                    | النموذج قناة إدخال عامة أو يحتاج URL عاماً/معبأ مسبقاً.                               |
| هل يستطيع الجهاز حفظ العمل بأمان؟                          | نعم—للمؤسسة إجراءات جهاز وتخزين وفقد/إرجاع.                           | لا يجوز أن تقيم البيانات محلياً أو يلزم ظهور مركزي فوري.                              |

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

## ما الذي يخزنه KayanOS محلياً

يحتفظ مخزن عدم الاتصال المحلي على الجهاز بأربعة أنواع مترابطة من البيانات:

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

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

## حالات المزامنة: معناها الفعلي

تنتقل كل جلسة وعنصر طابور غير متصل عبر الحالات التالية:

| الحالة    | المعنى                                                                        | ما الذي ينبغي أن يفعله العامل أو المنسق                                              |
| --------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `pending` | تنتظر جلسة محلية مسلمة محاولة مزامنة مستحقة.                                  | أبق الجهاز متاحاً وأكد الاتصال ولا تعِد الإرسال كطلب جديد.                           |
| `syncing` | يرفع KayanOS الملفات ويبدأ/يثبت جلسة الخادم.                                  | أبق التطبيق/الجهاز متصلاً وتجنب حذف الملفات أو إغلاق الدليل دون توقع.                |
| `failed`  | فشلت المحاولة الأخيرة؛ يسجل الطابور خطأ ووقت إعادة تالٍ.                      | اقرأ الخطأ وأعد الاتصال/التوثيق/التخزين حسب الحاجة وانتظر/فعّل مسار الإعادة المعتمد. |
| `synced`  | أُنشئت/ثُبتت جلسة الخادم وتسجل الجلسة المحلية معرف جلسة الخادم ووقت الاستلام. | تحقق من الجلسة المستلمة والملفات اللازمة في KayanOS قبل إغلاق مهمة العمل الميداني.   |

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

## ابنِ نموذج معاينة غير متصل

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

1. أنشئ نموذج **غير متصل** لفريق المعاينات الميدانية وأنت متصل.
2. أضف حقولاً ملائمة محلياً فقط: مرجع الطلب وعنوان الموقع وتاريخ/وقت المعاينة وحالة السلامة وقسم ملاحظات متكرر وملاحظة وحقل ملف للصور.
3. اضبط خيارات اختيار ثابتة مثل `safe` و`unsafe` و`follow_up_required`. لا تستخدم مصدر خيارات مدعوماً بكيان لقائمة يجب أن تعمل بلا خادم.
4. امنح قسم الملاحظات حدوداً دنيا/قصوى معقولة واختبر صفاً واحداً وصفوفاً عدة وصفاً اختيارياً فارغاً وصفاً غير آمن يتطلب ملاحظة.
5. أضف تعبيرات محلية حتمية فقط، مثل:

```jexl theme={null}
$.safety_status.value == "unsafe" && isNotEmpty($.site_address.value)
```

6. احفظ وتحقق من بنية عدم الاتصال. عالج كل تحذير قدرة غير متصلة قبل توزيع الحزمة.
7. نزّل/جهز الإصدار المختبر على جهاز مضبوط، وسجل إصدار النموذج ومالك العمل الميداني في خطة الزيارة.

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

## قدرات محجوبة عمداً دون اتصال

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

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

قد يرفض مدقق عدم الاتصال تعبيرات يقترحها المحرر العام. عامل هذا الرفض كعقد نوع النموذج؛ لا تلتف عليه بتعبير آخر على العميل.

## سير العمل الميداني: من الجهاز إلى جلسة مستلمة

### قبل المغادرة

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

### في الميدان

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

### عند عودة الاتصال

1. صل الجهاز وأبق التطبيق/الجلسة متاحين.
2. راقب انتقال الحالة من `pending` إلى `syncing` ثم `synced`، أو التقط خطأ `failed` ووقت الإعادة.
3. يرفع العميل كل ملف محلي معلق ويستبدل مرجعه المحلي في الحالة المحفوظة ويبدأ جلسة الخادم ويثبت الحالة.
4. افتح إرسالة النموذج على الخادم باستخدام الجلسة/المرجع الناتج وأكد صفوف الملاحظات ومرفقات الملفات والطوابع والحقول المطلوبة.
5. عندئذ فقط دع وحدة القرارات والسجلات تستخدم الدليل المتزامن في مراجعة أو قرار حالة.

## مصفوفة الاختبار

| الاختبار           | النتيجة المتوقعة                                                                  |
| ------------------ | --------------------------------------------------------------------------------- |
| إصدار الحزمة       | يفتح النموذج/الإصدار غير المتصل المقصود على الجهاز المضبوط.                       |
| استعادة المسودة    | تنجو مسودة محلية محفوظة من إعادة تشغيل التطبيق بلا تحول إلى إرسالة خادم مكررة.    |
| المعاينة المتكررة  | تحتفظ صفوف ملاحظات واحدة وعدة وعند الحدود بقيم الحقول المحلية.                    |
| الملف المحلي       | تبقى الصورة/الملف غير الحساس مرتبطاً بالحقل الصحيح ويرفع عند المزامنة.            |
| غياب الاتصال       | تبقى الجلسة المسلمة `pending` ولا تدعي أنها مستلمة مركزياً.                       |
| مزامنة متقطعة      | يسجل الفشل `failed` ونص الخطأ والمحاولات ووقت إعادة مستقبلي ولا يهمل الجلسة بصمت. |
| مزامنة بعد الاتصال | تصبح الجلسة المستحقة `synced` ولها معرف جلسة خادم/وقت استلام.                     |
| تحقق الخادم        | يرى المنسق الحالة المحفوظة والملفات المرفوعة المتوقعة في الجلسة المتزامنة.        |
| قدرة مقيدة         | يرفض منشئ/مدقق عدم الاتصال الميزة المحجوبة المتصلة فقط.                           |

## تعاف بأمان من مزامنة فاشلة

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

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

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

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

* [النماذج والحقول والقوائم المتكررة](/ar/build/form-fields-and-repeatables)
* [إرسالات النماذج](/ar/build/form-submissions)
* [سياق منشئ النماذج](/ar/reference/forms/form-builder-context)
* [تعبيرات النماذج وعمليات البحث](/ar/reference/expressions/forms-and-lookups)
* [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability)
* [استكشاف الأخطاء وإصلاحها](/ar/reference/troubleshooting)