وسوم قوالب جداول البيانات والعرض

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

إعدادات قالب XLSX ومساعد الذكاء الاصطناعي في KayanOS لوسوم جدول البيانات وإنشائه وإخراج PDF.

متى تستخدمه

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

الإعداد

القيم وأنواع الخلايا

الوسم العادي هو {{ expression }}. إذا كان المحتوى الوحيد في الخلية، يحفظ النظام النتيجة كرقم أو قيمة منطقية أو فراغ أو نص. وإذا جاور نصاً آخر تصبح النتيجة الكاملة نصاً.

{{ $record.total }}
المرجع: {{ $record.reference }}
{{ $record.approved }}

تبقى القيم النصية التي تبدأ بـ = أو + أو - أو @ نصاً، فلا تتحول بيانات السجل إلى صيغة. يحافظ النظام على الصيغ الأصلية ويحترم المراجع النسبية والمطلقة والمختلطة.

حلقات الصفوف والشروط

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

A2: {{#each $record.lines as line}}
A3: {{ line.description }}   B3: {{ line.amount }}
A4: {{/each}}

تستخدم الشروط #if وelse و/if في صفوف مستقلة. يزيل الكاتب صفوف العلامات ويكرر أو يختار صفوف الجسم. يسمح بالتداخل الكامل، ويرفض التداخل الجزئي بين نطاقين في الاتجاه نفسه.

الحلقات الأفقية

استخدم eachCol للتكرار عبر الأعمدة. يجب أن يكون عمود الفتح وعمود الإغلاق مخصصين للعلامات من دون عناوين أو صيغ أو قيم مخفية أخرى.

B1: {{#eachCol $record.months as month}}
C2: {{ month.label }}
C3: {{ month.amount }}
D1: {{/eachCol}}

تستخدم الأعمدة الشرطية #ifCol وelseCol و/ifCol. يوضع عمود الجسم العادي بين علامتي الفتح والإغلاق.

المصفوفة الديكارتية

يمكن أن تتقاطع حلقة صفوف مع حلقة أعمدة. إذا تكررت الإدارات في الصفوف والأشهر في الأعمدة، ينشئ KayanOS خلية لكل إدارة × شهر، ويجعل الاسمين متاحين داخل خلية التقاطع.

{{ department.values[month.key] }}

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

الإخفاء والروابط والصور وQR

يخفي {{@hideRow expression}} صفاً ويخفي {{@hideColumn expression}} عموداً. ينشئ @link رابطاً آمناً، ويدرج @image صورة محدودة، وينشئ @qr صورة QR. يجب أن تشغل التوجيهات الغنية خلية كاملة. يرفض النظام مخططات الروابط النشطة والصور الكبيرة أو غير المدعومة، وينقل نقاط تثبيت الرسومات مع الصفوف والأعمدة الموسعة.

{{@link $record.public_url $record.public_label}}
{{@image $record.logo width=120}}
{{@qr $record.reference width=96}}

لا تضع سراً في QR ولا بيانات اعتماد داخل رابط صورة.

الصيغ والنطاقات والحفظ

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

=B4*C4
=$B4*C$4
=SUM(B4:D4)

افتح الملف في العارض المعتمد وتأكد من النتيجة. قد تختلف الخطوط والمخططات والحساب بين عارض سطح المكتب ومحّول PDF.

الطباعة وPDF والسياق

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

مثال عملي

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

الاختبار

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

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

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

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

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

أدلة ذات صلة

أدر الإصدارات والإجراءات في قوالب جداول البيانات.
تعلّم التعبيرات في صياغة لغة التعبيرات.
صمم السجلات في الكيانات.
راجع منطق الإجراءات في إجراءات النماذج والمنطق والتوقيعات.

​متى تستخدمه

​الإعداد

​القيم وأنواع الخلايا

​حلقات الصفوف والشروط

​الحلقات الأفقية

​المصفوفة الديكارتية

​الإخفاء والروابط والصور وQR

​الصيغ والنطاقات والحفظ

​الطباعة وPDF والسياق

​مثال عملي

​الاختبار

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

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

​أدلة ذات صلة