تكوين استيراد البيانات من SharePoint

لاستيراد بيانات من ملف وارد باستخدام إطار عمل إعداد التقارير الإلكتروني (ER)، يجب عليك تكوين أحد تنسيقات التقارير الإلكترونية الذي يدعم عملية الاستيراد، ثم قم بتشغيل تعيين نموذج لنوع إلى الوجهة الذي يستخدم هذا التنسيق كمصدر بيانات. لاستيراد البيانات، يجب عليك الانتقال إلى الملف الذي تريد استيراده. يمكن تحديد الملف الوارد يدويًا عن طريق المستخدم. باستخدام إمكانية إعداد التقارير الإلكترونية الجديدة لدعم استيراد البيانات من Microsoft SharePoint، يمكن تكوين هذه العملية كعملية غير مراقبة. يمكنك استخدام تكوينات إعداد التقارير الإلكترونية لتنفيذ عمليات استيراد البيانات من الملفات المخزنة في مجلدات Microsoft SharePoint. تشرح هذه المقالة كيفية إكمال عملية الاستيراد من SharePoint. تستخدم الأمثلة حركات المورد كبيانات الأعمال.

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

لإكمال الأمثلة في هذا البرنامج التعليمي، يجب أن تتمتع بالوصول التالي:

• الوصول إلى أحد الأدوار التالية:

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

• الوصول إلى مثيل Microsoft SharePoint Server الذي تم تكوينه للاستخدام مع التطبيق.

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

إنشاء تكوينات إعداد التقارير الإلكترونية اللازمة

شغّل دلائل المهام التقارير الإلكترونية ـ استيراد بيانات من ملف Microsoft Excel، التي تعتبر جزءًا من العملية التجاري 7.5.4.3 اكتساب/تطوير خدمة تكنولوجيا المعلومات/مكونات الحلول (10677). تُطلعك دلائل المهام هذه على عملية تصميم تكوينات التقارير الإلكترونية واستخدامها لاستيراد حركات المورد بشكل تفاعلي من ملفات Microsoft Excel. للحصول على مزيد من المعلومات، راجع توزيع المستندات الواردة بتنسيق Excel. بعد إكمال دلائل المهام، ستقوم بإعداد ما يلي:

تكوينات التقارير الإلكترونية

• تكوين نموذج إعداد التقارير الإلكترونية، نموذج مدفوعات 1099
• تكوين تنسيق إعداد التقارير الإلكترونية، التنسيق لاستيراد حركات الموردين من ملف Excel

عينة من ملف وارد لاستيراد البيانات

• ملف Excel 1099import data.xlsx، مع حركات المورد التي ينبغي استيرادها.

إشعار

تم تحديد التنسيق لاستيراد حركات المورد كتخطيط نموذج افتراضي. لذلك، إذا قمت بتشغيل تعيين نموذج لـ نموذج مدفوعات 1099، وكان تعيين النموذج هذا من النوع إلى الوجهة، يقوم تعيين النموذج بتشغيل هذا التنسيق لاستيراد بيانات من ملفات خارجية. ثم يستخدم هذه البيانات لتحديث جداول التطبيق.

تكوين الوصول إلى SharePoint لتخزين الملفات

لتخزين ملفات التقارير الإلكترونية في موقع SharePoint، يجب أن تقوم بتكوين الوصول إلى مثيل SharePoint Server الذي ستستخدمه الشركة الحالية. في هذا المثال، الشركة هي USMF. للحصول على الإرشادات، راجع تكوين مساحة تخزين SharePoint.

1. أكمل الخطوات الواردة في تكوين مساحة تخزين SharePoint.

2. افتح موقع SharePoint الذي تم تكوينه.

3. أنشئ المجلدات التالية حيث يمكنك حفظ ملفات التقارير الإلكترونية الواردة:

   • مصدر استيراد الملفات (الرئيسي) (يظهر مثال في لقطة الشاشة أدناه)
   • مصدر استيراد الملفات (البديل)

   

4. (اختياري) أنشئ المجلدات التالية حيث يمكنك حفظ الملفات بعد استيرادها.

   • مجلد أرشيف الملفات - يتم تخزين الملفات التي تم استيرادها بنجاح في هذا المجلد.
   • مجلد تحذير الملفات -يتم تخزين الملفات التي تم استيرادها مع تحذير في هذا المجلد.
   • مجلد أخطاء الملفات - يتم تخزين الملفات التي فشل استيرادها في هذا المجلد.

5. انتقل إلى إدارة المؤسسة > إدارة المستندات > أنواع المستندات.

6. أنشئ أنواع المستندات التالية التي سيتم استخدامها للوصول إلى مجلدات SharePoint التي أنشأتها. للحصول على إرشادات، راجع تكوين أنواع المستندات.

نوع المستند	مجموعة	الموق	مجلد SharePoint
SP الرئيسي	ملف	SharePoint	مصدر استيراد الملفات (الرئيسي)
ٍSP البديل	ملف	SharePoint	مصدر استيراد الملفات (البديل)
أرشيف SP	ملف	SharePoint	مجلد أرشيف الملفات
تحذير SP	ملف	SharePoint	مجلد تحذير الملفات
خطأ SP	ملف	SharePoint	مجلد أخطاء الملفات

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

1. انقر فوق إدارة المؤسسة>إعداد التقارير الإلكترونية>مصدر إعداد التقارير الإلكترونية.

2. على صفحة مصدر إعداد التقارير الإلكترونية، قم بتكوين ملفات المصدر لاستيراد البيانات باستخدام تنسيق إعداد التقارير الإلكترونية الذي تم تكوينه.

3. تعريف قناع اسم ملف، بحيث يتم فقط استيراد الملفات ذات الامتداد .xlsx. يُعد قناع اسم الملف اختياريًا، ويستخدم فقط عندما يتم تعريفه. يمكنك تحديد قناع واحد فقط لكل تنسيق إعداد تقارير إلكترونية.

4. قم بتغيير فرز الملفات قبل الاستيراد‬ إلى لا يقومون بالفرز، إذا كان يوجد عدد كبير جد من الملفات للاستيراد ولم يكن ترتيب الاستيراد مهمًا.

5. حدد جميع مجلدات SharePoint التي أنشأتها في وقت سابق.

   

إشعار

• يتم تعريف مصدر إعداد التقارير الإلكترونية لكل شركة تطبيق على حدة. وفي المقابل، تتم مشاركة تكوينات إعداد التقارير الإلكترونية بين الشركات.
• عندما تقوم بحذف إعداد مصدر التقارير الإلكترونية لتنسيق التقارير الإلكترونية، يتم أيضًا حذف كافة حالات الملفات المتصلة (أنظر أدناه) حسب تأكيد الحذف.

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

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

2. في قسم الملفات، راجع قائمة الملفات. توضح هذه القائمة ما يلي:

   • ملفات المصادر القابلة للتطبيق، استنادًا إلى قناع اسم الملف (إذا كان قناع اسم الملف مُعرفًا)، والتي تكون جاهزة لاستيراد البيانات. بالنسبة لهذه الملفات، يكون قسم ‏‫سجلات المصادر لتنسيق الاستيراد‬ فارغًا.
   • الملفات التي تم استيرادها في وقت سابق. لكل ملف من هذه الملفات، في قسم سجلات المصادر لتنسيق الاستيراد، يمكنك مراجعة محفوظات الاستيراد من هذا الملف.

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

استيراد بيانات من ملفات Excel موجودة في مجلد SharePoint

1. في SharePoint,، قم بتحميل ملف Microsoft Excel 1099import-data.xlsx الذي يحتوي على حركات المورد إلى مجلد SharePoint مصدر استيراد الملفات (الرئيسي) الذي قمت بإنشائه في وقت سابق.

   

2. على صفحة حالات الملف للمصادر، حدد تحديث لتحديث الصفحة. ملف Excel الذي تم تحميله على SharePoint في هذه الصفحة في الحالة جاهز. الحالات التالية مدعومة حاليًا:

   • جاهز – يتم تعيين هذه الحالة بشكل تلقائي إلى كل ملف جديد في مجلد SharePoint. تعني هذه الحالة أن الملف جاهز للاستيراد.
   • استيراد – تُعيّن هذه الحالة تلقائيًا بواسطة تقرير إعداد التقارير الإلكترونية عندما يتم تأمين الملف من خلال عملية الاستيراد لمنع استخدامه من خلال عمليات أخرى (عند تشغيل عدة عمليات في الوقت نفسه).
   • مستورد – تُعيّن هذه الحالة تلقائيًا بواسطة تقرير إعداد التقارير الإلكترونية عند إتمام عملية استيراد الملفات بنجاح. تعني هذه الحالة أن الملف المستورد قد تم حذفه من مصدر الملفات المكونة (مجلد SharePoint).
   • فشل – تُعيّن هذه الحالة تلقائيًا بواسطة تقرير إعداد التقارير الإلكترونية عند إتمام عملية استيراد الملفات مع وجود أخطاء أو استثناءات.
   • قيد الانتظار – تُعيّن هذه الحالة يدويًا بواسطة المستخدم في هذه الصفحة. تعني هذه الحالة أن الملف لن يتم استيراده في الوقت الحاضر. يمكن استخدام هذه الحالة لتأجيل استيراد بعض الملفات.

   

استيراد البيانات من ملفات SharePoint

1. افتح شجرة تكوينات إعداد التقارير الإلكترونية، حدد نموذج الدفع 1099، ثم قم بتوسيع قائمة مكونات نموذج إعداد التقارير الإلكترونية.

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

   

3. حدد تشغيل لتشغيل تعيين النموذج المحدد. نظرًا لقيامك بتكوين مصادر الملفات لتنسيق التقارير الإلكترونية، يمكنك تغيير إعداد الخيار ملف المصدر إذا اقتضت الحاجة. إذا حافظت على إعداد هذا الخيار، يتم استيراد ملفات xslx. من المصادر التي تم تكوينها (مجلدات SharePoint في هذا المثال).

   في هذا المثال، تقوم باستيراد ملف واحد فقط. ومع ذلك، إذا كان هناك ملفات متعددة، يتم تحديدها للاستيراد بالترتيب الذي تمت إضافتها به إلى مجلد SharePoint. يستورد كل تشغيل لتنسيق إعداد التقارير الإلكترونية ملف واحد مُحدد.

   

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

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

5. أدخل معرف إيصال، مثل V-00001، ثم قم بتحديد موافق.

   

6. على صفحة حالات الملف للمصادر، حدد تحديث لتحديث الصفحة.

   

7. في قسم الملفات، راجع قائمة الملفات. يوفر قسم سجلات المصادر لتنسيق الاستيراد‬‬‏‫ المحفوظات الخاصة باستيراد ملف Excel. نظراً لنجاح عملية استيراد هذا الملف، تم وضع علامة محذوف عليه في مجلد SharePoint.

8. راجع مجلد SharePoint مصدر استيراد الملفات (الرئيسي). تم حذف ملفات Excel التي تم استيرادها بنجاح من هذا المجلد .

9. حدد الحسابات الدائنة>المهام الدورية>ضريبة 1099>تسوية المورد لنموذج 1099s.

10. في حقول من تاريخ و إلى تاريخ، أدخل القيم المناسبة. بعد ذلك، حدد حركات 1099 اليدوية.

    يتم عرض حركات المورد التي تم استيرادها من ملفات Excel في SharePoint للإيصال V-00001 في الصفحة.

    

إعداد ملف Excel للاستيراد

1. افتح ملف Excel الذي استخدمته مسبقًا. في الصف رقم (3) عمود رقم (1)، أضف كود المورد غير الموجود في التطبيق. أضف معلومات مورد إضافية خطأ إلى الصف.

   

2. قم بتحميل ملف Excel المُحدث الذي يحتوي على حركات الموردين إلى مجلد SharePoint مصدر استيراد الملفات (الرئيسي).

3. افتح شجرة تكوينات إعداد التقارير الإلكترونية، حدد نموذج الدفع 1099، ثم قم بتوسيع قائمة مكونات نموذج إعداد التقارير الإلكترونية.

4. حدد اسم تعيين النموذج لتحديث تعيين النموذج حتي يتم اعتبار كود المورد غير الصحيح خطأ خلال عملية استيراد البيانات.

5. حدد المصمم.

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

   

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

8. حدد تشغيل لتشغيل تعيين نموذج إعداد التقارير الإلكترونية المُعدّل.

9. أدخل معرف إيصال، مثل V-00002، ثم قم بتحديد موافق.

   سجل المعلومات يتضمن إعلامًا يفيد بوجود ملف في مجلد SharePoint يحتوي على حساب مورّد غير صحيح ولا يمكن استيراده.

   

10. في صفحة حالات الملف للمصادر، حدد تحديث، ثم في قسم الملفات، قم بمراجعة قائمة الملفات.

    

يشير قسم سجلات المصدر لتنسيق الاستيراد إلى فشل عملية الاستيراد وإلى أن الملف ما زال موجودًا في مجلد أخطاء الملفات‬ في SharePoint (لم يتم تحديد خانة الاختيار محذوف). إذا أصلحت هذا الملف في SharePoint عن طريق إضافة كود المورّد المناسب ثم نقلته إلى مجلد SharePoint "مصدر استيراد الملفات (الرئيسي)"، يمكنك استيراد الملف مرة أخرى.

11. حدد الحسابات الدائنة>المهام الدورية>ضريبة 1099>تسوية المورد لنموذج 1099، وأدخل القيم الصحيحة في الحقلين تاريخ البدء وتاريخ الانتهاء، ثم حدد حركات 1099 اليدوية.

    تتوفر حركات للإيصال V-00001 فقط. لا تتوفر حركات للإيصال V-00002 على الرغم من أنه تم العثور على الخطأ الخاص بالحركة التي تم استيرادها مؤخرًا في ملف Excel.

القيود

في إصدارات Dynamics 365 Finance التي تسبق الإصدار 10.0.25، لا توفر واجهة المستخدم في إطار عمل التقارير الإلكترونية القدرة على بدء وظيفة دُفعية جديدة ستقوم بتشغيل تعيين نموذج لاستيراد البيانات في الوضع غير المراقب. بدلاً من ذلك، يجب عليك تطوير منطق جديد بحيث يمكن استدعاء تعيين نموذج التقارير الإلكترونية المكون من واجهة مستخدم التطبيق (UI) لاستيراد البيانات من الملفات الواردة. لتطوير هذا المنطق، يجب تنفيذ بعض الأعمال الهندسية.

لمزيد من المعلومات حول واجهة برمجة تطبيقات التقارير الإلكترونية ذات الصلة، راجع قسم كود تشغيل تعيين تنسيق لاستيراد البيانات في موضوع ‏‫التغييرات في واجهة برمجة التطبيقات (API) لإطار عمل التقارير الإلكترونية لـ Application update 7.3‬. راجع الكود في فئة BankImport_RU لنموذج Application Suite لمعرفة كيف يمكن تنفيذ المنطق المخصص الخاص بك. تقوم الفئة BankImport_RU بتوسيع الفئة RunBaseBatch. بشكل خاص، راجع أسلوب runER()، حيث يتم إنشاء كائن ERIModelMappingDestinationRun كمشغل لتعيين نموذج التقارير الإلكترونية.

في الإصدار 10.0.25 من Finance والإصدارات اللاحقة، لا توفر واجهة المستخدم في إطار عمل التقارير الإلكترونية القدرة على تشغيل وظيفة دُفعية جديدة لتشغيل تعيين نموذج لاستيراد البيانات في الوضع غير المراقب. لمزيد من المعلومات حول هذه العملية، راجع استيراد البيانات في الوضع الدُفعي من الملفات المحددة يدويًا.

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

نظرة عامة حول التقارير الإلكترونية

التغييرات في واجهة برمجة التطبيقات (API) لإطار عمل التقارير الإلكترونية لـ Application update 7.3

التغييرات في واجهة برمجة التطبيقات (API) لإطار عمل التقارير الإلكترونية لـ Application update 10.0.23

التغييرات في واجهة برمجة التطبيقات (API) لإطار عمل التقارير الإلكترونية لـ Application update 10.0.25