Delen via


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

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

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.

  • Oorzaak: Het probleem is een tijdelijk probleem aan de zijde van de Dynamics-server.

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

Ontbrekende kolommen bij het importeren van een schema of voorbeeldgegevens

  • Symptomen: sommige kolommen ontbreken wanneer u een schema of voorbeeldgegevens importeert. Foutmelding: 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. Raadpleeg 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 aan 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: DynamicsFailedToRequetServer

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

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

  • Aanbeveling: Voor meer informatie controleert u de netwerkverbinding of controleert u het Dynamics-serverlogboek. 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
    U ziet ERROR REQUESTING ORGS FROM THE DISCOVERY SERVERFCB 'EnableRegionalDisco' is disabled. of anders 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' als uw use-case voldoet aan alle 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 voorwaardelijke toegang en/of Multi-Factor Authentication (zie deze koppeling naar het Dataverse-document).
  • Onder deze omstandigheden slaagt de verbinding die vóór 8-6-2021 is 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 voorwaardelijke toegang en/of Multi-Factor Authentication, moet u 'Microsoft Entra-service-principal' gebruiken om na 8-6-2021 te verifiëren. Raadpleeg deze koppeling voor gedetailleerde stappen.
    Als u het foutbericht ziet Office 365 auth with OAuth failed , betekent dit dat uw server mogelijk bepaalde configuraties heeft die niet compatibel zijn met OAuth.
  • Neem contact op met het dynamics-ondersteuningsteam met het gedetailleerde foutbericht voor hulp.
  • Gebruik de verificatie van de service-principal en raadpleeg dit artikel: Voorbeeld: Dynamics Online met behulp van microsoft Entra-service-principal en certificaatverificatie.
  • Als u het foutbericht ziet Unable to retrieve authentication parameters from the serviceUri , betekent dit dat u de verkeerde URL van de Dynamics-service of proxy/firewall invoert om het verkeer te onderscheppen.
  • Zorg ervoor dat u de juiste service-URI in de gekoppelde service hebt geplaatst.
  • Als u de zelf-hostende IR gebruikt, moet u ervoor zorgen dat de firewall/proxy de aanvragen niet onderschept voor de Dynamics-server.
  • 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 (URL heeft een nummer na CRM), moet u ervoor zorgen dat u de juiste regionale id gebruikt.
  • Neem contact op met het dynamics-ondersteuningsteam voor hulp.
  • Als u een foutbericht ziet 401 Unauthorized met betrekking tot Microsoft Entra, 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: Pak de foutcode van de dynamics-bewerking uit het foutbericht uit: Dynamics operation failed with error code: {code}en raadpleeg het artikel Webservice-foutcodes voor meer gedetailleerde informatie. Neem indien nodig contact op 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 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 Dynamics Sink legt Azure Data Factory validatie op voor de metagegevens van het opzoekkenmerk. Er is echter een bekend probleem waarbij bepaalde Dynamics-entiteiten geen geldige metagegevens van het opzoekkenmerk hebben die een lijst met doelen bevatten, waardoor de validatie mislukt.

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

De kopieeractiviteit van Dynamics 365 leest meer rijen dan het werkelijke getal

  • Symptomen: De kopieeractiviteit van dynamics 365 leest meer rijen dan het werkelijke getal.

  • Oorzaak: 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:

De parallelle kopie in een Dynamics CRM-gegevensarchief

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

  • Aanbeveling: De parallelle kopieeropties parallellisme en de sectie 'Mate van kopieerparallelisme' kan worden ingesteld op niet-nulwaarde. Een groot getal kan leiden tot beperking aan de dynamics-serverzijde, wat de doorvoer kan verminderen, maar nu wordt de beperking verwerkt door de openbare SDK te gebruiken.

    Diagram van de sectie Mate van kopieerparallelisme.

Conversie van Dynamics-type

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

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

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

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