استكشاف المشاكل وإصلاحها أثناء المزامنة الأولية

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

هام

قد تتطلب بعض المشكلات التي تتناولها هذه المقالة إما منصب مسؤول النظام أو بيانات اعتماد مسؤول مستأجر Microsoft Azure Active Directory (Azure AD). يوضح القسم الخاص بكل مشكلة ما إذا كانت هناك حاجة إلى دور محدد أو بيانات اعتماد.

التحقق من أخطاء المزامنة الأولية في تطبيقات التمويل والعمليات

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

لا يمكنك إكمال المزامنة الأولية: 400 طلب غير صحيح

الدور المطلوب لإصلاح المشكلة: مسؤول النظام

قد تتلقى رسالة الخطأ التالية عند محاولة تشغيل التعيين والمزامنة الأولية:

([طلب غير صحيح], أرجع الخادم البعيد خطأ: (400) طلب غير صحيح.), AX واجه التصدير خطأ.

فيما يلي مثال لرسالة الخطأ الكاملة.

Dual write Initial Sync completed with status: Error. Following are the details:
Executed leg: From AX Financial dimensions to CRM msdyn_dimensionattributes
with exported records count: 0, ImportRecordsErrorCount: 0,
ImportRecordsInsertedCount: 0 and ImportRecordsUpdatedCount: 0
ErrorsDetails:
Dual write Initial sync failed
Message: ([Bad Request], The remote server returned an error: (400) Bad Request.), AX export encountered an error
Stacktrace: at
Microsoft.Dynamics.Integrator.QueryGenerator.AxClient.\<ExportAxPackage\>d__16.MoveNext()
in X:\\bt\\1024532\\repo\\src\\Core\\QueryGenerator\\AxClient.cs:line 265
\--- End of stack trace from previous location where exception was thrown ---
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
at Microsoft.D365.ServicePlatform.Context.ServiceContext.Activity.\<ExecuteAsync\>d__11\`2.MoveNext()
\--- End of stack trace from previous location where exception was thrown ---

في حاله حدوث هذا الخطأ باستمرار، ولا يمكنك إكمال المزامنة الأولية، فاتبع هذه الخطوات لإصلاح هذه المشكلة.

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

خطأ المزامنة الأولية: 403 ممنوع

قد تتلقى رسالة الخطأ التالية أثناء المزامنة الأولية:

([ممنوع]، أرجع الخادم البعيد خطأ: (403) ممنوع.)، صادف تصدير AX خطأ

لإصلاح المشكلة، اتبع هذه الخطوات.

1. سجّل دخولك إلى تطبيق التمويل والعمليات.
2. في صفحة تطبيقات Azure Active Directory، احذف عميل DtAppID، ثم أضفه مرة أخرى.

حالات فشل المراجع الذاتية أو المراجع الدائرية أثناء المزامنة الأولية

قد تتلقى رسائل خطأ عند وجود مراجع ذاتية أو مراجع دائرية لدى أي من تعييناتك. تقع الأخطاء ضمن هذه الفئات:

• خطأ في تعيين جدول الموردين V2–to–msdyn_vendors
• خطأ في تعيين جدول العملاء V3–to–Accounts

حل خطأ في تعيين جدول الموردين V2–to–msdyn_vendors

قد تواجه أخطاء المزامنة الأولية لتعيين الموردون V2 إلى msdyn_vendors إذا كانت الجداول تحتوي على صفوف حالية حيث توجد قيم في العمودين PrimaryContactPersonId وInvoiceVendorAccountNumber. تحدث هذه الأخطاء لأن InvoiceVendorAccountNumber عبارة عن عمود مرجع ذاتي و PrimaryContactPersonId عبارة عن مرجع دائري في تعيين المورّد.

سيكون لرسائل الخطأ التي تتلقاها النموذج التالي.

تعذر حل guid للحقل: <الحقل>. لم يتم العثور على البحث: <القيمة>. جرّب عناوين Url هذه للتحقق مما إذا كانت البيانات المرجعية موجودة: https://focdsdevtest2.crm.dynamics.com/api/data/v9.0/<entity>?$select=<field>&$filter=<field> eq <value>

فيما يلي بعض الأمثلة:

• تعذر حل guid للحقل: msdyn_vendorprimarycontactperson.msdyn_contactpersonid. لم يتم العثور على البحث: 000056. جرّب عناوين Url هذه للتحقق مما إذا كانت البيانات المرجعية موجودة: https://focdsdevtest2.crm.dynamics.com/api/data/v9.0/contacts?$select=msdyn_contactpersonid.contactid&$filter=msdyn_contactpersonid eq '000056'
• تعذر حل guid للحقل: msdyn_invoicevendoraccountnumber.msdyn_vendoraccountnumber. لم يتم العثور على البحث: V24-1. جرّب عناوين Url هذه للتحقق مما إذا كانت البيانات المرجعية موجودة: https://focdsdevtest2.crm.dynamics.com/api/data/v9.0/msdn_vendors?$select=msdyn_vendoraccountnumber,msdyn_vendorid&$filter=msdyn_vendoraccountnumber eq 'V24-1'

إذا كانت أية صفوف في جدول مورد تتضمن قيمًا في الأعمدة PrimaryContactPersonId وInvoiceVendorAccountNumber، فاتبع هذه الخطوات لإكمال المزامنة الأولية.

1. في تطبيق التمويل والعمليات، احذف العمودين PrimaryContactPersonId وInvoiceVendorAccountNumber من التعيين، ثم احفظ التعيين.

   1. في صفحة تعيين الكتابة المزدوجة Vendors V2 (msdyn_vendors)، على علامة تبويب تعيينات الجدول في عامل التصفية الأيسر، حدد apps.Vendors V2 لتطبيقات التمويل والعمليات. في عامل التصفية الأيمن، حدد Sales.Vendor

   2. ابحث عن primarycontactperson للعثور على العمود المصدر PrimaryContactPersonId.

   3. حدد الإجراءات، ثم حدد حذف.

      

   4. كرر هذه الخطوات لحذف العمود InvoiceVendorAccountNumber.

      

   5. احفظ التغييرات الخاصة بك للتعيين.

2. قم بإيقاف تشغيل تعقب جدول المورّدون V2.

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

   2. حدد الجدول المورّدون V2.

   3. في جزء الإجراء، حدد الخيارات، ثم حدد تعقب التغييرات.

      

   4. حدد تعطيل تعقب التغييرات.

      

3. قم بتشغيل المزامنة الأولية لتعيين Vendors V2 (msdyn_vendors). يجب أن تنجح المزامنة الأولية بدون حدوث أية أخطاء.

4. قم بتشغيل المزامنة الأولية لتعيين جهات اتصال CDS V2 (جهات الاتصال). يجب مزامنة هذا التعيين إذا كنت ترغب في مزامنة عمود جهة الاتصال الرئيسية أو جدول الموردين، لأنه يجب إجراء مزامنة أولية لصفوف جهات الاتصال.

5. أضف العمودين PrimaryContactPersonId وInvoiceVendorAccountNumber إلى التعيين Vendors V2 (msdyn_vendors)، ثم احفظ التعيين.

6. قم بتشغيل المزامنة الأولية مرة أخرى لتعيين Vendors V2 (msdyn_vendors). ستتم مزامنة كافة الصفوف بسبب إيقاف تشغيل تعقب التغييرات.

7. قم بتشغيل تعقب جدول المورّدون V2 مرة أخرى.

حل أخطاء في تعيين جدول العملاء V3–to–Accounts

قد تواجه أخطاء المزامنة الأولية لتعيينالعملاء V3 إلى الحسابات إذا كانت الجداول تحتوي على صفوف حالية حيث توجد قيم في الاعمدة ContactPersonID وInvoiceAccount. يعود سبب حدوث هذه الأخطاء إلى كون InvoiceAccount عبارة عن عمود مرجع ذاتي وContactPersonId عبارة عن مرجع دائري في تعيين المورّد.

سيكون لرسائل الخطأ التي تتلقاها النموذج التالي.

تعذر حل guid للحقل: <الحقل>. لم يتم العثور على البحث: <القيمة>. جرّب عناوين Url هذه للتحقق مما إذا كانت البيانات المرجعية موجودة: https://focdsdevtest2.crm.dynamics.com/api/data/v9.0/<entity>?$select=<field>&$filter=<field> eq <value>

فيما يلي بعض الأمثلة:

• تعذر حل guid للحقل: primarycontactid.msdyn_contactpersonid. لم يتم العثور على البحث: 000056. جرّب عناوين Url هذه للتحقق مما إذا كانت البيانات المرجعية موجودة: https://focdsdevtest2.crm.dynamics.com/api/data/v9.0/contacts?$select=msdyn_contactpersonid.contactid&$filter=msdyn_contactpersonid eq '000056'
• تعذر حل guid للحقل: msdyn_billingaccount.accountnumber. لم يتم العثور على البحث: 1206-1. جرّب عناوين Url هذه للتحقق مما إذا كانت البيانات المرجعية موجودة: https://focdsdevtest2.crm.dynamics.com/api/data/v9.0/accounts?$select=accountnumber.account&$filter=accountnumber eq '1206-1'

إذا كانت أية صفوف في كيان العميل تتضمن قيمًا في الأعمدة ContactPersonID وInvoiceAccount، فاتبع هذه الخطوات لإكمال المزامنة الأولية. يمكنك استخدام هذا الأسلوب لأي جداول جاهزة مثل الحسابات وجهات الاتصال.

1. في تطبيق التمويل والعمليات، احذف العمودين ContactPersonID وInvoiceAccount من التعيين العملاء V3 (الحسابات)، ثم احفظ التعيين.

   1. في صفحة تعيين الكتابة المزدوجة الإصدار 3 من العملاء (الحسابات)، وفي علامة تبويب تعيينات الجدول، في عامل التصفية الأيسر، حدد app.Customers V3 للتمويل والعمليات. في عامل التصفية الأيسر، حدد Dataverse.Account.

   2. ابحث عن contactperson للعثور على العمود المصدر ContactPersonID.

   3. حدد الإجراءات، ثم حدد حذف.

      

   4. كرر هذه الخطوات لحذف العمود ‎InvoiceAccount.

      

   5. احفظ التغييرات الخاصة بك للتعيين.

2. قم بإيقاف تشغيل تعقب جدول العملاء V3.

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

   2. حدد الجدول العملاء V3.

   3. في جزء الإجراء، حدد الخيارات، ثم حدد تعقب التغييرات.

      

   4. حدد تعطيل تعقب التغييرات.

      

3. قم بتشغيل المزامنة الأولية لتعيين العملاء V3 (الحسابات). يجب أن تنجح المزامنة الأولية بدون حدوث أية أخطاء.

4. قم بتشغيل المزامنة الأولية لتعيين جهات اتصال CDS V2 (جهات الاتصال).

   إشعار

   هناك مخططان لهما نفس الاسم. تأكد من تحديد المخطط الذي يتضمن الوصف التالي في علامة التبويب تفاصيل: قالب كتابة مزدوجة للمزامنة بين FO.CDS Vendor Contacts V2 إلى CDS.Contacts. بحاجة إلى حزمة جديدة [Dynamics365SupplyChainExtended].

5. أعد إضافة العمودين InvoiceAccount وContactPersonId إلى تعيين العملاء V3 (الحسابات)، ثم احفظ التعيين. العمودان InvoiceAccount وContactPersonId هما الآن عبارة عن جزء من وضع المزامنة المباشرة مرة أخرى. في الخطوة التالية، ستقوم بالمزامنة الأولية لهذه الأعمدة.

6. قم بتشغيل المزامنة الأولية مرة أخرى لتعيين العملاء V3 (الحسابات). بسبب إيقاف تشغيل تعقب التغييرات، ستتم مزامنة بيانات InvoiceAccount وContactPersonId من تطبيق التمويل والعمليات إلى Dataverse.

7. لمزامنة بيانات InvoiceAccount وContactPersonId من Dataverse إلى تطبيق التمويل والعمليات، يجب استخدام مشروع تكامل بيانات.

   1. في Power Apps، أنشئ مشروع تكامل البيانات بين الجدولين Sales.Account والتمويل والعمليات apps.Customers V3. يجب أن يكون اتجاه البيانات من Dataverse إلى تطبيق التمويل والعمليات. لأن InvoiceAccount عبارة عن سمة جديدة في الكتابة المزدوجة، فقد ترغب في تخطي المزامنة الأولية لهذه السمة. للحصول على مزيد من المعلومات، راجع دمج البيانات في Dataverse.

      يوضح الرسم التوضيحي التالي مشروعًا يقوم بتحديث CustomerAccount وContactPersonId.

      

   2. أضف معايير الشركة في عامل التصفية على جانب Dataverse، بحيث يتم تحديث فقط الصفوف التي تطابق معايير التصفية في تطبيق التمويل والعمليات. لإضافة عامل تصفية، حدد زر عامل التصفية. ثم في مربع الحوار تحرير الاستعلام، فإنه يمكنك إضافة استعلام عامل تصفية مثل _msdyn_company_value eq '<guid>'.

      [ملحوظة] إذا لم يكن زر عامل التصفية موجودًا، فأنشئ تذكرة دعم كي تطلب من فريق تكامل البيانات تمكين إمكانية التصفية على المستأجر.

      إذا لم تقم بإدخال استعلام عامل تصفية للقيمة msdyn_company_value، فستتم مزامنة جميع الصفوف.

      

   يتم الآن إكمال المزامنة الأولية للصفوف.

8. في تطبيق التمويل والعمليات، قم بتشغيل تعقب التغييرات مرة أخرى لجدول العملاء V3.

فشل المزامنة الأولية على الخرائط مع أكثر من 10 حقول بحث

قد تتلقى رسالة الخطأ التالية عند محاولة تشغيل فشل مزامنة أولية على العملاء V3 - حسابات أو تعيينات أوامر المبيعات أو أي خريطة مع أكثر من 10 حقول بحث:

CRMExport: اكتمل تنفيذ الحزمة. خطأ وصف 5 محاولات للحصول على البيانات من https://xxxxx//datasets/yyyyy/tables/accounts/items?$select=accountnumber, address2_city, address2_country, ... (msdyn_company/cdm_companyid eq 'id')&$orderby=accountnumber asc failed.

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

لإصلاح هذه المشكلة، اتبع هذه الخطوات:

1. إزالة حقول البحث الاختيارية من مخطط الكيان ثنائي الكتابة بحيث يكون عدد عمليات البحث 10 أو أقل.
2. حفظ الخريطة والقيام بالمزامنة الأولية.
3. عند نجاح المزامنة الأولية للخطوة الأولى، أضف حقول البحث المتبقية وأزل حقول البحث التي قمت بمزامنتها في الخطوة الأولى. تأكد من أن عدد حقول البحث 10 أو أقل. حفظ الخريطة وتشغيل المزامنة الأولية.
4. كرر هذه الخطوات حتى تتم مزامنة كافة حقول البحث.
5. إضافة كافة حقول البحث مرة أخرى إلى الخريطة وحفظ الخريطة وتشغيل الخريطة مع تخطي المزامنة الأولية.

تمكن هذه العملية الخريطة لوضع المزامنة المباشرة.

مشكلة معروفة أثناء المزامنة الأولية للعناوين البريدية للطرف والعناوين الإلكترونية للطرف

قد تتلقى رسالة الخطأ التالية عند محاولة تشغيل syn الأولية من عناوين الطرف البريدية والعناوين الإلكترونية الطرف:

تعذر العثور على رقم الطرف في Dataverse.

هناك مجموعة نطاقات على DirPartyCDSEntity في تطبيق التمويل والعمليات يقوم بتصفية الأطراف من النوع شخص ومؤسسة. ونتيجة لذلك، لن تؤدي المزامنة الأولية لتعيين أطراف CDS‏ - msdyn_parties إلى مزامنة الأطراف من الأنواع الأخرى، بما في ذلك الكيان القانوني ووحدة التشغيل. عند تشغيل المزامنة الأولية للعناوين البريدية لأطراف CDS‏ ‏(msdyn_partypostaladdresses) أو جهات اتصال الأطراف V3 ‏(msdyn_partyelectronicaddresses) قد تتلقى الخطأ.

نحن نعمل على إصلاح لإزالة نطاق نوع الطرف على كيان التمويل والعمليات بحيث يمكن مزامنة الأطراف من جميع الأنواع مع Dataverse بنجاح.

هل هناك أي مشكلات في الأداء أثناء تشغيل المزامنة الأولية لبيانات العملاء أو جهات الاتصال؟

إذا قمت بتشغيل المزامنة الأولية لبيانات العميل وكان لديك مخططات العملاء قيد التشغيل ومن ثم يتم تشغيل المزامنة الأولية لبيانات جهات الاتصال، قد تكون هناك مشكلات في الأداء أثناء عمليات الإدراج والتحديثات إلى جدولي LogisticsPostalAddress وLogisticsElectronicAddress لعناوين جهات الاتصال. يتم تعقب نفس العنوان البريدي العمومي وجداول العناوين الإلكترونية لـ CustCustomerV3Entity وVendVendorV2Entity ويحاول الكتابة المزدوجة إنشاء المزيد من الاستعلامات لكتابة البيانات إلى الجانب الآخر. إذا كنت قد قمت بتشغيل المزامنة الأولية للعميل بالفعل، فقم بإيقاف الخريطة المقابلة أثناء تشغيل المزامنة الأولية لبيانات جهات الاتصال. قم بنفس الشيء لبيانات المورد. عند انتهاء المزامنة الأولية، يمكنك تشغيل كافة الخرائط عن طريق تخطي المزامنة الأولية.

لا يمكن مزامنة نوع البيانات الذي تم تعويمه والذي يحتوي علي قيمة صفرية

قد تفشل المزامنة الأولية للسجلات التي لها قيمة صفرية لحقل السعر، مثل مبلغ الدفعة الثابتة أو المبلغ بعملة الحركة. في هذه الحالة، ستتلقي رسالة خطأ مشابهة للمثال التالي:

حدث خطأ أثناء التحقق من معلمات الإدخال: Microsoft.OData.ODataException: لا يمكن تحويل '000000' الحرفي إلى النوع المتوقع 'Edm.Decimal'، ...

تكمن المشكلة في قيمة اللغة المحلية ضمن تنسيقات بيانات المصدر في وحدة إدارة البيانات. قم بتغيير قيمة حقل اللغة المحلية إلى en-us، ثم حاول مرة أخرى.