لعرض البيانات من docu tools في تقرير pdf أو excel، نستخدم العناصر النائبة. هذه العناصر النائبة تعمل كعلامات داخل القالب الخاص بك وتشير إلى المكان الذي يجب إدراج البيانات من docu tools. يمكنك، على سبيل المثال، إنشاء عنصر نائب مثل {{project-name}} في القالب، والذي سيتم ملؤه ديناميكيًا بالاسم الفعلي للمشروع في docu tools عند توليد التقرير.
هناك مجموعات مختلفة من العناصر النائبة لـ Excel و Word، حيث أن بعضها متوفر فقط في أحدهما أو الآخر. من خلال استخدام هذه العناصر النائبة بفعالية، يمكنك إنشاء قوالب ديناميكية ومرنة تعرض البيانات من مشاريعك وتقاريرك ومهامك بدقة.
بناء جملة وتصميم العناصر النائبة
جميع العناصر النائبة محاطة بأقواس مجعدة مزدوجة {{ }} ويجب أن تتبع البناء الجملي المحدد بغض النظر عن اللغة المستخدمة في نص القالب: على سبيل المثال، {{pin-number}} هو عنصر نائب صالح يسترجع رقم الـ Pin المحدد. ومع ذلك، العناصر النائبة مثل {pin-number}, {{pinnummer}} أو {{pinnumber}} غير صالحة بسبب بناء جملة خاطئ ولن تعمل.
العناصر النائبة لا تعمل إذا كانت تحتوي على مسافات. لإنشاء عنصر نائب لعنوان متعدد الكلمات، استبدل المسافة بشرطة -، على سبيل المثال استخدم {{dataset-room-info}} بدلاً من {{dataset-Room info}}.
يتم تحديد مظهر الناتج بناءً على تنسيق العنصر النائب في القالب. لذا، إذا لم يبدو التقرير كما تريد، يجب عليك تغيير القالب. من ناحية أخرى، يتم عرض البيانات الديناميكية كما هي مدخلة في docu tools. لذا، إذا كان هناك خطأ مطبعي في عنوان الـ Pin المعروض، يجب تعديله في الـ Pin المناسب في docu tools.
نطاقات العناصر النائبة
عند العمل مع عناصر نائبة للمهام والـ Pins، من المهم مراعاة هيكل معين. نظرًا لأن الـ Pins والمهام غالبًا ما تتكرر في تقرير، من المهم تحديد القسم المحدد الذي ستظهر فيه هذه العناصر النائبة. يتم ملء هذا القسم المحدود بالبيانات من Pin أو مهمة ويتكرر بقدر ما يظهر في التقرير.
تبدأ هذه الأقسام دائمًا بـ {{pins}} أو {{tasks}} وتنتهي بـ {/pins}} أو {{/tasks}}. جميع المحتويات بين هذه العناصر النائبة تظهر مكررة حسب عدد الـ Pins أو المهام. من المهم ملاحظة أن الـ / الإضافي موجود فقط في العلامة الختامية.
تشمل الأقسام الأخرى:
{{pin-sort}}و{{/pin-sort}}- نطاق لعناصر نائبة لترتيب الـ Pins.{{pin-medias}}و{{/pin-medias}}- مكان لـ{{pin-media-file-name}}في تقارير Excel.{{comments}}و{{/comments}}- نطاق لتعليقات المهام.{{attendees}}و{{/attendees}}- قسم لعناصر نائبة للاتصال.
هناك أيضًا أقسام يتم فيها عرض النص فقط إذا تم استيفاء شرط معين. عادةً لا تظهر العناصر النائبة في التقرير إذا لم تكن هناك بيانات يمكن ملؤها. على سبيل المثال، إذا لم تكن هناك مهام في Pin معين، فلن تظهر عناصر نائبة للمهام. ومع ذلك، لإضافة عنوان يظهر عندما يكون المحتوى المناسب موجودًا، تم تقديم عناصر نائبة If. يتم وضع هذه الأقسام خارج العناصر النائبة الافتتاحية والختامية وتتحقق من وجود المحتويات. العناوين تظهر فقط إذا كان هناك محتوى فعلي يطابق الشرط المحدد.
لقد حددنا الأقسام if التالية:
{{if-tasks}}و{{end-if-tasks}}- العناوين تظهر فقط إذا كان هناك مهمة نشطة واحدة على الأقل في الـ Pin.{{if-media}}و{{end-if-media}}- العناوين تظهر فقط إذا كانت هناك محتويات وسائط فعلية.{{if-task-comment}}و{{/if-task-comment}}- العناوين تظهر فقط إذا كانت المهمة تحتوي على تعليقات.
يمكن استخدام هذه العناصر النائبة على سبيل المثال كما يلي:
{{pins}}{{if-media}}صور Pin{{end-if-media}}{{picture-table-small}}{{/pins}}
العنوان "صور Pin" لن يظهر في التقرير إذا لم يحتوي الـ Pin على صور.
المحتويات غير النشطة في التقارير
في التقارير، يتم استبعاد المهام والوسائط غير النشطة. ومع ذلك، يتم تضمين الـ Pins غير النشطة في التقرير.
عناصر نائبة للتقارير
{{today}}- تاريخ إنشاء السجل لتحديد مدى حداثة التقرير، مما يسمح بتتبع ومراقبة التقدم في تصحيح الأخطاء بمرور الوقت.{{weeknumber}}- يعرض رقم الأسبوع الذي تم فيه إنشاء التقرير.{{author}}- يعطي اسم المستخدم الذي أنشأ التقرير.{{author-email}}- يعرض عنوان البريد الإلكتروني لمنشئ التقرير.{{author-number}}- يعرض رقم هاتف المستخدم الذي أنشأ التقرير.{{author-company}}- يعرض شركة منشئ التقرير.{{report-title}}- يعرض العنوان الذي أُعطي للتقرير عند إنشائه في التطبيق.{{report-filter}}- يعرض التصفية التي استخدمت لإنشاء التقرير. يعمل عندما يتم إنشاء التقرير في عرض القائمة للتقارير.{{pagebreak}}- يضيف فاصل صفحات في تقارير Word.
نصيحة: يمكن إدراج فواصل الصفحات العامة مباشرة في قالب Word كعناصر ثابتة. إذا كنت ترغب في إضافة فاصل صفحات بعد كل Pin أو مهمة، فقط أضف العنصر النائب {{pagebreak}}.
عناصر نائبة لإنشاء حقل التوقيع
تتيح هذه العناصر النائبة التوقيع المباشر ضمن تطبيق iPad وتساهم في الناتج النهائي للتقرير:
{{signature-NAME}}- يعرض حقل التوقيع أثناء إنشاء التقرير، والذي يظهر بعد ذلك في التقرير النهائي.{{signaturename-NAME}}- ينشئ حقل نص لاسم الموقع عند إنشاء التقرير على iPad، والذي يتم تضمينه في التقرير.
ملاحظة: نظرًا لأن هذه العناصر النائبة يمكن استخدامها مرات عديدة ضمن قالب التقرير، من المهم التمييز بينها. يجب استبدال جزء "NAME" من العنصر النائب بوصف معبر يشير إلى المكان في التقرير الذي ترغب في عرض التوقيع والاسم المحدد.
على سبيل المثال، قم بإعداد تقرير مع حقلين للتوقيع والاسم باستخدام البناء الجملي التالي في القالب:
سيعرض التقرير النتائج كما هو موضح أدناه:
هذه العناصر النائبة متضمنة في قالب التقرير الافتراضي "سجل البناء اليومي".
عناصر نائبة لمعلومات الطقس
توفر العناصر النائبة بيانات متعلقة بالطقس تعتمد على الموقع المحدد في إعدادات مشروعك. لضمان وظيفتها، راعي التحقق من صحة العنوان على الجانب الأيمن.
{{weather-icon-info}}- يعرض توقعات الطقس لعنوان المشروع المحدد مع رمز جوي صغير. العنصر النائب مُنسق كجدول يحتوي في العمود الأول على الرمز الجوي وفي العمود الثاني على وصف التوقعات وبيانات درجة الحرارة.{{weather}}- عند استخدام هذا العنصر النائب في قالب التقرير، يظهر قسم جديد في نافذة إنشاء التقرير يختار تلقائيًا بيانات الطقس لليوم الحالي. بالانقر على زر "تعديل"، يمكنك اختيار أو تغيير التاريخ. باستخدام زر الحذف، يتم إعادة تعيين التاريخ إلى اليوم الحالي. هذا العنصر النائب لا يحتوي على رمز جوي.{{pin-weather}}هذا العنصر النائب يعطي الطقس من اليوم الذي تم فيه إنشاء الـ Pin.
عناصر نائبة لترتيب الـ Pins
تتيح لك هذه العناصر النائبة تنظيم التقارير حسب المخططات والفئات وإلحاق عنوان لضمان الترتيب الصحيح في جدول المحتويات.
إذا لم يكن هناك عنصر نائب محدد للترتيب، تستخدم التطبيق الترتيب الافتراضي من قائمة الـ Pins/المهام. ومع ذلك، تتجاوز عناصر نائبة الترتيب الترتيب الافتراضي للتطبيق. ملاحظة: هذه العناصر النائبة متوفرة فقط لتقارير Word.
ملاحظة: يجب أن تشمل عناصر نائبة الترتيب نطاق الـ Pin ضمن نطاق الترتيب. الاستخدام الصحيح هو:
{{pin-sort}}...عناصر نائبة للترتيب...{{pin}}...عناصر نائبة للـ Pin...{{/pin}}