Problemen oplossen met de Dynamics 365, Dataverse (Common Data Service) en Dynamics CRM-connectors in Azure Data Factory en Azure Synapse.

Van toepassing op: Azure Data Factory Azure Synapse Analytics

Dit artikel bevat suggesties voor het oplossen van veelvoorkomende problemen met de Dynamics 365, Dataverse (Common Data Service) en Dynamics CRM-connectors in Azure Data Factory en Azure Synapse.

Foutcode: DynamicsCreateServiceClientError

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

• Cause: Het probleem is een tijdelijk probleem aan de serverzijde van Dynamics.

• Aanbeveling: Voer de pijplijn opnieuw uit. Als het opnieuw mislukt, probeert u de parallelle uitvoering te verminderen. Als het probleem zich blijft voordoen, neemt u contact op met Dynamics ondersteuning.

Ontbrekende kolommen bij het importeren van een schema of voorbeeldgegevens

• Symptomen: sommige kolommen ontbreken wanneer u een schema of voorbeeldgegevens importeert. Foutbericht: The valid structure information (column name and type) are required for Dynamics source.

• Oorzaak: dit probleem is standaard, omdat Data Factory- en Synapse-pijplijnen geen kolommen kunnen weergeven die geen waarden bevatten in de eerste tien records. Zorg ervoor dat de kolommen die u hebt toegevoegd, de juiste indeling hebben.

• Aanbeveling: Voeg handmatig de kolommen toe op het tabblad Toewijzing. Zie Expliciete toewijzing voor meer informatie.

Foutcode: DynamicsMissingTargetForMultiTargetLookupField

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

• Oorzaak: De doelkolom bestaat niet in de bron of in de kolomtoewijzing.

• Aanbeveling:

  1. Zorg ervoor dat de bron de doelkolom bevat.
  2. Voeg de doelkolom toe in de kolomtoewijzing. Zorg ervoor dat de sinkkolom de notatie {fieldName}@EntityReference heeft.

Foutcode: DynamicsInvalidTargetForMultiTargetLookupField

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

• Oorzaak: Er wordt een verkeerde entiteitsnaam opgegeven als doelentiteit van een opzoekveld met meerdere doelen.

• Aanbeveling: Geef een geldige entiteitsnaam op voor het opzoekveld met meerdere doelen.

Foutcode: DynamicsInvalidTypeForMultiTargetLookupField

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

• Oorzaak: De waarde in de doelkolom is geen tekenreeks.

• Aanbeveling: Geef een geldige tekenreeks op in de opzoekdoelkolom met meerdere doelen.

Foutcode: DynamicsFailedToRequestServer

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

• Cause: De Dynamics-server is instabiel of niet toegankelijk, of het netwerk ondervindt problemen.

• Aanbeveling: Controleer de netwerkverbinding of controleer het Dynamics serverlogboek voor meer informatie. Neem voor meer hulp contact op met Dynamics ondersteuning.

Foutcode: DynamicsFailedToConnect

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

• Oorzaken en aanbevelingen: Verschillende oorzaken kunnen tot deze fout leiden. Bekijk de onderstaande lijst voor mogelijke oorzaakanalyse en gerelateerde aanbevelingen.

  Oorzaakanalyse	Aanbeveling
  Als u ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. of op een andere manier 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' ziet, voldoet uw use-case aan alle van de volgende drie voorwaarden: U maakt verbinding met Dynamics 365, Common Data Service of Dynamics CRM. U gebruikt Office365-verificatie. Uw tenant en gebruiker zijn geconfigureerd in Microsoft Entra ID voor conditionele toegang en/of meervoudige verificatie (zie deze link naar het Dataverse-document). Onder deze omstandigheden slaagde de verbinding die vóór 8-6-2021 werd gebruikt. Vanaf 9-6-2021 mislukt de verbinding vanwege de afschaffing van de regionale Discovery-service (zie deze koppeling).	Als uw tenant en gebruiker zijn geconfigureerd in Microsoft Entra ID voor conditionele toegang en/of meervoudige verificatie is vereist, moet u 'Microsoft Entra service-principal' gebruiken om na 8-6-2021 te verifiëren. Raadpleeg deze koppeling voor gedetailleerde stappen.
  Als u Office 365 auth with OAuth failed in het foutbericht ziet, betekent dit dat uw server mogelijk enkele configuraties heeft die niet compatibel zijn met OAuth.	Neem contact op met Dynamics ondersteuningsteam met het gedetailleerde foutbericht voor hulp. Gebruik de service-principalverificatie en raadpleeg dit artikel: Voorbeeld: Dynamics online met behulp van Microsoft Entra service-principal en certificaatverificatie.
  Als u Unable to retrieve authentication parameters from the serviceUri in het foutbericht ziet, betekent dit dat u een verkeerde Dynamics-service-URL hebt ingevoerd of dat een proxy/firewall het verkeer onderschept.	Zorg ervoor dat u de juiste service-URI in de gekoppelde service hebt geplaatst. Als u de zelf-gehoste IR gebruikt, zorg ervoor dat de firewall/proxy de aanvragen naar de Dynamics-server niet onderschept.
  Als u het foutbericht ziet An unsecured or incorrectly secured fault was received from the other party , betekent dit dat er onverwachte reacties van de serverzijde zijn ontvangen.	Zorg ervoor dat uw gebruikersnaam en wachtwoord juist zijn als u de Office 365-verificatie gebruikt. Zorg ervoor dat u de juiste service-URI hebt ingevoerd. Als u regionale CRM-URL gebruikt (URL heeft een nummer na 'crm'),controleert u of u de juiste regionale id gebruikt. Neem contact op met het Dynamics ondersteuningsteam voor hulp.
  Als u het foutbericht ziet No Organizations Found , betekent dit dat de naam van uw organisatie onjuist is of dat u een verkeerde CRM-regio-id in de service-URL hebt gebruikt.	Zorg ervoor dat u de juiste service-URI hebt ingevoerd. Als u de regionale CRM URL (de URL heeft een nummer na 'CRM') gebruikt, moet u ervoor zorgen dat u de juiste regionale identificatie gebruikt. Neem contact op met het Dynamics ondersteuningsteam voor hulp.
  Als u 401 Unauthorized en Microsoft Entra gerelateerd foutbericht ziet, betekent dit dat er een probleem is met de service-principal.	Volg de richtlijnen in het foutbericht om het probleem met de service principal op te lossen.
  Bij andere fouten bevindt het probleem zich meestal aan de serverzijde.	Gebruik XrmToolBox om verbinding te maken. Als de fout zich blijft voordoen, neemt u contact op met het Dynamics ondersteuningsteam voor hulp.

Foutcode: DynamicsOperationFailed

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

• Oorzaak: De bewerking is mislukt aan de serverzijde.

• Aanbeveling: Extraheer de foutcode van de dynamics bewerking uit het foutbericht: Dynamics operation failed with error code: {code} en raadpleeg het artikel Webservicefoutcodes voor meer gedetailleerde informatie. U kunt indien nodig contact opnemen met het Dynamics ondersteuningsteam.

Foutcode: DynamicsInvalidFetchXml

• Bericht: The Fetch Xml query specified is invalid.

• Oorzaak: er is een fout opgetreden in de XML-ophalen.

• Aanbeveling: Los de fout in de ophaal-XML op.

Foutcode: DynamicsMissingKeyColumns

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

• Oorzaak: De brongegevens bevatten niet de sleutelkolom voor de sink-entiteit.

• Aanbeveling: Controleer of de sleutelkolommen zich in de brongegevens bevinden of wijs een bronkolom toe aan de sleutelkolom op de sink-entiteit.

Foutcode: DynamicsPrimaryKeyMustBeGuid

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

• Oorzaak: Het type van de primaire sleutelkolom is niet 'Guid'.

• Aanbeveling: zorg ervoor dat de primaire sleutelkolom in de brongegevens van het type GUID is.

Foutcode: DynamicsAlternateKeyNotFound

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

• Oorzaak: de opgegeven alternatieve sleutel bestaat niet, wat kan worden veroorzaakt door verkeerde sleutelnamen of onvoldoende machtigingen.

• Aanbeveling:
  

  • Typfouten in de sleutelnaam corrigeren.
    
  • Zorg ervoor dat u over voldoende machtigingen voor de entiteit beschikt.

Foutcode: DynamicsInvalidSchemaDefinition

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

• Oorzaak: Sinkkolommen in de kolomtoewijzing missen de eigenschap 'type'.

• Aanbeveling: U kunt de eigenschap 'type' toevoegen aan die kolommen in de kolomtoewijzing met behulp van de JSON-editor in de portal.

Foutcode: UserErrorUnsupportedAttributeType

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

• Oorzaak: Bij het laden van gegevens naar de Dynamics-sink voert Azure Data Factory validatie uit op de metagegevens van het opzoekattribuut. Er is echter een bekend probleem met bepaalde Dynamics entiteiten die geen geldige metagegevens van het opzoekkenmerk hebben die een lijst met doelen bevatten, waardoor de validatie mislukt.

• Aanbeveling: Neem contact op met Dynamics ondersteuningsteam om het probleem te verhelpen.

De kopieeractiviteit van Dynamics 365 leest meer rijen dan het daadwerkelijke aantal.

• Symptomen: De kopieeractiviteit uit de Dynamics 365 leest meer rijen dan het werkelijke getal.

• Cause: De Dynamics 365-server geeft altijd meer beschikbare records aan.

• Aanbeveling: Gebruik XrmToolBox om fetchXML te testen met paginering. XrmToolBox met enkele geïnstalleerde hulpprogramma's kan het aantal records ophalen. Zie XrmToolBox voor meer informatie.

Geen toegang tot virtuele kolommen vanuit Dynamics bronnen in de kopieeractiviteit

• Symptomen: U hebt geen toegang tot virtuele kolommen uit Dynamics bronnen in de kopieeractiviteit.

• Oorzaak: De virtuele kolom wordt nu niet ondersteund.

• Aanbeveling: Volg de onderstaande opties voor de waarde van de optieset om deze te verkrijgen:

  • U kunt de StringMap-entiteit koppelen aan uw doelentiteit en de bijbehorende waarden ophalen.

De parallelle kopie in een Dynamics CRM-gegevensarchief

• Symptomen: U weet niet of het mogelijk is om de parallelle kopie te configureren in een Dynamics CRM-gegevensarchief en u weet ook niet welk waardenbereik kan worden ingesteld in de sectie Mate van kopieerparallelisme.

• Aanbeveling: De parallelle kopieeropties regelen het parallellisme, en de sectie 'Mate van kopieerparallelisme' kan worden ingesteld op een niet-nulwaarde. Een groot getal kan leiden tot demping aan de Dynamics-serverzijde, wat de doorvoer kan verminderen. Nu wordt de demping echter beheerd door de openbare SDK.

  

Conversie van Dynamics Type

• Symptomen: u probeert de GUID te converteren naar een tekenreeks in de Dynamics bron, maar er treedt een fout op.

• Cause: Wanneer Dynamics wordt gebruikt als bron, wordt de typeconversie niet ondersteund.

• Aanbeveling: Schakel de fasering in en probeer het opnieuw.

Gerelateerde inhoud

Voor meer hulp bij het oplossen van problemen kunt u de volgende bronnen proberen:

• Handleiding voor het oplossen van problemen met connectors
• Data Factory-blog
• Data Factory-functieaanvragen
• Azure video's
• Microsoft Q&A-pagina
• Stack Overflow-forum voor Data Factory
• X informatie over Data Factory