Datenzuordnungen für Import erstellen

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 Karte erstellen, indem Sie neue Datensätze dieser Tabelle erstellen. Die Karte weist einen eindeutigen Namen auf, der in der ImportMap.Name Spalte enthalten ist. Sie können den Namen der Importquelle angeben, für die diese Datenzuordnung mithilfe der ImportMap.Source Spalte erstellt wird.

Spalte, Listenwert und Suchzuordnungen

Verwenden Sie die folgenden Zuordnungen, um eine Spalte, einen Listenwert oder einen Nachschlagewert in der Quelldatei einer Dataverse-Spalte zuzuordnen:

Spaltenzuordnung

Ordnet eine Spalte in einer Quelldatei einer Dataverse-Spalte zu. Verwenden Sie für die Spaltenzuordnung die ColumnMapping-Tabelle. Sie können 1:1-Beziehungen (eins-zu-eins) oder 1:N-Beziehungen (eins-zu-viele) 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 des OptionSetValue Typs zu. Verwenden Sie für die Listenwertzuordnung die Tabelle List Value Mapping (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 Suchwert in einer Quelldatei einem Dataverse-Spalte des Typs 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 Nachschlagezuordnung für diesen Wert angeben. Verwenden Sie die LookupMapping.LookupSourceCode Spalte, um anzugeben, ob in der Quelldatei oder in Dataverse nach der referenzierten Tabelle 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. Verwenden Sie den LookupSourceType.System Wert, um in Dataverse zu suchen. Eine Liste der LookupSourceCode-Werte finden Sie in den Auswahlwerten für diese Tabelle. Um die Metadaten für Ihre Organisation anzuzeigen, installieren Sie die Metadatenbrowserlösung, die unter "Tabellendefinitionen durchsuchen" in Ihrer Umgebung beschrieben ist. 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. Verwenden Sie den Dataverse-Benutzeranmeldungsnamen zum Protokollieren von Informationen. Verwenden Sie für die Besitzerzuordnung die OwnerMapping-Tabelle .

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, und Anlagen werden als Dateien in der Dataverse-Datenbank gespeichert.

Um eine Notiz in Dataverse zu erstellen, legen Sie die Annotation.IsDocument Spalte in der Anmerkungstabelle (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:

• Legen Sie die ColumnMapping.SourceAttributeName Spalte auf "true" oder "false" fest. Der Wert "true" gibt einen Anhang an. Der Wert "false" gibt eine Notiz an.

• Legen Sie die ColumnMapping.TargetAttributeName Spalte auf IsDocument.

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

  Wenn die Quelldaten eine Notiz darstellen, ordnen Sie den Text der Notiz der Annotation.NoteText Spalte zu. Wenn Sie mit Salesforce-Dateien arbeiten, werden diese normalerweise mit eindeutigen Kennnummern auf der Festplatte gespeichert. Zum Importieren einer Anlage müssen Sie der Spalte eine Dateiidentifikationsnummer zuordnen, die in der Quelldatei Annotation.DocumentBody enthalten ist. In der Spalte DocumentBody wird der Inhalt des Anhangs gespeichert.

  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. Wenn eine Anlagenzuordnung gefunden wird, sucht sie nach den angegebenen Dateien auf dem Datenträger und lädt den Dateiinhalt als Anlagen in Dataverse hoch. Wenn eine Datei nicht gefunden wird, wird eine Fehlermeldung zurückgegeben.

  Wenn Sie keine Zuordnung für eine Anmerkungstabelle (Notiz) 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 auf der Registerkarte "E-Mail " der Systemeinstellungen in der Dataverse-Anwendung 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 zu einer XML-Datei exportieren und XML-Datenzuordnungen in Dataverse importieren. Zum Exportieren einer Datenzuordnung aus Dataverse verwenden Sie die ExportMappingsImportMap-Nachricht mit der ExportMappingsImportMapRequest-Klasse oder der ExportMappingsImportMap-Aktion. Um XML-Datenzuordnungen zu importieren und eine Datenzuordnung in Dataverse zu erstellen, verwenden Sie die ImportMappingsImportMap Nachricht mithilfe der ImportMappingsImportMapRequest-Klasse oder der ImportMappingsImportMap-Aktion.

Siehe auch

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