Erstellen von Datenzuordnungen für den Import

Um Daten in Microsoft Dataverse zu importieren, müssen die entsprechenden Datenzuordnungen bereitstellen.

Sie können Beispiele der Datenzuordnungen aus Microsoft-Downloads: DataImportMaps.zip herunterladen.

Sie verwenden Daten-Maps, um die in der Quelldatei enthaltenen Daten den Dataverse-Tabellenspalten zuzuordnen. Sie müssen jede Spalte in der Quelldatei einer entsprechenden Spalte zuordnen. Die Daten in den nicht zugeordneten Spalten werden während des Vorgangs des Datenimports nicht importiert.

Die Datenzuordnung wird durch die Tabelle Datenzuordnung (ImportMap) dargestellt. Sie können eine neue Zuordnung erstellen, indem Sie neue Datensätze dieser Tabelle erstellen. Die Zuordnung hat einen eindeutigen Namen, der in der Spalte ImportMap.Name enthalten ist. Sie können den Namen der Importquelle, für die diese Zuordnung erstellt wird, über die Spalte ImportMap.Source angeben.

Spalte, Listenwert und Suchzuordnungen

Um eine Spalte, einen Listenwert oder einen Lookup-Wert in der Quelldatei einer Dataverse-Spalte zuzuordnen, verwenden Sie die folgenden Zuordnungen:

Spaltenzuordnung

Ordnet eine Spalte in einer Quelldatei einer Dataverse-Spalte zu. Verwenden Sie für die Zuordnung von Spalten die Tabelle ColumnMapping. Sie können 1:1 oder 1:N Beziehungen zwischen Quell- und Zielspalten 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 einer Dataverse-Spalte vom Typ OptionSetValue zu. Verwenden Sie für die Wertzuordnung die Tabelle Listenwertzuordnung (PickListMapping).

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 Lookup-Wert in einer Quelldatei einer Dataverse-Spalte vom Typ EntityReference zu. Verwenden Sie für die Lookup-Zuordnung die Tabelle LookUpMapping.

Wenn der in der Quelldatei angegebene Wert auf eine Tabelle verweist, müssen Sie eine Lookup-Zuordnung für diesen Wert angeben. Verwenden Sie die Spalte LookupMapping.LookupSourceCode, um anzugeben, ob die referenzierte Tabelle in der Quelldatei oder in Dataverse 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 Dataverse zu suchen, verwenden Sie den LookupSourceType.System-Wert. Eine Liste der LookupSourceCode-Werte finden Sie bei den Auswahlwerten für diese Tabelle. Um die Metadaten für Ihre Organisation anzuzeigen, installieren Sie die Lösung „Metadata Browser”, die in Tabellendefinitionen in Ihrer Umgebung durchsuchen beschrieben wird. Sie können auch die Referenzdokumentation für Tabellen in der Tabellenreferenz durchsuchen. 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 Datenimport ausführen.

Besitzerzuordnung

Verwenden Sie die Besitzerzuordnung, um einen in der Quelldatei angegebenen Benutzer einem Benutzer in Dataverse zuzuordnen. Für das Protokollieren von Information können Sie den Benutzeranmeldenamen von Dataverse verwenden. Für die Zuordnung von Besitzern verwenden Sie die Tabelle OwnerMapping.

Notizen und Anlagen

Die Zuordnung für Notizen und Anhänge wird anders gehandhabt als bei anderen Tabellen. Notizen und Anlagen werden verwendet, um zusätzliche Informationen an einen Datensatz in Dataverse anzufügen. Notizen werden als Text gespeichert, Anlagen dagegen als Dateien in der Dataverse-Datenbank.

Um eine Notiz in Dataverse zu erstellen, legen Sie die Spalte Annotation.IsDocument in der Tabelle für Notizen (Anhänge) auf false fest. Um eine Anlage zu erstellen, Setzen Sie IsDocument auf true.

Verwenden Sie die folgenden Einstellungen für die Zuordnung von Notizen und Anlagen:

• Legen Sie die Spalte ColumnMapping.SourceAttributeName auf „true“ oder „false“ fest. Der Wert true zeigt eine Anlage an. Der Wert false zeigt eine Notiz an.

• Legen Sie die Spalte ColumnMapping.TargetAttributeName auf IsDocument fest.

• Legen Sie die Spalte ColumnMapping.ProcessCode auf den Wert ImportProcessCode.Internal der Aufzählung ImportProcessCode fest, wenn Sie früh gebundene Typen verwenden. Eine Liste der ProcessCode-Werte finden Sie bei den Auswahlwerten für diese Tabelle.

  Wenn die Quelldaten eine Notiz darstellen, ordnen Sie den Text der Notiz der Spalte Annotation.NoteText zu. Wenn Sie mit Salesforce-Dateien arbeiten, werden diese normalerweise mit eindeutigen Kennnummern auf der Festplatte gespeichert. Um einen Anhang zu importieren, müssen Sie der Spalte Annotation.DocumentBody eine Dateiidentifikationsnummer zuordnen, die in der Quelldatei enthalten ist. Die Spalte DocumentBody speichert den Inhalt des Anhangs.

  Der asynchrone Import-Job sucht nach Zuordnungen, bei denen der Name der Quellspalte auf „true“ und „false“ festgelegt ist, um Notizen und Anhänge zu entdecken. Wird eine Anlagenzuordnung gefunden, werden die angegebenen Dateien auf der Festplatte gesucht und der Dateiinhalt als Anlage in Dataverse hochgeladen. Wenn eine Datei nicht gefunden wird, wird eine Fehlermeldung zurückgegeben.

  Wenn Sie keine Zuordnung für eine Tabelle für Anmerkungen (Notizen) bereitstellen, erzeugt der Importjob eine Standard-Zuordnung für die Anmerkung.

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 Dataverse-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).

Import und Export von Datenzuordnungen

Sie können eine vorhandene Datenzuordnung in eine XML-Datei exportieren und XML-Datenzuordnungen in Dataverse importieren. Wenn Sie eine Datenzuordnung aus Dataverse exportieren möchten, verwenden Sie die Nachricht ExportMappingsImportMap mit ExportMappingsImportMapRequest Class oder mit ExportMappingsImportMap Action . Um XML-Datenzuordnungen zu importieren und in Dataverse eine Datenzuordnung zu erstellen, können Sie die Nachricht ImportMappingsImportMap ImportMappingsImportMapRequest Class oder ImportMappingsImportMap Action verwenden.

Siehe auch

Daten importieren
Vorbereiten einer Quelldatei für den Import
Hinzufügen von Transformationszuordnungen für den Import
Konfiguration des Datenimports
Ausführen des Datenimports
Datenimport-Tabellen
Beispiel: Exportieren und Importieren einer Datenzuordnung
Beispiel: Importieren von Daten mithilfe der komplexen Datenzuordnung

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).