Erstellen von Datenzuordnungen für den Import
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Um Daten in Microsoft Dynamics 365 zu importieren, müssen die entsprechenden Datenzuordnungen bereitstellen.
Diese Beispiele von Datenzuordnungen sind an folgender Position im SDK zu finden: SDK\Resources\DataImportMaps\.Laden Sie das Microsoft Dynamics CRM SDK-Paket herunter.
Verwenden Sie die Datenzuordnungen, um die Daten in der Quelldatei den Microsoft Dynamics 365-Entitätsattributen zuzuordnen. Sie müssen jede Spalte in der Quelldatei einem entsprechenden Attribut zuordnen. Die Daten in den nicht zugeordneten Spalten werden während des Vorgangs des Datenimports nicht importiert.
Die Datenzuordnung wird durch die Importzuordnungsentität (Datenzuordnung) dargestellt. Sie können eine neue Zuordnung erstellen, indem Sie die CreateRequest-Meldung verwenden, oder eine bestehende Zuordnung aktualisieren, indem Sie IOrganizationService.Update-Methode anwenden. Die Zuordnung besitzt einen eindeutigen Namen, der im Attribut ImportMap.Name enthalten ist. Sie können den Namen der Importquelle angeben, für die diese Datenzuordnung erstellt wird, indem Sie das Attribut ImportMap.Source verwenden.
In diesem Thema
Spalte, Listenwert und Suchzuordnungen
Besitzerzuordnung
Notizen und Anlagen
Import und Export von Datenzuordnungen
Spalte, Listenwert und Suchzuordnungen
Um eine Spalte, einen Listenwert oder einen Suchwert in der Quelldatei einem Microsoft Dynamics 365-Attribut zuzuordnen, verwenden Sie die folgenden Zuordnungen:
Spaltenzuordnung
Ordnet eine Spalte in einer Quelldatei einem Microsoft Dynamics 365-Entitätsattribut zu. Für Spaltenzuordnungen können Sie die Spaltenzuordnungsentität (ColumnMapping) verwenden. Sie können 1:1-Beziehungen (eins-zu-eins) oder 1:n-Beziehungen (eins-zu-vielen) zwischen Quell- und Zielattributen verwenden. Beispielsweise können Sie die Adressinformationen einer Firma sowohl der Rechnungs- als auch der Lieferadresse in einer Bestellung zuordnen.
Listenwertzuordnung
Ordnet einen Listenwert in einer Quelldatei einem Microsoft Dynamics 365-Attribut des Typs OptionSetValue zu. Bei der Zuordnung von Listenwerten können Sie die Auswahllistenzuordnungsentität (PicklistMapping) verwenden.
Ist ein in der Quelldateispalte angegebener Wert einen Listenwert wie OptionSetValue, Status, Zustand und Boolesche, müssen Sie neben der Spaltenzuordnung auch eine Listenwertzuordnung. Ordnen Sie beispielsweise die Listenwerte "Rechnung" sowie "Versand" in der Quelldatei den Rechnungs- und Versandwerten des Typs OptionSetValue zu.
Suchzuordnung
Ordnet einen Suchwert in einer Quelldatei einem Microsoft Dynamics 365-Attribut des Typs EntityReference zu. Für Suchzuordnungen können Sie die Suchzuordnungsentität (LookupMapping) verwenden.
Wenn der in der Quelldatei angegebene Wert auf eine Entität verweist, müssen Sie für diesen Wert eine Suchzuordnung bereitstellen. Verwenden Sie das Attribut LookupMapping.LookupSourceCode, um anzugeben, ob die referenzierte Entität in der Quelldatei oder innerhalb von Microsoft Dynamics 365 gesucht werden soll. Wenn Sie Typen mit früherer Bindung verwenden, können Sie die LookupSourceType-Enumeration verwenden, um die Statuswerte festzulegen. Um in der Quelldatei zu suchen, verwenden Sie den LookupSourceType.Source-Wert. Um innerhalb von Microsoft Dynamics 365 zu suchen, verwenden Sie den LookupSourceType.System-Wert. Eine Liste der LookupSourceCode-Werte finden Sie in den Werten der Auswahlliste für diese Entität.Zum Anzeigen der Entitätsmetadaten für Ihre Organisation installieren Sie die Metadatenbrowserlösung, die in Durchsuchen der Metadaten für die Organisation beschrieben ist. Sie können auch die Metadaten für ein nicht angepasstes Unternehmen in einer Excel-Tabellenkalkulation mit der Bezeichnung EntityMetadata.xlsx anzeigen, die im obersten Ordner des SDK-Downloads enthalten ist. Sie können mehrere Suchzuordnungen bereitstellen. Der asynchrone Transformationsauftrag verarbeitet alle verfügbaren Zuordnungen. Er findet die Datensätze, auf die verwiesen wird, und aktualisiert die Analysetabelle mit den eindeutigen Kennungen der Datensätze. Weitere Informationen finden Sie unter Ausführen des Datenimports.
Besitzerzuordnung
Verwenden Sie die Besitzerzuordnung, um einen in der Quelldatei angegebenen Benutzer einem Benutzer in Microsoft Dynamics 365 zuzuordnen. Für das Protokollieren von Information können Sie den Benutzeranmeldenamen Microsoft Dynamics 365 verwenden. Für Besitzerzuordnungen können Sie die Besitzerzuordnungsentität (OwnerMapping) verwenden.
Notizen und Anlagen
Zuordnung für Notizen und Anlagen werden im Vergleich zu anderen Entitäten jedoch unterschiedlich behandelt. Notizen und Anlagen werden verwendet, um zusätzliche Informationen an einen Datensatz in Microsoft Dynamics 365 anzufügen. Notizen werden Text als gespeichert, Anlagen dagegen als Dateien in der Microsoft Dynamics 365 - Datenbank.
Um eine Notiz in Microsoft Dynamics 365 zu erstellen, setzen Sie des Wert des Attribut Annotation.IsDocument in der Anmerkung (Notiz) auf false. Um eine Anlage zu erstellen, Setzen Sie IsDocument auf true.
Verwenden Sie die folgenden Einstellungen für die Zuordnung von Notizen und Anlagen:
Setzen Sie das Attribut ColumnMapping.SourceAttributeName auf den Wert "true" oder "false": Der Wert "true" zeigt eine Anlage an. Der Wert "false" zeigt eine Notiz an.
Setzen Sie das Attribut ColumnMapping.TargetAttributeName auf den Wert IsDocument.
Setzen Sie das Attribut ColumnMapping.ProcessCode auf den ImportProcessCode.Internal-Wert der ImportProcessCode-Enumeration, wenn Sie Typen mit früher Bindung verwenden. Eine Liste der ProcessCode-Werte finden Sie in den Werten der Auswahlliste für diese Entität.
Wenn die Quelldaten eine Notiz darstellen, ordnen Sie auf den Text der Notiz dem Annotation.NoteText-Attribut zu. Wenn Sie mit Salesforce-Dateien arbeiten, werden diese normalerweise mit eindeutigen Kennnummern auf der Festplatte gespeichert. Zum eine Anlage zu importieren, müssen Sie eine in der Quelldatei enthaltene Dateikennnummer dem Attribut Annotation.DocumentBody zuordnen. Das Attribut DocumentBody speichert den Inhalt der Anlage.
Der Auftrag zum asynchronen Import überprüft die Zuordnungen, deren Quellattributnamen auf die Werte "true" und "false" gesetzt wurden, auf vorhandene Notizen und Anlagen. Wird eine Anlagenzuordnung gefunden, werden die angegebenen Dateien auf der Festplatte gesucht und der Dateiinhalt als Anlage in Microsoft Dynamics 365 hochgeladen. Wenn eine Datei nicht gefunden wird, wird eine Fehlermeldung zurückgegeben.
Wenn Sie die Zuordnung für eine Anmerkungsentität (Notiz) nicht bereitstellen, generiert der Importauftrag eine Standardzuordnung für die Notiz.
Hinweis
Die maximale Größe für Dateien, die hochgeladen werden können, wird durch die Organization.MaxUploadFileSize-Eigenschaft bestimmt. Diese Eigenschaft wird in der Dynamics 365-Anwendung auf der Registerkarte E-Mail in den Systemeinstellungen festgelegt. Mit dieser Einstellung wird die Größe von Dateien begrenzt, die an E-Mail-Nachrichten, Notizen und Webressourcen angefügt werden können. Die Standardeinstellung ist 5 MB. Allerdings darf die Dateigröße einer Anlage die maximale Größe für HTTP-Anforderung nicht überschreiten (Standard sind 16 MB). Damit die Änderungen wirksam wird, müssen Sie Internetinformationsdienste (IIS) neu starten. Klicken Sie hierzu auf Start, klicken Sie auf Ausführen, geben Sie iisreset ein, und klicken Sie dann auf OK.
Import und Export von Datenzuordnungen
Sie können eine vorhandene Datenzuordnung in eine XML-Datei exportieren und XML-Datenzuordnungen in Microsoft Dynamics 365 importieren. Wenn Sie eine Datenzuordnung aus Microsoft Dynamics 365 exportieren möchten, verwenden Sie die Nachricht ExportMappingsImportMapRequest. Um XML-Datenzuordnungen zu importieren und in Microsoft Dynamics 365 eine Datenzuordnung zu erstellen, können Sie die Nachricht ImportMappingsImportMapRequest verwenden.
Siehe auch
Daten importieren
Hinzufügen von Transformationszuordnungen für den Import
Hinzufügen von Transformationszuordnungen für den Import
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright