Gegevensimport uitvoeren
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Het importeren van gegevens wordt direct op de Microsoft Dynamics 365-server uitgevoerd. Als u een gegevensimport wilt uitvoeren, stelt u asynchrone taken voor uitvoering op de achtergrond in die het volgende doen, in deze volgorde:
Brongegevens parseren die zich in het importbestand bevinden.
Geparseerde gegevens parseren met behulp van een gegevenstoewijzing.
Getransformeerde gegevens uploaden in Microsoft Dynamics 365.
Alle Microsoft Dynamics 365-gebruikers die de juiste machtigingen hebben, kunnen gegevensimport uitvoeren.
In dit onderwerp
Brongegevens parseren
Geparseerde gegevens transformeren
Upload de getransformeerde gegevens naar de doelserver.
Fouten vastleggen
Importcontrolegegevens
Brongegevens parseren
Parseren van brongegevens omvat het parseren van alle importbestanden die zijn gekoppeld aan een bepaalde import (gegevensimport).
Geparseerde gegevens worden opgeslagen in de tijdelijke parseertabellen die voor elk geïmporteerd bestand worden gemaakt. De naam van de parseertabel wordt opgeslagen in het kenmerk ImportFile.ParsedTableName. De kolomkoppen van het bronbestand worden opgegeven in het kenmerk ImportFile.HeaderRow. Als het bronbestand geen eerste rij met kolomkoppen bevat, geeft dit kenmerk de door het systeem gegenereerde standaardkolomkoppen op.
Sla geparseerde gegevens in de parseertabel op met het bericht ParseImportRequest. Haal gegevens uit de parseertabel op met het bericht GetDistinctValuesImportFileRequest en het bericht RetrieveParsedDataImportFileRequest.
De volgende tabel bevat de berichten die u kunt gebruiken om de importbestanden te parseren en de geparseerde gegevens op te halen uit de parseertabellen.
Bericht |
Beschrijving |
|---|---|
Stuurt een asynchrone taak die alle importbestanden parseert die zijn gekoppeld aan de opgegeven gegevensimport. Geef de id van de gekoppelde import (gegevensimport) door in de eigenschap ImportId van deze aanvraag. De id van de asynchrone taak die wordt uitgevoerd op de achtergrond en die gegevens parseert, wordt geretourneerd in de eigenschap AsyncOperationId van het bericht. |
|
Levert afzonderlijke waarden op voor een kolom in het bronbestand dat lijstwaarden bevat. Geef de id van het gekoppelde importbestand door in de eigenschap ImportFileId van deze aanvraag. De verschillende waarden worden geretourneerd in een matrix van tekenreeksen, in de eigenschap Values van de berichtrespons. Gebruik dit bericht alleen als u een parseertabel hebt gemaakt met het bericht ParseImportRequest. Belangrijk Gebruik dit bericht niet nadat u het bericht ImportRecordsImportRequest hebt gebruikt. U kunt tot geen toegang tot de parseertabel krijgen nadat de importtaak die is ingediend door het bericht ImportRecordsImportRequest, helemaal is uitgevoerd. |
|
Haalt de gegevens op van de parseertabel. Geef de id van het gekoppelde importbestand door in de eigenschap ImportFileId van deze aanvraag. De geparseerde gegevens worden geretourneerd in een tweedimensionale matrix van tekenreeksen, in de eigenschap Values van de berichtrespons. De gegevens worden geretourneerd met dezelfde kolomvolgorde als de kolomvolgorde in het bronbestand. Gebruik dit bericht alleen als u een parseertabel hebt gemaakt met het bericht ParseImportRequest. Belangrijk Gebruik dit bericht niet nadat u het bericht ImportRecordsImportRequest hebt gebruikt. U kunt tot geen toegang tot de parseertabel krijgen nadat de importtaak die is ingediend door het bericht ImportRecordsMessage, helemaal is uitgevoerd. |
Geparseerde gegevens transformeren
Tijdens de transformatie wijzigt u geparseerde gegevens door alle beschikbare gegevenstoewijzingen en transformaties die zijn gekoppeld aan een bepaalde import (gegevensimport), toe te passen op de gegevens.
Gebruik het bericht TransformImportRequest om een asynchrone taak te verzenden om de geparseerde gegevens te transformeren. Geef een unieke id van de gekoppelde import (gegevensimport) door in het kenmerk Import.ImportId van de aanvraag. Een unieke id van de asynchrone taak die wordt uitgevoerd op de achtergrond en die gegevens transformeert, wordt geretourneerd in de eigenschap AsyncOperationId van de berichtrespons.
Upload de getransformeerde gegevens naar de doelserver.
Nadat u de transformatie met succes hebt voltooid, zijn de gegevens gereed om te worden geüpload naar de Microsoft Dynamics 365-server.
Gebruik het bericht ImportRecordsImportRequest om een asynchrone taak te verzenden om de geparseerde gegevens te uploaden naar Microsoft Dynamics 365. De unieke id van de gekoppelde import (gegevensimport) moet in de eigenschap ImportId van de aanvraag worden opgegeven. Een unieke id van de asynchrone taak die wordt uitgevoerd op de achtergrond en die de gegevens uploadt naar Microsoft Dynamics 365, wordt geretourneerd in de eigenschap AsyncOperationId van de berichtrespons. Alle importbestanden die zijn gekoppeld aan de opgegeven import (gegevensimport), worden geïmporteerd.
Elke importtaak heeft een uniek volgnummer dat wordt opgeslagen in het kenmerk ImportSequenceNumber van records die de taak maakt. Het kenmerk Organization.CurrentImportSequenceNumber bevat een uniek volgnummer van de laatste importtaak die in het systeem is uitgevoerd. U kunt deze unieke volgnummers gebruiken om records te traceren die behoren tot één importtaak.
Fouten vastleggen
Er kan een fout bij het importeren van een record optreden tijdens parseren, transformatie of uploaden van gegevens. De foutredenen en andere gedetailleerde informatie over de records die niet zijn geïmporteerd, worden vastgelegd in het importlogboek (ImportLog).
Als u wilt weten hoeveel records niet goed zijn geïmporteerd, haalt u het kenmerk ImportFile.FailureCount van de record op. Als u wilt controleren hoeveel records gedeeltelijke fouten vertoonden tijdens de import, haalt u het kenmerk ImportData.HasError op. Als het kenmerk HasErrortrue is, fout is er een gedeeltelijke fout opgetreden; als het false is, is de record met succes geïmporteerd.
Importcontrolegegevens
De Microsoft Dynamics 365-entiteiten hebben vier standaardkenmerken die worden gebruikt om de datum en tijd bij te houden waarop een record is gemaakt en voor het laatst is gewijzigd, en de persoon die de record heeft gemaakt en gewijzigd.
Het kenmerk createdon geeft de datum en de tijd op waarop de record is gemaakt. Als u gegevens wilt importeren in het kenmerk createdon, wijst u de bronkolom die deze gegevens bevat, toe aan het kenmerk overriddencreatedon. Tijdens het importeren wordt het kenmerk createdon van de record bijgewerkt met de waarde die is toegewezen aan het kenmerk overriddencreatedon en wordt het kenmerk overriddencreatedon ingesteld op de datum en de tijd waarop de gegevens zijn geïmporteerd. Als geen bronwaarde is toegewezen aan het kenmerk overriddencreatedon, wordt het kenmerk createdon ingesteld op de datum en de tijd waarop de gegevens zijn geïmporteerd en wordt het kenmerk overriddencreatedon ingesteld op geen waarde.
Notitie
Als u de waarde in het kenmerk createdon wilt negeren tijdens het importeren, hebt u de bevoegdheid prvOverrideCreatedOnCreatedBy nodig. De bevoegdheidnaam impliceert dat u ook het kenmerk createdby tijdens het importeren kunt negeren. Deze mogelijkheid wordt op het moment echter niet ondersteund.
U kunt geen gegevens importeren in de kenmerken modifiedon, createdby en modifiedby. Als u gegevens moet opslaan die betrekking hebben op degene die de gegevens heeft gewijzigd en het tijdstip waarop dit is gebeurd, kunt u aangepaste kenmerken maken in Microsoft Dynamics 365 en de bronkolommen toewijzen aan de nieuwe aangepaste kenmerken.
Zie ook
Gegevens importeren
Gegevensimport configureren
Blogbericht: Procedure om programmatisch bijlagen te importeren
Entiteiten voor importeren van gegevens
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht