استكشاف الأخطاء المتعلقة بموصلات 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;'.
السبب: العمود الهدف غير موجود في المصدر أو في تعيين العمود.
التوصية:
- تأكد من احتواء المصدر على العمود الهدف.
- أضف العمود الهدف في تعيين العمود. تأكد من أن عمود المتلقي بالتنسيق {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)"، اتبع الخيارات أدناه للحصول عليها:
- يمكنك الحصول على رمز نوع العنصر من خلال الرجوع إلى كيفية البحث عن رمز نوع العنصر لأي كيان.
- يمكنك ربط كيان StringMap بالكيان الهدف والحصول على القيم المرتبطة.
النسخة المتوازية في مخزن بيانات Dynamics CRM
الأعراض: لا تعرف ما إذا كان من الممكن تكوين النسخة المتوازية في مخزن بيانات Dynamics CRM، وأيضاً لا تعرف نطاق القيم التي يمكن تعيينها في "درجة توازي النسخ".
التوصية: النسخة المتوازية تتحكم في التوازي، ويمكن تعيين قسم "درجة توازي النسخ" على قيمة غير صفرية. قد يتسبب العدد الكبير في التقييد على جانب خادم Dynamics، مما قد يقلل من معدل النقل، ولكن الآن يتم التعامل مع التقييد عن طريق أخذ عدة تطوير البرامج (SDK) العامة.
تحويل نوع Dynamics
الأعراض: تحاول تحويل معرّف فريد "GUID" إلى سلسلة في مصدر Dynamics، لكنك تواجه خطأً.
السبب: عند استخدام Dynamics كمصدر، لا يتم دعم تحويل النوع.
التوصية: قم بتمكين التقسيم المرحلي وأعد المحاولة.
المحتوى ذو الصلة
لمزيد من تعليمات استكشاف الأخطاء وإصلاحها، جرب هذه الموارد: