Gegevensmappen maken voor import

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Om gegevens te importeren in Microsoft Dynamics 365, moet u hiervoor de geschikte gegevenstoewijzingen bieden.

De voorbeelden van de gegevenstoewijzingen kunnen worden gevonden in deze locatie in de SDK: SDK\Resources\DataImportMaps\.Download het Microsoft Dynamics CRM SDK-pakket.

U kunt gegevenstoewijzingen gebruiken om de gegevens in het bronbestand toe te wijzen aan de Microsoft Dynamics 365 entiteitkenmerken. U moet elke kolom in het bronbestand aan het juiste kenmerk toewijzen. De gegevens in de niet-toegewezen kolommen worden niet geïmporteerd tijdens het importeren van gegevens.

De gegevenstoewijzing wordt vertegenwoordigd door de entiteit importtoewijzing (gegevenstoewijzing). U kunt een nieuwe toewijzing maken door het bericht CreateRequest te gebruiken of een bestaande toewijzing bij te werken met behulp van de methode IOrganizationService.Update. De toewijzing heeft een unieke naam die in het kenmerk ImportMap.Name is bevat. U kunt de naam van de importbron opgeven waarvoor deze gegevenstoewijzing wordt gemaakt met behulp van het kenmerk ImportMap.Source.

In dit onderwerp

Kolom, lijstwaarde en opzoektoewijzingen

Eigenaartoewijzing

Notities en bijlagen

Gegevenstoewijzingen importeren en exporteren

Kolom, lijstwaarde en opzoektoewijzingen

Om een kolom, een lijstwaarde of opzoekwaarde in het bronbestand toe te wijzen aan een Microsoft Dynamics 365 kenmerk, gebruikt u de volgende toewijzingen:

Kolomtoewijzing

Hiermee wordt een kolom in een bronbestand toegewezen aan een Microsoft Dynamics 365 entiteitskenmerk. Voor kolomtoewijzing gebruikt u de entiteit kolomtoewijzing (ColumnMapping). U kunt 1:1 (een-op-een) of 1:N (een-op-veel) relaties tussen bron- en doelkenmerken gebruiken. U kunt bijvoorbeeld adresgegevens in een account toewijzen aan zowel het factuuradres als het verzendadres in een order.

Lijstwaardetoewijzing

Hiermee wordt een lijstwaarde in een bronbestand toegewezen aan een Microsoft Dynamics 365 kenmerk van het type OptionSetValue. Voor het toewijzen van lijstwaarden, gebruikt u de entiteit selectielijsttoewijzing (PicklistMapping).

Als een opgegeven waarde in de bronbestandskolom een lijstwaarde is, zoals OptionSetValue, staat, status en Booleaans, moet u een lijstwaardetoewijzing toevoegen aan een kolomtoewijzing. Wijs bijvoorbeeld de lijstwaarden "rekening" en "verzenden" in het bronbestand toe aan de waarden rekening en verzenden van het type OptionSetValue.

Opzoektoewijzing

Hiermee wordt een opzoekwaarde in een bronbestand toegewezen aan een Microsoft Dynamics 365 kenmerk van het type EntityReference. Voor opzoektoewijzing gebruikt u de entiteit opzoektoewijzing (LookupMapping).

Als de opgegeven waarde in het bronbestand verwijst naar een entiteit, moet u een opzoektoewijzing voor deze waarde bieden. Gebruik het kenmerk LookupMapping.LookupSourceCode om op te geven of de entiteit waarnaar wordt verwezen in het bronbestand of binnen Microsoft Dynamics 365 moet worden gezocht. Als u eerder gebonden typen gebruikt, gebruikt u de opsomming LookupSourceType om de opzoekwaarden in te stellen. Om in het bronbestand te zoeken, kunt u de waarde LookupSourceType.Source gebruiken. Om in Microsoft Dynamics 365 te zoeken, gebruikt u de waarde LookupSourceType.System. Voor een overzicht van de waarden LookupSourceCode, zie de selectielijstwaarden voor deze entiteit.Als u de metagegevens van de entiteit voor uw organisatie wilt bekijken, installeert u de oplossing Metadata Browser die wordt beschreven in Blader door de metagegevens voor uw organisatie. U kunt ook metagegevens weergeven voor een niet-aangepaste organisatie in het Excel-bestand EntityMetadata.xlsx, in de bovenste map van SDK download. U kunt meerdere opzoektoewijzingen bieden. De asynchrone transformatietaak verwerkt alle beschikbare toewijzingen. Deze vindt de records waarnaar wordt verwezen en werkt de parseertabel bij met de recordunieke id's. Zie Gegevensimport uitvoeren voor meer informatie.

Eigenaartoewijzing

Gebruik toewijzing van gebruikseigenaar om een gebruiker in het bronbestand toe te wijzen aan een gebruiker in Microsoft Dynamics 365. Voor logboekinformatie, gebruikt u de Microsoft Dynamics 365 aanmeldingsnaam. Voor eigenaartoewijzing gebruikt u de entiteit eigenaartoewijzing (OwnerMapping).

Notities en bijlagen

Toewijzing voor notities en bijlagen wordt anders uitgevoerd dan bij andere entiteiten. Notities en bijlagen worden gebruikt om aanvullende informatie toe te voegen aan een record in Microsoft Dynamics 365. Notities worden opgeslagen als tekst en bijlagen worden opgeslagen als bestanden in de Microsoft Dynamics 365 database.

Als u een notitie maakt in Microsoft Dynamics 365, stelt u het kenmerk Annotation.IsDocument in de entiteit annotatie (opmerking) in op false. Als u een bijlage wilt maken, stelt u IsDocument in op true.

Gebruik de volgende instellingen voor het toewijzen van notities en bijlagen:

• Stel het kenmerk ColumnMapping.SourceAttributeName in op “true” of “false”. De waarde van "true" geeft een bijlage aan. De waarde van "false" geeft een notitie aan.

• Stel het kenmerk ColumnMapping.TargetAttributeName in op IsDocument.

• Stel het kenmerk ColumnMapping.ProcessCode in op de waarde ImportProcessCode.Internal van de opsomming ImportProcessCode als u eerder gebonden types gebruikt. Voor een overzicht van de ProcessCode-waarden, zie de selectielijstwaarden voor deze entiteit.

Als de brongegevens een notitie zijn, wijst u de tekst van de notitie toe aan het kenmerk Annotation.NoteText. Als u met Salesforce-bestanden werkt, worden deze meestal opgeslagen op de schijf onder unieke identificatienummers. Als u een bijlage wilt importeren, moet u een bestandidentificatienummer in het bronbestand toewijzen aan het kenmerk Annotation.DocumentBody. Het kenmerk DocumentBody slaat de inhoud van de bijlage op.

De asynchrone importtaak controleert op toewijzingen waarvan de bronkenmerknaam is ingesteld op "true" en "false" om aantekeningen en bijlagen te ontdekken. Als een bijlagetoewijzing wordt gevonden, wordt gezocht naar de specifieke bestanden op de schijf en wordt de bestandsinhoud als bijlage geüpload naar Microsoft Dynamics 365. Als een bestand niet wordt gevonden, wordt een fout geretourneerd.

Als u geen toewijzing voor een entiteit annotatie (notitie) opgeeft, genereert de importtaak een standaardtoewijzing voor de notitie.

Notitie

De maximale bestandsgrootte voor uploaden wordt bepaald door de eigenschap Organization.MaxUploadFileSize. Deze eigenschap wordt ingesteld op het tabblad E-mail van de Systeeminstellingen in de CRM-toepassing. Met deze instelling kunt u de bestandsgrootte beperken van bestanden die aan e-mailberichten, notities en webresources kunnen worden toegevoegd. De standaardinstelling is 5 MB. Een bijlagegrootte mag echter niet groter zijn dan de maximale HTTP-aanvraaggrootte (standaardwaarde is 16MB). Om de wijzigen van kracht te laten worden, moet u Internet Information Services (IIS) resetten. U doet dit door op Start en Uitvoeren te klikken, iisreset te typen en op OK te klikken.

Gegevenstoewijzingen importeren en exporteren

U kunt een bestaande gegevenstoewijzing exporteren naar een XML-bestand en XML-gegevenstoewijzingen importeren in Microsoft Dynamics 365. Om een gegevenstoewijzing te exporteren van Microsoft Dynamics 365, gebruikt u het bericht ExportMappingsImportMapRequest. Om XML-gegevenstoewijzingen te importeren en een gegevenstoewijzing te maken in Microsoft Dynamics 365, gebruikt u het bericht ImportMappingsImportMapRequest.

Zie ook

Gegevens importeren
Transformatietoewijzingen toevoegen voor importeren
Transformatietoewijzingen toevoegen voor importeren

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht