مشاركة عبر

استكشاف الأخطاء المتعلقة بموصلات Dynamics 365 وDataverse (خدمة البيانات المشتركة) وDynamics CRM في Azure Data Factory وAzure Synapse وإصلاحها

  • مقالة

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

توفر هذه المقالة اقتراحات لاستكشاف المشكلات الشائعة المتعلقة بموصلات Dynamics 365 وDataverse (خدمة البيانات المشتركة) وDynamics CRM في Azure Data Factory وAzure Synapse وإصلاحها.

رمز الخطأ: DynamicsCreateServiceClientError

  • الرسالة: This is a transient issue on Dynamics server side. Try to rerun the pipeline.

  • السبب : المشكلة هي مشكلة مؤقتة من جانب خادم Dynamics.

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

الأعمدة المفقودة عند استيراد مخطط أو معاينة البيانات

  • الأعراض: بعض الأعمدة مفقودة عند استيراد مخطط أو معاينة البيانات. رسالة الخطأ: The valid structure information (column name and type) are required for Dynamics source.

  • السبب: هذه المشكلة تكون حسب التصميم، لأن Data Factory ومسارات Synapse غير قادرين على عرض الأعمدة التي لا تحتوي على قيم في أول 10 سجلات. تأكد من أن الأعمدة التي أضفتها موجودة بالتنسيق الصحيح.

  • التوصية: أضف الأعمدة يدوياً في علامة تبويب التعيين. لمزيد من التفاصيل، راجع التعيين الصريح.

رمز الخطأ: DynamicsMissingTargetForMultiTargetLookupField

  • الرسالة: Cannot find the target column for multi-target lookup field: '%fieldName;'.

  • السبب: العمود الهدف غير موجود في المصدر أو في تعيين العمود.

  • التوصية:

    1. تأكد من احتواء المصدر على العمود الهدف.
    2. أضف العمود الهدف في تعيين العمود. تأكد من أن عمود المتلقي بالتنسيق {fieldName}@EntityReference.

رمز الخطأ: DynamicsInvalidTargetForMultiTargetLookupField

  • الرسالة: The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

  • السبب: تم تقديم اسم كيان خاطئ ككيان هدف لحقل بحث متعدد الأهداف.

  • التوصية: أدخل اسم كيان صالحاً لحقل البحث متعدد الأهداف.

رمز الخطأ: DynamicsInvalidTypeForMultiTargetLookupField

  • الرسالة: The provided target type is not a valid string. Field: '%fieldName;'.

  • السبب: القيمة الموجودة في العمود الهدف ليست سلسلة.

  • التوصية: أدخل سلسلة صالحة في عمود هدف البحث متعدد الأهداف.

رمز الخطأ: DynamicsFailedToRequetServer

  • الرسالة: The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

  • السبب: خادم Dynamics غير مستقر أو لا يمكن الوصول إليه، أو أن الشبكة تواجه مشكلات.

  • التوصية: لمزيد من التفاصيل، تحقق من اتصال الشبكة أو تحقق من سجل خادم Dynamics. لمزيد من المساعدة، اتصل بدعم Dynamics.

رمز الخطأ: DynamicsFailedToConnect

  • الرسالة: Failed to connect to Dynamics: %message;

  • الأسباب والتوصيات: قد تؤدي الأسباب المختلفة إلى حدوث هذا الخطأ. تحقق أدناه قائمة لتحليل السبب المحتمل، والتوصية ذات الصلة.

    تحليل السبب التوصية
    أنت ترى ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. أو خلاف ذلك Unable to Login to Dynamics CRM, message:ERROR REQUESTING Token FROM THE Authentication context - USER intervention required but not permitted by prompt behavior AADSTS50079: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multi-factor authentication to access '00000007-0000-0000-c000-000000000000' إذا كانت حالة الاستخدام الخاصة بك تفي بجميع الشروط الثلاثة التالية:
  • أنت تتصل بـ Dynamics 365 أو Common Data Service أو Dynamics CRM.
  • أنت تستخدم مصادقة Office365.
  • تم تكوين المستأجر والمستخدم في معرف Microsoft Entra للوصول المشروط و/أو المصادقة متعددة العوامل مطلوبة (راجع هذا الارتباط إلى مستند Dataverse).
    • في ظل هذه الظروف، كان الاتصال ينجح قبل 6/8/2021. بدء تشغيل اتصال 6/9/2021 سيبدأ بالفشل بسبب إهمال خدمة الاكتشاف الإقليمية (راجع هذا الارتباط).    		 إذا تم تكوين المستأجر والمستخدم في Microsoft Entra ID للوصول المشروط و/أو المصادقة متعددة العوامل مطلوبة، فيجب عليك استخدام "كيان خدمة Microsoft Entra" للمصادقة بعد 6/8/2021. يُرجى الرجوع إلى هذا الارتباط للحصول على الخطوات التفصيلية.
    إذا رأيت Office 365 auth with OAuth failed في رسالة الخطأ، فهذا يعني أن خادمك قد يحتوي على بعض التكوينات غير المتوافقة مع OAuth.
  • اتصل بفريق دعم Dynamics وأخبرهم برسالة الخطأ بالتفصيل للحصول على المساعدة.
  • استخدم المصادقة الأساسية للخدمة، ويمكنك الرجوع إلى هذه المقالة: مثال: Dynamics عبر الإنترنت باستخدام كيان خدمة Microsoft Entra ومصادقة الشهادة.
    		•
    إذا رأيت Unable to retrieve authentication parameters from the serviceUri في رسالة الخطأ، فهذا يعني أنك أدخلت عنوان URL غير صحيح لخدمة Dynamics أو وكيل/ جدار حماية لاعتراض نسبة استخدام الشبكة.
  • تأكد من أنك أدخلت عنوان URI الصحيح للخدمة في الخدمة المرتبطة.
  • إذا كنت تستخدم وقت تشغيل التكامل المستضاف ذاتياً (Self Hosted IR)، فتأكد من أن جدار الحماية/ الوكيل لا يعترض الطلبات إلى خادم Dynamics.
    		•
    إذا رأيت An unsecured or incorrectly secured fault was received from the other party في رسالة الخطأ، فهذا يعني أنه تم الحصول على استجابات غير متوقعة من جانب الخادم.
  • تأكد من صحة اسم المستخدم وكلمة المرور إذا كنت تستخدم مصادقة Office 365.
  • تأكد من إدخال عنوان URI الصحيح للخدمة.
  • إذا كنت تستخدم عنوان URL إقليمياً لإدارة علاقات العملاء "CRM" (يحتوي عنوان URL على رقم بعد "crm")، فتأكد من أنك تستخدم المعرّف الإقليمي الصحيح.
  • اتصل بفريق دعم Dynamics للحصول على المساعدة.
    		•
    إذا رأيت No Organizations Found في رسالة الخطأ، فهذا يعني أن اسم مؤسستك غير صحيح أو أنك استخدمت معرّف منطقة إدارة علاقات عملاء (CRM) خاطئ في عنوان URL للخدمة.
  • تأكد من إدخال عنوان URI الصحيح للخدمة.
  • إذا كنت تستخدم عنوان URL الإقليمي لإدارة علاقات العملاء (يحتوي عنوان URL على رقم بعد "crm")، فتأكد من أنك تستخدم المعرّف الإقليمي الصحيح.
  • اتصل بفريق دعم Dynamics للحصول على المساعدة.
    		•
    إذا رأيت 401 Unauthorized ورسالة خطأ متعلقة ب Microsoft Entra، فهذا يعني أن هناك مشكلة في كيان الخدمة. اتبع الإرشادات الواردة في رسالة الخطأ لإصلاح مشكلة كيان الخدمة.
    بالنسبة للأخطاء الأخرى، عادةً ما تكون المشكلة من جانب الخادم. استخدم XrmToolBox لإجراء اتصال. إذا استمر الخطأ، فاتصل بفريق دعم Dynamics للحصول على المساعدة.

رمز الخطأ: DynamicsOperationFailed

  • الرسالة: Dynamics operation failed with error code: %code;, error message: %message;.

  • السبب: فشلت العملية من جانب الخادم.

  • التوصية: استخرج رمز الخطأ لعملية Dynamics من رسالة الخطأ: Dynamics operation failed with error code: {code}، وارجع إلى مقالة رموز خطأ خدمة الويب للحصول على معلومات أكثر تفصيلاً. يمكنك الاتصال بفريق دعم Dynamics إذا لزم الأمر.

رمز الخطأ: DynamicsInvalidFetchXml

  • الرسالة: The Fetch Xml query specified is invalid.

  • السبب: يوجد خطأ في إحضار XML.

  • التوصية: أصلح الخطأ في إحضار XML.

رمز الخطأ: DynamicsMissingKeyColumns

  • الرسالة: Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

  • السبب: لا تحتوي بيانات المصدر على عمود المفتاح لكيان المتلقي.

  • التوصية: تأكد من أن أعمدة المفتاح موجودة في بيانات المصدر أو عيّن عمود مصدر إلى عمود المفتاح في كيان المتلقي.

رمز الخطأ: DynamicsPrimaryKeyMustBeGuid

  • الرسالة: The primary key attribute '%attribute;' must be of type guid.

  • السبب: نوع عمود المفتاح الأساسي ليس "Guid".

  • التوصية: تأكد من أن عمود المفتاح الأساسي في بيانات المصدر من النوع "Guid".

رمز الخطأ: DynamicsAlternateKeyNotFound

  • الرسالة: Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

  • السبب: المفتاح البديل المقدم غير متوفر، وقد يكون ذلك ناتجاً عن أسماء مفاتيح خاطئة أو أذونات غير كافية.

  • التوصية:

    • إصلاح الأخطاء الكتابة في اسم المفتاح.
    • تأكد من أن لديك أذونات كافية على الكيان.

رمز الخطأ: DynamicsInvalidSchemaDefinition

  • الرسالة: The valid structure information (column name and type) are required for Dynamics source.

  • السبب: أعمدة المتلقي في تعيين العمود لا يوجد بها خاصية "النوع".

  • التوصية: يمكنك إضافة خاصية "النوع" إلى تلك الأعمدة في تعيين العمود باستخدام محرر JSON في المدخل.

رمز الخطأ: UserErrorUnsupportedAttributeType

  • الرسالة: The attribute type 'Lookup' of field %attributeName; is not supported

  • السبب: عند تحميل البيانات إلى متلقي Dynamics، يفرض "Azure Data Factory" التحقق من صحة بيانات التعريف لسمة البحث. مع ذلك، هناك المشكلة المعروفة لبعض كيانات Dynamics التي لا تحتوي على بيانات تعريف صالحة لسمة البحث تحتوي على قائمة بالأهداف، ما قد يؤدي إلى فشل التحقق من صحة البيانات.

  • التوصية: اتصل بفريق دعم Dynamics للحد من المشكلة.

يقرأ نشاط النسخ من Dynamics 365 صفوفاً أكثر من العدد الفعلي

  • الأعراض: يقرأ نشاط النسخ من Dynamics 365 عدداً من الصفوف أكثر من العدد الفعلي.

  • السبب: يشير خادم Dynamics 365 دائماً إلى المزيد من السجلات المتوفرة.

  • التوصية: استخدم XrmToolBox لاختبار FetchXML مع الترحيل. يمكن لـ XrmToolBox باستخدام بعض الأدوات المثبتة الحصول على عدد السجلات. لمزيد من المعلومات، راجع XrmToolBox.

لا يمكن الوصول إلى الأعمدة الظاهرية من مصادر Dynamics في نشاط النسخ

  • الأعراض: لا يمكنك الوصول إلى الأعمدة الظاهرية من مصادر Dynamics في نشاط النسخ.

  • السبب: العمود الظاهري غير مدعوم الآن.

  • التوصية: بالنسبة لقيمة "مجموعة الخيارات (Option Set)"، اتبع الخيارات أدناه للحصول عليها:

النسخة المتوازية في مخزن بيانات Dynamics CRM

  • الأعراض: لا تعرف ما إذا كان من الممكن تكوين النسخة المتوازية في مخزن بيانات Dynamics CRM، وأيضاً لا تعرف نطاق القيم التي يمكن تعيينها في "درجة توازي النسخ".

  • التوصية: النسخة المتوازية تتحكم في التوازي، ويمكن تعيين قسم "درجة توازي النسخ" على قيمة غير صفرية. قد يتسبب العدد الكبير في التقييد على جانب خادم Dynamics، مما قد يقلل من معدل النقل، ولكن الآن يتم التعامل مع التقييد عن طريق أخذ عدة تطوير البرامج (SDK) العامة.

    مخطط لقسم درجة توازري النسخ.

تحويل نوع Dynamics

  • الأعراض: تحاول تحويل معرّف فريد "GUID" إلى سلسلة في مصدر Dynamics، لكنك تواجه خطأً.

  • السبب: عند استخدام Dynamics كمصدر، لا يتم دعم تحويل النوع.

  • التوصية: قم بتمكين التقسيم المرحلي وأعد المحاولة.

المحتوى ذو الصلة

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