مشاركة عبر

تأجيل تنفيذ عناصر XML في تنسيقات إعداد التقارير الإلكترونية

  • مقالة

نظرة عامة

يمكنك استخدام مصمم عمليات إطار عمل إعداد التقارير الإلكترونية (ER)لتكوين مكون التنسيق لحل إعداد التقارير الإلكترونية المستخدم لإنشاء المستندات الصادرة بتنسيق XML. تتكون البنية الهرمية لمكون التنسيق المكون من عناصر تنسيق بأنواع مختلفة. يتم استخدام عناصر التنسيق هذه لملء المستندات التي تم إنشاؤها بالمعلومات المطلوبة في وقت التشغيل. عند تشغيل تنسيق إعداد التقارير الإلكترونية، يتم افتراضيًا تشغيل عناصر التنسيق بنفس الترتيب كما هو موضح في التدرج الهرمي للتنسيق: واحد تلو الآخر من أعلى إلى أسفل. ولكن في وقت التصميم يمكنك تغيير ترتيب التنفيذ لأي عناصر XML لمكون التنسيق المكون.

بتشغيل خيار التنفيذ المؤجل لعنصر XML في التنسيق المكوَّن، يمكنك تأجيل (إرجاء) تنفيذ هذا العنصر. وفي هذه الحالة، لا يتم تشغيل العنصر حتى يتم تشغيل كافة العناصر الأخرى من نفس الأصل.

لمعرفة المزيد عن هذه الميزة، أكمل المثال في هذه المقالة.

قيود

خيار التنفيذ المؤجل غير معتمد إلا لعناصر XML التي يتم تكوينها لتنسيق إعداد التقارير الإلكترونية المستخدم لإنشاء مستندات صادرة بتنسيق XML.

خيار التنفيذ المؤجل غير معتمد إلا لعناصر xml التي توجد في عنصر xml واحد آخر. لذا لا ينطبق على عناصر XML التي تتواجد في أنواع أخرى من عناصر التنسيق (على سبيل المثال، في عنصرتسلسل XML).

خيار التنفيذ المؤجل غير معتمد لعناصر XML الموجودة في عنصر التنسيقالعام\الملف عند تعيين خيارتقسيم الملف على نعم. لمزيد من المعلومات حول كيفية تقسيم ملفات XML، راجع تقسيم ملفات XML المنشأة حسب حجم الملف وكمية المحتوى.

مثال: تأجيل تنفيذ عنصر XML في تنسيق إعداد التقارير الإلكترونية

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

يمكن تنفيذ هذه الخطوات في شركة USMF في 365‎ Finance Microsoft Dynamics.

المتطلبات الأساسية

لإكمال هذا المثال، يجب أن يكون لديك حق الوصول إلى شركة USMF في Finance لأحد الأدوار التالية:

  • مستشار وظيفي لإعداد التقارير الإلكتروني
  • مسؤول النظام

إذا لم تكن قد أكملت بعد المثال الموجود في موضوع تأجيل تنفيذ عناصر التسلسل في تنسيقات إعداد التقارير الإلكترونية فنزِّل التكوينات التالية لنموذج حل إعداد التقارير الإلكترونية.

وصف المحتوى اسم الملف
تكوين نموذج بيانات التقارير الإلكترونية Model to learn deferred elements.version.1.xml
تكوين تعيين نموذج إعداد التقارير الإلكترونية Mapping to learn deferred elements.version.1.1.xml

قبل البدء، يجب أيضًا تنزيل التكوين التالي لنموذج حل إعداد التقارير الإلكترونية على الكمبيوتر المحلي وحفظه.

وصف المحتوى اسم الملف
تنسيق تكوين ER Format to learn deferred XML elements.version.1.1.xml

استيراد نموذج تكوينات إعداد التقارير الإلكترونية.

  1. انتقل إلى إدارة المؤسسة>مساحات العمل‬>إعداد التقارير الإلكترونية‬.

  2. حدد تكوينات إعداد التقارير‬.

  3. في صفحة التكوينات، في حالة عدم توفر تكوين Model to learn deferred elements في شجرة التكوين، استورد تكوين نموذج بيانات إعداد التقارير الإلكترونية:

    1. حدد استبدال، ثم حدد تحميل من ملف XML.
    2. حدد استعراض، وابحث عن ملف Model to learn deferred elements.1.xml وحدده، ثم حدد موافق.

  4. في حالة عدم توفر التكوين تعيين للتعرف على العناصر المؤجلة في شجرة التكوين، استورد تكوين تعيين نموذج إعداد التقارير الإلكترونية:

    1. حدد استبدال، ثم حدد تحميل من ملف XML.
    2. حدد استعراض، وابحث عن ملف تعيين للتعرف على العناصر المؤجلة.1.1.xml وحدده، ثم حدد موافق.

  5. استيراد تكوين تنسيق إعداد التقارير الإلكترونية:

    1. حدد استبدال، ثم حدد تحميل من ملف XML.
    2. حدد استعراض، وابحث عن الملف Format to learn deferred XML elements.1.1.xml وحدده، ثم حدد موافق.

  6. في شجرة التكوين ، وسَّع Model to learn deferred elements.

  7. راجع قائمة تكوينات إعداد التقارير الإلكترونية المستوردة في شجرة التكوين.

    تكوينات إعداد التقارير الإلكترونية المستوردة على صفحة التكوينات.

تنشيط موفر تكوين

  1. انتقل إلى إدارة المؤسسة>مساحات العمل‬>إعداد التقارير الإلكترونية‬.

  2. في صفحة ترجمة التكوينات، في قسم موفري التكوين، تحقق من إدراج موفر التكوين لنموذج الشركة Litware, Inc (http://www.litware.com) ووضع علامة عليه كنشط. في حالة عدم إدراج موفر التكوين أو عدم وضع علامة عليه كنشط، اتبع الخطوات الموجودة في المقالة إنشاء موفر تكوين ووضع علامة عليه على أنه نشط..

    نموذج شركة Litware, Inc. في صفحة تكوينات الترجمة.

مراجعة تعيين النموذج المستورد

راجع إعدادات مكون تعيين نموذج إعداد التقارير الإلكترونية الذي تم تكوينه للوصول إلى حركات الضريبة وعرض البيانات التي يتم الوصول اليها عند الطلب.

  1. انتقل إلى إدارة المؤسسة>مساحات العمل‬>إعداد التقارير الإلكترونية‬.

  2. حدد تكوينات إعداد التقارير‬.

  3. في صفحة التكوينات، في شجرة التكوينات، وسَّع Model to learn deferred elements.

  4. حدد التكوين Mapping to learn deferred elements.

  5. حدد المصمم لفتح قائمة التعيينات.

  6. حدد المصمم لمراجعة تفاصيل التعيين.

  7. حدد إظهار التفاصيل.

  8. مراجعة مصادر البيانات التي يتم تكوينها للوصول إلى حركات الضريبة:

    • يتم تكوين مصدر بيانات الحركات لنوع سجل الجدول للوصول إلى جدول التطبيقات TaxTrans.

    • يتم تكون مصدر بيانات الإيصالات‬ لنوع الحقل المحسوب لإرجاع أكواد الإيصالات المطلوبة (INV-10000349 وINV-10000350) كقائمة سجلات.

    • كما يتم تكوين مصدر البيانات التي تمت تصفيتها لنوع الحقل المحسوب للتحديد، من مصدر بيانات الحركات، الحركات الضريبية للإيصالات المطلوبة فقط.

    • يُضاف حقل $TaxAmount لنوع الحقل المحسوب لمصدر البيانات الذي تمت تصفيته لعرض قيمه الضريبة ذات العلامة المعاكسة.

    • يتم تكوين مصدر البيانات المجمعة للنوع التجميع حسب لتجميع حركات الضريبة المصفاة لمصدر البيانات التي تمت تصفيتها.

    • يتم تكوين حقل التجميع TotalSum لمصدر البيانات المجمع لتلخيص قيم الحقل $TaxAmount لمصدر البيانات الذي تمت تصفيته لكافة حركات الضرائب المصفاة لمصدر البيانات هذا.

      حقل التجميع TotalSum في صفحة تحرير معلمات 'GroupBy'.

  9. راجع كيفية ربط مصادر البيانات التي تم تكوينها بنموذج البيانات، وكيفية عرضها للبيانات التي يتم الوصول إليها لتوفيرها في تنسيق إعداد التقارير الإلكترونية:

    • يتم ربط مصدر البيانات التي تمت تصفيتها بحقل نموذج البيانات Data.List.
    • يتم ربط الحقل $TaxAmount بمصدر البيانات الذي تمت تصفيته بحقل نموذج البيانات Data.List.Value.
    • يتم ربط الحقل TotalSum الخاص بمصدر البيانات المجمعة بحقل نموذج البيانات Data.Summary.Total.

    صفحة مصمم تعيين النموذج.

  10. اغلق صفحات مصمم تعيين النموذج وتعيينات النماذج.

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

  1. في صفحة التكوينات، في شجرة التكوين، حدد التكوينالتنسيق للتعرف على عناصر XML المؤجلة.

  2. حدد المصمم لمراجعة تفاصيل التنسيق.

  3. حدد إظهار التفاصيل.

  4. راجع إعدادات مكونات تنسيق إعداد التقارير الإلكترونية التي تم تكوينها لإنشاء مستند صادر بتنسيق XML يتضمن تفاصيل الحركات الضريبية:

    • تم تكوين عنصر XML التقرير\الرسالة لملء المستند الصادر بعقده مفردة تتضمن عناصر XML المتداخلة (الرأس والسجل والملخص).
    • يتم تكوين عنصر XML التقرير\الرسالة\الرأس لملء المستند الصادر بعقدة رأس واحدة لعرض التاريخ والوقت عند بدء المعالجة.
    • يتم تكوين عنصر تنسيق XML التقرير \الرسالة\السجل لملء المستند الصادر بعقدة سجل واحدة لعرض تفاصيل حركة ضريبية واحدة.
    • يتم تكوين عنصر تنسيق XML التقرير\الرسالة\الملخص لملء المستند الصادر بعقدة ملخص واحدة تتضمن مجموع قيم الضريبة من الحركات الضريبية التي تمت معالجتها.

    عنصر XML للرسالة وعناصر XML المتداخلة في صفحة مصمم التنسيق.

  5. في علامة التبويب تعيين، راجع التفاصيل التالية:

    • ليس من الضروري ربط عنصر التقرير\الرسالة\الرأس بمصدر لإنشاء عقدة واحدة في مستند صادر.
    • تنشئ السمة ExecutionDateTime التاريخ والوقت (بما في ذلك المللي ثوانس) عند إضافة عقدة رأس.
    • يتم ربط عنصر التقرير\الرسالة\ السجل بقائمة model.Data.List لإنشاء عقدة سجل واحدة لكل سجل من القائمة المرتبطة.
    • ترتبط السمة TaxAmount بالقيمة model.Data.List.Value (التي تظهر على الشكل @.Value في عرض المسار النسبي) لإنشاء قيمة الضريبة لحركة الضريبة الحالية.
    • تعد RunningTotal سمة نائبة للإجمالي الحالي لقيم الضريبة. لا تحتوي هذه السمة على مخرجات في الوقت الحالي، نظرًا لعدم تكوين ربط أو قيمة افتراضية لها.
    • تنشئ السمة ExecutionDateTime التاريخ والوقت (بما في ذلك المللي ثوانٍ) عند معالجة الحركة الحالية في هذا التقرير.
    • ليس من الضروري ربط عنصر التقرير\الرسالة\الملخص بمصدر بيانات لإنشاء عقدة واحدة في مستند صادر.
    • ترتبط السمة TotalTaxAmount بـ model.Data.Summary.Total لإنشاء مجموع قيم الضريبة لحركات الضريبة التي تمت معالجتها.
    • تنشئ السمة ExecutionDateTime التاريخ والوقت (بما في ذلك المللي ثوانس) عند إضافة عقدة الملخص.

    علامة التبويب التعيين في صفحة مصمم التنسيق.

تشغيل التقارير الإلكترونية المستوردة

  1. في صفحة مصمم التنسيق، حدد تشغيل.

  2. نزِّل الملف الذي يعرضه مستعرض الويب وافتحه للمراجعة.

    ملف تم تنزيله من التنسيق المستورد.

لاحظ أن عقدة الملخص تعرض مجموع قيم الضريبة للحركات التي تمت معالجتها. نظرًا لتكوين التنسيق لاستخدام الربط model.Data.Summary.Total لإرجاع هذا المجموع، يتم حساب المجموع باستدعاء تجميع TotalSum لمصدر البيانات المجمعة للنوع GroupBy في تعيين النموذج. لحساب هذا التجميع، يتكرر تعيين النموذج في كافة الحركات التي تم تحديدها في مصدر البيانات التي تمت تصفيتها. وبمقارنة أوقات تنفيذ عقدة الملخص وعقدة السجل الأخير، يمكنك تحديد استغراق عملية حساب المجموع 12 مللي ثانية. وبمقارنة أوقات تنفيذ عقدتا السجل الأول والسجل الأخير، يمكنك تحديد استغراق عملية إنشاء كل عقد السجلات 9 مللي ثانية. لذا كان إجمالي الوقت المطلوب هو 21 مللي ثانية.

تعديل التنسيق بحيث يعتمد الحساب على المخرجات المنشأة

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

  1. في صفحة مصمم التنسيق، وفي علامة التبويب التنسيق، حدد عنصر ملف التقرير في شجرة التنسيق.

  2. عيّن الخيار تجميع تفاصيل المخرجات على القيمة نعم. يمكنك الآن تكوين هذا التنسيق باستخدام محتوى تقرير تم إنشاؤه كمصدر بيانات يمكن الوصول إليه باستخدام وظائف إعداد التقارير الإلكترونية المضمنة في فئة تجميع البيانات.

  3. في علامة التبويب التعيين، حدد عنصر XML التقرير\الرسالة\السجل.

  4. كوِّن تعبير اسم مفتاح البيانات المجمعة ليكون WsColumn.

  5. كوِّن تعبير قيمة مفتاح البيانات المجمعة ليكون WsRow.

    عنصر XML السجل في صفحة مصمم التنسيق.

  6. حدد سمة التقرير\الرسالة\السجل\TaxAmount.

  7. كوِّن تعبير اسم مفتاح البيانات المجمعة ليكون SummingAmountKey.

    سمة TaxAmount في صفحة مصمم التنسيق.

    ويمكنك اعتبار هذا الإعداد بمثابة تنفيذ ورقة عمل ظاهرية، حيث يتم إلحاق قيمة خلية A1 بقيمة مبلغ الضريبة من كل حركة ضريبية تتم معالجتها.

  8. حدد سمة التقرير\الرسالة\السجل\RunningTotal، ثم حدد تحرير المعادلة‬.

  9. كوِّن التعبير SUMIF(SummingAmountKey, WsColumn, WsRow) باستخدام وظيفة إعداد التقارير الإلكترونية SUMIF المضمنة، ثم حدد حفظ.

    تعبير SUMIF.

  10. أغلق صفحة مصمم المعادلة.

  11. حدد حفظ، ثم حدد تشغيل.

  12. نزِّل الملف الذي يعرضه مستعرض الويب وراجعه.

    تم إنشاء قائمة قيمة الضريبة مع الإجمالي الحالي.

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

  13. حدد سمة التقرير\الرسالة\الملخص\RunningTotal، ثم حدد تحرير المعادلة‬.

  14. أدخل التعبير SUMIF(SummingAmountKey, WsColumn, WsRow) بدلاً من التعبير الموجود.

  15. حدد حفظ، ثم حدد تشغيل.

  16. نزِّل الملف الذي يعرضه مستعرض الويب وراجعه.

    تم إنشاء قائمة قيم الضرائب باستخدام الصيغة المعدلة.

    لاحظ أن الإجمالي الحالي لقيم الضريبة في عقدة السجل الأخير يساوي الآن المجموع في عقدة الملخص.

وضع قيم التجميع المبني على المخرجات في رأس التقرير

،إذا كان من الضروري على سبيل المثال تقديم مجموع قيم الضرائب في رأس التقرير، يمكنك تعديل التنسيق لديك.

  1. في صفحة مصمم التنسيق، وفي علامة التبويب التنسيق، حدد عنصر XML التقرير\الرسالة\الملخص.

  2. حدد تحريك لأعلى.

  3. حدد حفظ، ثم حدد تشغيل.

  4. نزِّل الملف الذي يعرضه مستعرض الويب وراجعه.

    تم تنزيل ملف قيم الضرائب لرأس التقرير.

    لاحظ أن مجموع قيم الضريبة في عقدة الملخص يساوي الآن 0 (صفر)، لأن هذا المجموع يتم حسابه الآن استنادًا إلى المخرجات المنشأة. عند إنشاء عقدة السجل الأول، لن تحتوي المخرجات المنشأة حينها على عقدالسجلات التي تحتوي على تفاصيل الحركة. يمكنك تكوين هذا التنسيق لتأجيل تنفيذ عنصر التقرير\الرسالة\الملخص حتى يتم تشغيل عنصر التقرير\الرسالة\السجل لكل الحركات الضريبية.

تأجيل تنفيذ عنصر XML الملخص حتى يتم استخدام الإجمالي المحسوب

  1. في صفحة مصمم التنسيق، وفي علامة التبويب التنسيق، حدد عنصر XML التقرير\الرسالة\الملخص.

  2. عيّن الخيار التنفيذ المؤجل إلى نعم.

    خيار التنفيذ المؤجل لعنصر XML الملخص في صفحة مصمم التنسيق.

  3. حدد حفظ، ثم حدد تشغيل.

  4. نزِّل الملف الذي يعرضه مستعرض الويب وراجعه.

    تم تنزيل ملف التنفيذ المؤجل.

    يتم الآن تشغيل عنصر التقرير\الرسالة \الملخص فقط بعد تشغيل كافة العناصر الأخرى التي تم إدراجها ضمن العنصر الأصلي التقرير\الرسالة. لذا يتم تشغيله بعد تشغيل عنصر التقرير\الرسالة \السجل لكل الحركات الضريبية لمصدر البيانات model.Data.List. توضح أوقات تنفيذ عقد السجل الأول والأخير وعقد الرأس والملخص هذه الحقيقة.

الموارد الإضافية