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

# قوالب جداول البيانات

> إنشاء قوالب XLSX مُدارة واختبارها وتشغيلها مع مخرجات XLSX أو PDF مضبوطة.

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

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

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

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

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

## الإعداد

### إنشاء القالب وإصداراته

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

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

![مساحة قوالب جداول البيانات المُدارة في KayanOS مع قوالب XLSX وإجراءات الإنشاء.](https://kayanos.app/docs-images/ar/build/spreadsheet-templates.png)

### المخرجات واسم الملف

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

يستخدم اسم الملف لغة JEXL المشتركة، ثم ينظف KayanOS المحارف غير الآمنة ويفرض الامتداد المطلوب:

```jexl theme={null}
'service-register-' + $record.reporting_month
```

إذا فشل التعبير، يستخدم النظام اسم الملف المرفوع. اعتبر ذلك مشكلة اختبار يجب إصلاحها.

### ربط الإجراءات والصلاحيات

يختار إجراء الكيان نوع XLSX بصورة صريحة، ويمكنه السماح بـ XLSX أو PDF أو كليهما. تستخدم إجراءات النماذج النوع المستقل `xlsx_template` ويمكنها إضافة سياق بيانات. لا تستبدل البيانات الإضافية الجذور المحمية للسجل والمؤسسة والعضو والوقت.

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

### مساعد الذكاء الاصطناعي

لا يعدّل المساعد الإصدار المُدار مباشرة. يبني خريطة محدودة للأوراق والنطاقات والخلايا والصيغ والأنماط، ويضع بصمة SHA-256 لكل خلية من دون إرسال XML الخام. يجب أن يحدد كل تعديل الورقة والعنوان والبصمة المتوقعة. إذا تغيّر المصنف بعد إنشاء الاقتراح، يرفض النظام التعديل القديم.

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

## مثال عملي

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

```jexl theme={null}
'inspection-register-' + $record.year + '-' + $record.region_code
```

يمكن لجزء ورقة العمل المتكرر استخدام صف فتح مخصص وصف جسم واحد وصف إغلاق مخصص:

```text theme={null}
A5: {{#each $record.inspections as inspection}}
A6: {{ inspection.reference }}   B6: {{ inspection.location }}
A7: {{/each}}
```

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

## الاختبار

اختبر حزمة آمنة وقِيماً رقمية ومنطقية ونصية، وحلقة رأسية بعدد صفر وواحد وعدة عناصر، وحلقة أفقية بعدة فترات، ومصفوفة متقاطعة. افتح XLSX للتحقق من الدمج وقواعد التحقق والجداول والمخططات، وراجع PDF بصرياً. اختبر صلاحيات `caller` وحالة `admin` المعتمدة، وتأكد من رفض بصمة AI القديمة ومن عدم إنشاء إصدار ثان عند تكرار مفتاح الاعتماد.

```json theme={null}
{ "$record": { "year": 2026, "region_code": "N-4", "months": [] } }
```

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

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

```text theme={null}
{{#eachCol $record.months as month}}
{{/eachCol}}
```

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

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

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

* اكتب الحلقات والشروط في [وسوم قوالب جداول البيانات والعرض](/ar/build/spreadsheet-template-tags-and-rendering).
* صمم الحقول في [الكيانات](/ar/build/entities).
* تعلّم التعبيرات في [صياغة لغة التعبيرات](/ar/reference/expressions/language-syntax).
* قارن المخرجات النصية في [قوالب المستندات](/ar/build/document-templates).