Kør dataimport
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Dataimport kører direkte på Microsoft Dynamics 365-serveren. For at udføre dataimport skal du oprette asynkrone job, som kører i baggrunden, og som gør følgende i denne rækkefølge:
Fortolker kildedata, som findes i importfilen.
Transformerer fortolkede data ved hjælp af datatilknytningen.
Overfører transformerede data til Microsoft Dynamics 365.
Alle Microsoft Dynamics 365-brugere med de rette tilladelser kan køre dataimport.
Dette emne indeholder
Fortolk datakilde
Transformér fortolkede data
Overfør transformerede data til destinationsserveren
Logfejl
Importér overvågningsdata
Fortolk datakilde
Fortolkning af kildedata omfatter fortolkning af alle importfiler, der er knyttet til en bestemt import (dataimport).
Fortolkede data gemmes i de midlertidige parsingtabeller, der oprettes for alle importerede filer. Navnet på tabellen gemmes i attributten ImportFile.ParsedTableName. Kildefilens kolonneoverskrifter angives i attributten ImportFile.HeaderRow. Hvis kildefilen ikke indeholder en første række, der indeholder kolonneoverskrifterne, angiver denne attribut de systemgenererede standardkolonneoverskrifter.
Gem fortolkede data i parsingtabellen ved hjælp af meddelelsen ParseImportRequest. Hent data fra tabellen ved hjælp af meddelelserne GetDistinctValuesImportFileRequest og RetrieveParsedDataImportFileRequest.
I følgende tabel vises de meddelelser, som du kan bruge til at fortolke importfilerne og hente de fortolkede data fra parsingtabellerne.
Meddelelse |
Beskrivelse |
|---|---|
Sender et asynkront job, der analyserer alle importerede filer, der er knyttet til den angivne import (dataimport). Send id'et for den tilknyttede import (dataimport) i egenskaben ImportId for denne anmodning. Id'et for det asynkrone job, der kører i baggrunden og udfører fortolkning af data, returneres i egenskaben AsyncOperationId for meddelelsessvaret. |
|
Returnerer særskilte værdier for en kolonne i den kildefil, der indeholder listen over værdier. Send id'et for den tilknyttede importfil i egenskaben ImportFileId for denne anmodning. De forskellige værdier returneres i en matrix af strenge i egenskaben Values for meddelelsessvaret. Brug først denne meddelelse, når du har oprettet en parsingtabel ved hjælp af meddelelsen ParseImportRequest. Vigtigt Brug ikke denne meddelelse, når du har brugt meddelelsen ImportRecordsImportRequest. Du kan ikke få adgang til parsingtabellen, når det importjob, der er sendt af meddelelsen ImportRecordsImportRequest, er afsluttet. |
|
Henter data fra parsingtabellen. Send id'et for den tilknyttede importfil i egenskaben ImportFileId for denne anmodning. De fortolkede data returneres i en todimensional matrix af strenge i egenskaben Values for meddelelsessvaret. Dataene returneres med samme kolonnerækkefølge som i kildefilen. Brug først denne meddelelse, når du har oprettet en parsingtabel ved hjælp af meddelelsen ParseImportRequest. Vigtigt Brug ikke denne meddelelse, når du har brugt meddelelsen ImportRecordsImportRequest. Du kan ikke få adgang til parsingtabellen, når det importjob, der er sendt af meddelelsen ImportRecordsMessage, er afsluttet. |
Transformér fortolkede data
Under transformeringen kan du ændre fortolkede data ved at anvende alle tilgængelige datatilknytninger og transformeringer, der er tilknyttet en bestemt import (dataimport), på dataene.
Brug meddelelsen TransformImportRequest til at sende et asynkront job for at transformere de fortolkede data. Send et entydigt id for den tilknyttede import (dataimport) i attributten Import.ImportId for denne anmodning. Der returneres et entydigt id for det asynkrone job, der kører i baggrunden og udfører transformeringen, i egenskaben AsyncOperationId for meddelelsessvaret.
Overfør transformerede data til destinationsserveren
Når du har gennemført transformeringen, er dataene klar til at blive overført til Microsoft Dynamics 365-serveren.
Brug meddelelsen ImportRecordsImportRequest til at sende et asynkront job for at overføre de transformerede data til Microsoft Dynamics 365. Det entydige id for den tilknyttede import (dataimport) skal angives i egenskaben ImportId for denne anmodning. Der returneres et entydigt id for det asynkrone job, der kører i baggrunden og overfører dataene til Microsoft Dynamics 365, i egenskaben AsyncOperationId for meddelelsessvaret. Alle importfiler, som er knyttet til den angivne import (dataimport), importeres.
Hvert importjob har et entydigt sekvensnummer, der lagres i attributten ImportSequenceNumber for poster, der oprettes. Attributten Organization.CurrentImportSequenceNumber indeholder et entydigt sekvensnummer for det seneste importjob, der kørte i systemet. Du kan bruge disse entydige sekvensnumre til at registrere poster, der tilhører ét importjob.
Logfejl
En fejl under import af en post kan forekomme under parsing, transformering eller overførsel af data. Årsagerne til fejl og andre detaljerede oplysninger om de poster, der ikke blev importeret, samles i importlogobjektet (importloggen).
For at finde ud af, hvor mange poster der ikke kunne importeres, skal du hente attributten ImportFile.FailureCount for posten. Hvis du vil kontrollere, hvor mange poster der havde delvise fejl under importen, skal du hente attributten ImportData.HasError. Hvis attributten HasError er true, er der opstået en delvis fejl, og hvis den er false, blev posten importeret korrekt.
Importér overvågningsdata
Microsoft Dynamics 365-objekterne har fire standardattributter, som bruges til at registrere den dato og det klokkeslæt, hvor en post blev oprettet og senest ændret, samt den person, der oprettede og ændrede den.
Attributten createdon angiver den dato og det klokkeslæt, hvor posten blev oprettet. Når du vil importere data til attributten createdon, skal du knytte den kildekolonne, der indeholder disse data, til attributten overriddencreatedon. Under importen opdateres postens createdon-attribut med den værdi, der er knyttet til attributten overriddencreatedon, og attributten overriddencreatedon indstilles til den dato og det klokkeslæt, hvor dataene blev importeret. Hvis der ikke knyttes en kildeværdi til attributten overriddencreatedon, indstilles attributten createdon til den dato og det klokkeslæt, hvor dataene blev importeret, og attributten overriddencreatedon indstilles ikke til nogen værdi.
Bemærk
Du kan tilsidesætte værdien i attributten createdon under import, hvis du har prvOverrideCreatedOnCreatedBy-rettigheder. Bemærk, at du med rettighedsnavnet også kan tilsidesætte attributten createdby under import. Denne mulighed understøttes dog ikke i øjeblikket.
Du kan ikke importere data til attributterne modifiedon, createdby og modifiedby. Hvis du skal gemme data i forbindelse med hvem, der har oprettet og ændret dataene, og hvornår dataene blev ændret sidst, kan du oprette brugerdefinerede attributter i Microsoft Dynamics 365 og knytte kildekolonnerne til de nye brugerdefinerede attributter.
Se også
Importér data
Konfigurere dataimport
Blog Post: Sådan importeres vedhæftede filer programmatisk
Objekter for dataimport
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret