Del via

Oprette datatilknytninger til import

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

For at importere data til Microsoft Dynamics 365 skal du angive de relevante datatilknytninger.

Eksemplerne på datatilknytninger findes på følgende placering i SDK: SDK\Resources\DataImportMaps\Hent SDK-pakken til Microsoft Dynamics CRM.

Du kan bruge datatilknytninger til at knytte dataene i kildefilen til Microsoft Dynamics 365-objektattributter. Du skal knytte hver kolonne i kildefilen til en passende attribut. Data i ikke-tilknyttede kolonner importeres ikke under en dataimport.

Datatilknytningen repræsenteres af objektet for importtilknytning (datatilknytning). Du kan oprette en ny tilknytning ved hjælp af CreateRequest-meddelelsen eller opdatere en eksisterende tilknytning ved hjælp af IOrganizationService.Update-metoden. Tilknytningen har et entydigt navn, der er indeholdt i ImportMap.Name-attributten. Du kan angive navnet på importkilden, som denne datatilknytning er oprettet til, ved hjælp af ImportMap.Source-attributten.

Dette emne indeholder

Kolonne-, listeværdi- og opslagstilknytninger

Ejertilknytning

Noter og vedhæftede filer

Importere og eksportere datatilknytninger

Kolonne-, listeværdi- og opslagstilknytninger

Hvis du vil knytte en kolonne, listeværdi eller opslagsværdi i kildefilen til en Microsoft Dynamics 365-attribut, skal du bruge følgende tilknytninger:

Kolonnetilknytning

Knytter en kolonne i en kildefil til en Microsoft Dynamics 365-objektattribut. Til kolonnetilknytning skal du bruge objektet for kolonnetilknytning (ColumnMapping). Du kan bruge 1:1 (1 til 1) eller 1:N (én til mange) relationer mellem kilde- og målattributter. Du kan f.eks. knytte firmaadresseoplysninger til både fakturerings- og leveringsadressen i en ordre.

Listeværditilknytning

Knytter en værdi på en liste i en kildefil til en Microsoft Dynamics 365-attribut for OptionSetValue-typen. Brug objektet for valglistetilknytning (PicklistMapping) til listeværditilknytninger.

Hvis en værdi, der er angivet i kildefilens kolonne, er en værdi på en liste, f.eks. OptionSetValue, Status, State og Boolean, skal du angive en listeværditilknytning i tillæg til en kolonnetilknytning. Knyt for eksempel listeværdierne "faktura" og "send" i kildefilen til de tilsvarende værdier i OptionSetValue-typen.

Opslagstilknytning

Knytter en opslagsværdi i en kildefil til en Microsoft Dynamics 365-attribut for EntityReference-typen. Til opslagstilknytning skal du bruge objektet for opslagstilknytning (LookupMapping).

Hvis den værdi, der er angivet i kildefilen, refererer til et objekt, skal du angive en opslagstilknytning for denne værdi. Brug LookupMapping.LookupSourceCode-attributten til at angive, om du vil søge efter det refererede objekt i kildefilen eller i Microsoft Dynamics 365. Hvis du bruger tidlige bundne typer, kan du bruge LookupSourceType-optællingen til at angive opslagsværdierne. Hvis du vil søge i kildefilen, skal du bruge LookupSourceType.Source-værdien. Søg i Microsoft Dynamics 365 ved at bruge LookupSourceType.System-værdien. Du kan se en liste over LookupSourceCode-værdierne i valglisteværdierne for dette objekt.Du kan få vist objektmetadataene for din virksomhed ved at installere Metadata-browserløsningen, der er beskrevet i Gennemse metadata for organisationen. Du kan også få vist metadataene for en ikke-tilpasset virksomhed i Excel-filen kaldet EntityMetadata.xlsx, der findes i den øverste mappe i SDK download. Du kan angive flere opslagstilknytninger. Det asynkrone transformeringsjob behandler alle tilgængelige tilknytninger. Det finder poster, der refereres til, og opdaterer analysetabellen med de entydige post-id'er. Du kan finde flere oplysninger under Kør dataimport.

Ejertilknytning

Brug ejertilknytningen for at tilknytte en bruger, der er angivet i kildefilen, til en bruger i Microsoft Dynamics 365. Oplysninger om logføring får du ved at bruge Microsoft Dynamics 365-brugerens logonnavn. Til ejertilknytning skal du bruge objektet for ejertilknytning (OwnerMapping).

Noter og vedhæftede filer

Tilknytningen af noter og vedhæftede filer håndteres anderledes fra andre objekter. Noter og vedhæftede filer bruges til at tilføje yderligere oplysninger i en post i Microsoft Dynamics 365. Noter gemmes som tekst, og vedhæftede filer gemmes som filer i Microsoft Dynamics 365-databasen.

Hvis du vil oprette en note i Microsoft Dynamics 365, skal du angive Annotation.IsDocument-attributten i anmærkningsobjektet (note) til false. Hvis du vil oprette en vedhæftet fil, skal du angive IsDocument til true.

Brug følgende indstillinger til tilknytning af noter og vedhæftede filer:

  • Indstil ColumnMapping.SourceAttributeName-attributten til "true" eller "false". Værdien "true" angiver en vedhæftet fil. Værdien "false" angiver en note.

  • Indstil ColumnMapping.TargetAttributeName-attributten til IsDocument.

  • Hvis du bruger tidlige bundne typer, skal du indstille ColumnMapping.ProcessCode-attributten til ImportProcessCode.Internal-værdien af ImportProcessCode-optællingen. Du kan se en liste over ProcessCode-værdierne i valglisteværdierne for dette objekt.

Hvis kildedataene repræsenterer en note, skal du knytte noteteksten til Annotation.NoteText-attributten. Hvis du arbejder med Salesforce-filer, gemmes de normalt på disken under entydige identifikationsnumre. Hvis du vil importere en vedhæftet fil, skal du knytte et id for filen, der findes i kildefilen, til Annotation.DocumentBody-attributten.DocumentBody-attributten gemmer indholdet af den vedhæftede fil.

Det asynkrone importjob kontrollerer for tilknytninger med kildeattributnavnet angivet til "true" og "false" for at finde noter og vedhæftede filer. Hvis det finder en vedhæftningstilknytning, søger det efter de angivne filer på disken og overfører filindholdet som vedhæftede filer til Microsoft Dynamics 365. Hvis en fil ikke findes, returneres en fejl.

Hvis du ikke angiver en tilknytning for et anmærkningsobjekt (note), genererer importjobbet en standardtilknytning til noten.

Bemærk

Maksimumstørrelsen på de filer, du kan overføre, bestemmes af egenskaben Organization.MaxUploadFileSize. Denne egenskab angives under fanen Mail under Systemindstillinger i Dynamics 365-programmet. Denne indstilling begrænser størrelsen på filer, der kan vedhæftes mailmeddelelser, noter og webressourcer. Standardindstillingen er 5 MB. Men størrelsen på vedhæftede filer må ikke overstige den maksimale HTTP-anmodningsstørrelse (standard er 16 MB). For at få ændringen til at træde i kraft skal du nulstille IIS (Internet Information Services). Det kan du gøre ved at klikke på Start, klikke på Kør, skrive iisreset og derefter klikke på OK.

Importere og eksportere datatilknytninger

Du kan eksportere en eksisterende datatilknytning til en XML-fil og importere XML-datatilknytninger til Microsoft Dynamics 365. Du kan eksportere en datatilknytning fra Microsoft Dynamics 365 ved at bruge ExportMappingsImportMapRequest-meddelelsen. Du kan importere XML-datatilknytninger og oprette en datatilknytning i Microsoft Dynamics 365 ved at bruge ImportMappingsImportMapRequest-meddelelsen.

Se også

Importér data
Tilføje transformeringstilknytninger for import
Tilføje transformeringstilknytninger for import

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret