انتقل إلى المحتوى الرئيسي

القوالب

تتيح القوالب إمكانية تصدير بيانات الكيانات بأشكال مختلفة، مثل HTML أو Word أو Excel. فيما يلي توثيق مبسط حول كيفية بناء هذه القوالب، مع فصلٍ أوضح للمواضيع والخطوات.

بناء القوالب​

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

1. قالب HTML​

الصيغة العامة​

<<!DOCTYPE html>
<html>
<head>
    <title>HTML Template</title>
</head>
<body lang="en-US" dir="ltr">

    {{% for(entry of entries){ %}}
        <!-- استخدم entry.value.FIELD_NAME هنا -->
        {{%=entry.value.FIELD_NAME %}}
    {{% }; %}}

</body>
</html>>

المثال التطبيقي​

<<!DOCTYPE html>
<html>
<head>
    <title>HTML Template Example</title>
</head>
<body lang="en-US" dir="ltr">

    {{% for(entry of entries){ %}}
        <h1>Title</h1>
        <p>{{%=entry.value.title %}}</p>
    {{% }; %}}

</body>
</html>>
  • في المثال، تم استخدام الحقل title لعرض العنوان.

2. قالب Word​

الصيغة العامة​

<{{ALIAS FIELD_ALIAS INS $entry.value.FIELD_NAME}}>

<{{FOR entry in entries}}
{{* FIELD_ALIAS}}
{{END-FOR entry}}>
  • FIELD_ALIAS: الاسم الذي ستستخدمه لاحقًا في حقل التكرار.
  • FIELD_NAME: المعرف الخاص بالحقل داخل الكيان (مثل title).

المثال التطبيقي​

<{{ALIAS title INS $entry.value.title}}>

<{{FOR entry in entries}}
{{* title}}
{{END-FOR entry}}>
  • هنا تم تعريف متغير يحمل قيمة الحقل title، ثم تم استخدامه داخل حلقة التكرار لعرض جميع القيم.

3. قالب Excel​

الصيغة العامة​

<${table:entries.value.FIELD_NAME}>
  • FIELD_NAME: المعرف الخاص بالحقل (مثل title).

المثال التطبيقي​

<${table:entries.value.title}>
  • يتم إنشاء جدول في ملف Excel يحتوي على جميع قيم حقل title للسجلات الموجودة.

ملاحظات عامة​

  1. FIELD_NAME في الأمثلة يشير إلى اسم الحقل أو المعرف الخاص به (مثل title).
  2. يجب التأكد من تطابق أسماء الحقول (أو معرفاتها) بين الكيان والتعبيرات داخل القالب.
  3. يتم تنفيذ هذه القوالب في النظام أو الأداة التي تدعم هذه الصيغ، وبعد التصدير سيتم استبدال التعبيرات بالقيم الفعلية للحقول.

إضافة القالب​

بعد الانتهاء من إنشاء القالب (HTML، Word، أو Excel) وتجهيزه للاستخدام، يمكن إضافته إلى الكيان باتباع الخطوات التالية:

  1. الانتقال إلى الكيان
    انتقل إلى صفحة الكيان المعني في النظام.

  2. فتح قسم القوالب
    من صفحة الكيان، اختر تبويب أو قسم "القوالب".

  3. إضافة قالب جديد

    • انقر على أيقونة الإضافة "+".
    • ستظهر نافذة تطلب تعبئة بعض المعلومات:

    1. الاسم
      أدخل اسمًا واضحًا يُعبِّر عن القالب.

    2. المستوى
      اختر ما إذا كان القالب مخصصًا لتصدير:

      • مدخل واحد: لتصدير سجل واحد فقط.
      • متعدد: لتصدير عدّة سجلات في وقت واحد.

    3. النوع
      حدد نوع الملف الذي ترغب في تصديره:

      • Excel
      • PDF
      • Word

      ملاحظة:

      • عند اختيار نوع الملف Excel، يجب تحميل القالب من ملف Excel قمت ببنائه مسبقًا.
      • عند اختيار PDF أو Word، يجب رفع ملف بصيغة HTML (للـPDF) أو Docs (للـWord).

    4. تحميل الملف
      اختر ملف القالب الذي قمت ببنائه مسبقًا.

    5. نوع التصدير

      • تصدير خلفي: يتم التصدير في الخلفية، مع إرسال إشعار عند انتهاء العملية.
      • تصدير واجهة: يتم التصدير فور الضغط على زر التصدير.

    6. إعدادات متقدمة
      يمكنك ضبط أي إعدادات إضافية خاصة بنوع القالب أو بطريقة معالجة البيانات.

  4. حفظ التعديلات
    انقر على "حفظ" أو الزر المناسب لتأكيد إضافة القالب وربطه بالكيان.

باتباع هذه الخطوات، يصبح قالبك الجديد متاحًا للاستخدام عند الحاجة لتصدير بيانات الكيان.