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

# مهام التصدير

> إنشاء صادرات بيانات المؤسسة ومراقبتها وتنزيلها وإتلافها مع غرض واضح وحدود زمنية وتمثيل قيم وضوابط للملفات المؤقتة.

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

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

## الهدف

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

## الوصول وحد التصدير

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

قبل أي تصدير، ينبغي للمالك تأكيد الآتي:

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

يحفظ التصدير بيانات المؤسسة خارج التطبيق الحي. عامل الأرشيف وكل جدول داخله بضوابط الوصول والاحتفاظ نفسها أو أشد من السجلات المصدرية.

## ما الذي تحتويه مهمة التصدير

تختار نافذة التصدير كيانات لا حقولاً فردية. ولكل كيان مختار تنشئ المهمة جدول بيانات داخل أرشيف ZIP. يتضمن الجدول حقول الكيان غير المتقادمة وأعمدة النظام **ID** و**Label** و**Created** و**Updated**. راجع تصميم الكيان وتصنيف بياناته قبل إنشاء المهمة؛ ولا تفترض أنه يمكن استبعاد حقل حساس منفرد من هذا المسار.

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

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

## قبل إنشاء مهمة

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

## إنشاء تصدير مضبوط لطلب خدمة مواطن

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

1. افتح **الإدارة ← مهام التصدير** واختر **مهمة تصدير جديدة**.
2. اختر **طلب خدمة مواطن** فقط. لا تضف الفحوصات أو الأعضاء أو المستندات أو كيانات خدمة غير مرتبطة ما لم يتطلبها الغرض المعتمد.
3. اختر **محدّث** كأساس التاريخ، وأدخل تاريخي من وإلى المعتمدين للأسبوع الأول مع تسجيل المنطقة الزمنية الافتراضية للمؤسسة في طلب التغيير.
4. اختر القيم **المقروءة**. تعرض هذه الحالة خيارات الحالة والعلاقات بصيغة يفهمها مراجعو الخدمة.
5. أنشئ المهمة وسجل غرضها ووقت المهمة في سجل التغيير. الإنشاء يضع العمل في طابور؛ ولا ينشئ أرشيفاً قابلاً للتنزيل فوراً.
6. ما دامت الحالة معلقة أو قيد المعالجة، راقب جدول المهام. تحدّث الصفحة المهام الجارية تلقائياً كل عشر ثوان؛ واستخدم **تحديث** عند التحقيق في نتيجة.
7. عندما تصبح الحالة مكتملة، طابق الكيانات الظاهرة وعدد الصفوف وحجم الملف والانتهاء مع الطلب الأصلي. العدد الصفري أو الكبير على نحو غير متوقع سبب للتوقف والتحقيق قبل التنزيل.
8. نزّل الأرشيف إلى المكان المعتمد فقط. افتح الجدول في بيئة مضبوطة وتحقق من أعمدته وعدد قليل من الصفوف الاصطناعية أو المصرح بها.
9. شارك فقط عبر قناة المستلم المعتمدة، وسجل التسليم عند الحاجة، واحذف النسخ المحلية والأرشيف في تاريخ الحذف المعتمد.

النتيجة المتوقعة: أرشيف ZIP واحد يحوي جدولاً للكيان المختار، وفق أساس التاريخ وتمثيل القيم المعتمدين. لا تنشر المهمة سجلات ولا تغيرها ولا تمنح مستلمها حق وصول إلى KayanOS.

## حالات المهمة والتنزيل والاحتفاظ

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

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

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

## أمثلة على القيم المقروءة والخام

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

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

## تحقق آمن

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

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

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

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

* صمم حقول الكيانات وصنفها قبل تصديرها في [حقول الكيان والتخطيطات](/ar/build/entity-fields-and-layouts).
* احم سلطة التصدير عبر [إعدادات المؤسسة](/ar/admin/organization-settings) و[الأدوار والنطاقات](/ar/admin/roles-and-scopes).
* أنشئ تحليلاً تشغيلياً أكثر أماناً باستخدام [لوحات البيانات](/ar/build/dashboards).
* راجع حدود الوصول في [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability).

![حالة مهمة تصدير في KayanOS لمديرية خدمات المواطنين.](https://kayanos.app/docs-images/ar/admin/export-jobs.png)