Résoudre les problèmes liés aux connecteurs Dynamics 365, Dataverse (Common Data Service) et Dynamics CRM dans Azure Data Factory et Azure Synapse

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Cet article fournit des suggestions pour résoudre les problèmes courants liés aux connecteurs Dynamics 365, Dataverse (Common Data Service) et Dynamics CRM dans Azure Data Factory et Azure Synapse.

Code d’erreur : DynamicsCreateServiceClientError

• Message : This is a transient issue on Dynamics server side. Try to rerun the pipeline.

• Cause : Il s’agit d’un problème temporaire du côté du serveur Dynamics.

• Recommandation : Réexécutez le pipeline. Si l’échec persiste, essayez de réduire le parallélisme. Si le problème persiste, contactez le support Dynamics.

Colonnes manquantes lorsque vous importez un schéma ou prévisualisez des données

• Symptômes : Certaines colonnes sont manquantes lorsque vous importez un schéma ou prévisualisez des données. Message d’erreur : The valid structure information (column name and type) are required for Dynamics source.

• Cause : Ce problème est lié à la conception, car Data Factory et les pipelines Synapse ne peuvent pas afficher les colonnes qui ne contiennent pas de valeurs dans les 10 premiers enregistrements. Assurez-vous que les colonnes que vous avez ajoutées sont au format correct.

• Recommandation : Ajoutez manuellement les colonnes sous l’onglet de mappage. Pour plus d’informations, consultez Mappage explicite.

Code d’erreur : DynamicsMissingTargetForMultiTargetLookupField

• Message : Cannot find the target column for multi-target lookup field: '%fieldName;'.

• Cause : La colonne cible n’existe pas dans la source ou dans le mappage de colonnes.

• Recommandation :

  1. Assurez-vous que la source contient la colonne cible.
  2. Ajoutez la colonne cible dans le mappage de colonnes. Assurez-vous que la colonne du récepteur est au format {fieldName}@EntityReference.

Code d’erreur : DynamicsInvalidTargetForMultiTargetLookupField

• Message : The provided target: '%targetName;' is not a valid target of field: '%fieldName;'. Valid targets are: '%validTargetNames;'

• Cause : Un nom d’entité incorrect est fourni en tant qu’entité cible d’un champ de recherche à plusieurs cibles.

• Recommandation : Fournissez un nom d’entité valide pour le champ de recherche à plusieurs cibles.

Code d’erreur : DynamicsInvalidTypeForMultiTargetLookupField

• Message : The provided target type is not a valid string. Field: '%fieldName;'.

• Cause : La valeur dans la colonne cible n’est pas une chaîne.

• Recommandation : Fournissez une chaîne valide dans la colonne cible de recherche à plusieurs cibles.

Code d’erreur : DynamicsFailedToRequetServer

• Message : The Dynamics server or the network is experiencing issues. Check network connectivity or check Dynamics server log for more details.

• Cause : Le serveur Dynamics est instable ou inaccessible ou le réseau rencontre des problèmes.

• Recommandation : Pour plus d’informations, vérifiez la connectivité réseau ou consultez le journal du serveur Dynamics. Pour obtenir de l’aide supplémentaire, contactez le support Dynamics.

Code d’erreur : DynamicsFailedToConnect

• Message : Failed to connect to Dynamics: %message;

• Causes et recommandations : Différentes causes peuvent être à l’origine de cette erreur. Consultez la liste ci-dessous pour obtenir une analyse des causes possibles et des recommandations associées.

  Analyse de la cause	Recommandation
  Vous voyez ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. ou 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' si votre cas d’usage remplit les trois conditions suivantes : Vous vous connectez à Dynamics 365, Common Data Service ou Dynamics CRM. Vous utilisez l’authentification Office 365. Votre locataire et votre utilisateur sont configurés dans Microsoft Entra ID pour l’accès conditionnel ou l’authentification multifacteur est requise (voir ce lien vers la documentation de Dataverse). Dans ces circonstances, la connexion aboutissait avant le 08/06/2021. À partir du 09/06/2021, la connexion commencera à échouer en raison de la dépréciation du service de découverte régional (voir ce lien).	Si votre locataire et votre utilisateur sont configurés dans Microsoft Entra ID pour l’accès conditionnel ou que l’authentification multifacteur est requise, vous devez utiliser le « principal de service Microsoft Entra » pour l’authentification après le 08/06/2021. Pour obtenir des instructions détaillées, référez-vous à ce lien.
  Si vous voyez Office 365 auth with OAuth failed dans le message d’erreur, cela signifie que votre serveur peut avoir des configurations non compatibles avec OAuth.	Contactez l’équipe du support technique de Dynamics avec le message d’erreur détaillé pour obtenir de l’aide. Utilisez l’authentification du principal de service. Pour cela, vous pouvez vous référer à cet article : Exemple : Dynamics en ligne à l’aide du principal de service Microsoft Entra et de l’authentification du certificat.
  Si vous voyez Unable to retrieve authentication parameters from the serviceUri dans le message d’erreur, cela signifie que vous entrez une URL de service Dynamics ou un proxy/pare-feu incorrect pour intercepter le trafic.	Assurez-vous que vous avez placé l’URI de service correct dans le service lié. Si vous utilisez le runtime d’intégration auto-hébergé, assurez-vous que le pare-feu/proxy n’intercepte pas les demandes adressées au serveur Dynamics.
  Si vous voyez An unsecured or incorrectly secured fault was received from the other party dans le message d’erreur, cela signifie que des réponses inattendues ont été obtenues du côté serveur.	Vérifiez que votre nom d’utilisateur et votre mot de passe sont corrects si vous utilisez l’authentification Office 365. Vérifiez que vous avez entré le bon URI de service. Si vous utilisez l’URL CRM régionale (l’URL comporte un chiffre après « crm »), veillez à utiliser le bon identifiant régional. Contactez l’équipe du support technique de Dynamics pour obtenir de l’aide.
  Si vous voyez No Organizations Found dans le message d’erreur, cela signifie que le nom de votre organisation est incorrect ou que vous avez utilisé un identificateur de région CRM erroné dans l’URL du service.	Vérifiez que vous avez entré le bon URI de service. Si vous utilisez l’URL CRM régionale (l’URL comporte un chiffre après « crm »), veillez à utiliser le bon identifiant régional. Contactez l’équipe du support technique de Dynamics pour obtenir de l’aide.
  Si vous voyez 401 Unauthorized et un message d’erreur relatif à Microsoft Entra, cela signifie qu’il y a un problème avec le principal du service.	Suivez les instructions du message d’erreur pour corriger le problème du principal de service.
  Pour les autres erreurs, le problème se trouve généralement côté serveur.	Utilisez XrmToolBox pour établir la connexion. Si l’erreur persiste, contactez l’équipe du support technique de Dynamics pour obtenir de l’aide.

Code d’erreur : DynamicsOperationFailed

• Message : Dynamics operation failed with error code: %code;, error message: %message;.

• Cause : L’opération a échoué côté serveur.

• Recommandation : Extrayez le code d’erreur de l’opération Dynamics à partir du message d’erreur : Dynamics operation failed with error code: {code} et reportez-vous à l’article Codes d’erreur de service web pour obtenir des informations plus détaillées. Vous pouvez contacter l’équipe du support technique de Dynamics si nécessaire.

Code d’erreur : DynamicsInvalidFetchXml

• Message : The Fetch Xml query specified is invalid.

• Cause : Il existe une erreur dans le fichier XML récupéré (fetch).

• Recommandation : Corrigez l’erreur dans le fichier XML récupéré (fetch).

Code d’erreur : DynamicsMissingKeyColumns

• Message : Input DataSet must contain keycolumn(s) in Upsert/Update scenario. Missing key column(s): %column;

• Cause : Les données sources ne contiennent pas la colonne clé pour l’entité récepteur.

• Recommandation : Confirmez que les colonnes clés se trouvent dans les données sources ou mappez une colonne source à la colonne clé de l’entité récepteur.

Code d’erreur : DynamicsPrimaryKeyMustBeGuid

• Message : The primary key attribute '%attribute;' must be of type guid.

• Cause : Le type de la colonne de clé primaire n’est pas « GUID ».

• Recommandation : Assurez-vous que la colonne de clé primaire dans les données sources est de type « GUID ».

Code d’erreur : DynamicsAlternateKeyNotFound

• Message : Cannot retrieve key information of alternate key '%key;' for entity '%entity;'.

• Cause : La clé de remplacement fournie n’existe pas, ce qui peut être dû à des noms de clé incorrects ou à des autorisations insuffisantes.

• Recommandation :
  

  • Corrigez les fautes de frappe dans le nom de la clé.
    
  • Assurez-vous que vous disposez des autorisations suffisantes sur l’entité.

Code d’erreur : DynamicsInvalidSchemaDefinition

• Message : The valid structure information (column name and type) are required for Dynamics source.

• Cause : Les colonnes de récepteur dans le mappage de colonne n’ont pas la propriété « type ».

• Recommandation : Vous pouvez ajouter la propriété « type »à ces colonnes dans le mappage de colonnes à l’aide de l’éditeur JSON sur le portail.

Code d’erreur : UserErrorUnsupportedAttributeType

• Message : The attribute type 'Lookup' of field %attributeName; is not supported

• Cause : lors du chargement de données sur le récepteur Dynamics, Azure Data Factory impose une validation sur les métadonnées de l’attribut de recherche. Toutefois, il existe le problème connu de certaines entités Dynamics qui n’ont pas de métadonnées d’attribut de recherche valides qui contiennent une liste de cibles, ce qui échouerait à la validation.

• Recommandation : Contactez l’équipe du support technique Dynamics pour résoudre le problème.

L’activité de copie de Dynamics 365 lit plus de lignes que le nombre réel

• Symptômes : l’activité de copie de Dynamics 365 lit plus de lignes que le nombre réel.

• Cause : le serveur Dynamics 365 indique toujours plus d’enregistrements disponibles.

• Recommandation : utilisez XrmToolBox pour tester le FetchXML avec la pagination. XrmToolBox avec certains outils installés peut obtenir le nombre d’enregistrements. Pour plus d'informations, consultez XrmToolBox.

Impossible d’accéder aux colonnes virtuelles à partir de sources Dynamics dans l’activité de copie

• Symptômes : impossible d’accéder aux colonnes virtuelles à partir de sources Dynamics dans l’activité de copie.

• Cause : la colonne virtuelle n’est pas prise en charge pour le moment.

• Recommandation : pour la valeur Groupe d’options, suivez les options ci-dessous pour l’obtenir :

  • Vous pouvez obtenir le code de type d’objet en vous référant à la façon de rechercher le code de type d’objet pour une entité.
  • Vous pouvez lier l’entité StringMap à votre entité cible et obtenir les valeurs associées.

Copie parallèle dans une banque de données Dynamics CRM

• Symptômes : vous ne savez pas s’il est possible de configurer la copie parallèle dans une banque de données Dynamics CRM et vous ne connaissez pas la plage de valeurs qui peuvent être définies dans la section « Degré de parallélisme de la copie ».

• Recommandation : la copie parallèle contrôle le parallélisme et la section « Degré de parallélisme de la copie » peut être définie sur une valeur différente de zéro. Un grand nombre peut entraîner une limitation du côté du serveur Dynamics, ce qui peut réduire le débit, mais la limitation est maintenant gérée avec le kit de développement logiciel (SDK) public.

  

Conversion de type dynamique

• Symptômes : vous essayez de convertir le GUID en une chaîne dans la source Dynamics, mais vous rencontrez une erreur.

• Cause : lorsque Dynamics est utilisé en tant que source, la conversion de type n’est pas prise en charge.

• Recommandation : activez la mise en lots et réessayez.

Contenu connexe

Si vous avez besoin d’une aide supplémentaire, essayez les ressources suivantes :

• Guide de résolution des problèmes de connecteur
• Blog Data Factory
• Demandes de fonctionnalités Data Factory
• Vidéos Azure
• Page Microsoft Q&A
• Forum Stack Overflow pour Data Factory
• Informations de X sur Data Factory