Ausführen des Datenimports

Datenimporte werden direkt auf dem Microsoft Dataverse-Server ausgeführt. Richten Sie zum Ausführen des Datenimports asynchrone Aufträge ein, die im Hintergrund ausgeführt werden und Folgendes in der angegebenen Reihenfolge ausführen:

• Analysieren Sie Quelldaten, die in der Importdatei enthalten sind.
• Formen Sie analysierte Daten mithilfe der Datenzuordnung um.
• Laden Sie transformierte Daten in Dataverse hoch.

Alle Dataverse-Benutzer mit entsprechenden Rechten können den Datenimport ausführen.

Analysieren von Quelldaten

Das Analysieren von Quelldaten enthält das Analysieren aller Importdateien mit einem bestimmten Import (Datenimport).

Analysierte Daten werden in den temporären Analysetabellen gespeichert, die für jede importierte Datei erstellt werden. Der Name der Parse-Tabelle wird in der Spalte ImportFile.ParsedTableName gespeichert. Die Spaltenüberschriften der Quelldatei werden in der Spalte ImportFile.HeaderRow angegeben. Wenn die Quelldatei keine erste Zeile enthält, die die Spaltenüberschriften enthält, gibt diese Spalte die vom System generierten Standard-Spaltenüberschriften an.

Speichern Sie analysierte Daten in der Analysetabelle mithilfe der ParseImport-Nachricht. Rufen Sie Daten aus der Analysetabelle ab, indem Sie die Nachrichten GetDistinctValuesImportFile und RetrieveParsedDataImportFile verwenden.

In der folgenden Tabelle werden die Nachrichten aufgelistet, die Sie verwenden können, um die Importdateien zu analysieren die analysierten Daten aus den Analysetabellen abzurufen.

Nachricht SDK-Klasse Web-API-Aktion oder -Funktion	Beschreibung des Dataflows
ParseImportRequest ParseImportRequest Class ParseImport Action	Gibt einen asynchronen Auftrag ein, der alle Importdateien analysiert, die dem angegebenen Import (datenimport) zugeordnet sind. Übergeb Sie die ID des zugehörigen Imports (Datenimport) in die Eigenschaft ImportId dieser Anforderung. Die ID des asynchronen Auftrags, der im Hintergrund ausgeführt wird und das Analysieren von Daten durchführt, die in der AsyncOperationId-Eigenschaft der Antwort zurückgegeben werden.
GetDistinctValuesImportFile GetDistinctValuesImportFileRequest Class GetDistinctValuesImportFile Function	Gibt eindeutige Werte für eine Spalte in der Quelldatei zurück, die Listenwerte enthält. Übergeben Sie die ID der zugehörigen Importdatei in die Eigenschaft ImportFileId dieser Anforderung. Die eindeutigen Werte werden in einem Zeichenfolgenarray in der Values-Eigenschaft der Antwort zurückgegeben. Verwenden Sie diese Meldung nur, nachdem Sie eine Analysetabelle erstellt haben, indem Sie die ParseImport-Nachricht verwenden. Wichtig: Verwenden Sie diese Meldung nicht, nachdem Sie die Nachricht ImportRecordsImport verwenden. Sie können nicht auf die Analysetabelle zugreifen, nachdem der Importauftrag, der durch die ImportRecordsImport-Nachricht gesendet wurde, abgeschlossen wurde.
RetrieveParsedDataImportFile RetrieveParsedDataImportFileRequest Class RetrieveParsedDataImportFile Function	Ruft die Daten aus der Analysetabelle ab. Übergeben Sie die ID der zugehörigen Importdatei in die Eigenschaft ImportFileId dieser Anforderung. Die analysierten Daten werden in einem zweidimensionalen Zeichenfolgenarray in der Values-Eigenschaft der Antwort zurückgegeben. Die Daten werden mit derselben Spaltenreihenfolge wie die Spaltenreihenfolge in der Quelldatei zurückgegeben. Verwenden Sie diese Meldung nur, nachdem Sie eine Analysetabelle erstellt haben, indem Sie die ParseImport-Nachricht verwenden. Wichtig: Verwenden Sie diese Meldung nicht, nachdem Sie die Nachricht ImportRecordsImport verwenden. Sie können nicht auf die Analysetabelle zugreifen, nachdem der Importauftrag, der durch die ImportRecordsImport-Nachricht gesendet wurde, abgeschlossen wurde.

Transformieren analysierter Daten

Während der Transformation ändern Sie analysierte Daten, indem Sie alle verfügbaren Datenzuordnungen und Transformationen übernehmen, die einem bestimmten Import (Datenimport) in die Daten zugeordnet sind.

Verwenden Sie die TransformImport-Nachricht TransformImportRequest Class oder TransformImport Action, um einen asynchronen Auftrag zu senden und die analysierten Daten zu transformieren. Übergeben Sie eine eindeutige Kennung des zugehörigen Imports (Datenimports) in der Import.ImportId-Spalte des Auftrags. Ein eindeutiger Bezeichner des asynchronen Auftrags, der im Hintergrund ausgeführt wird und die Transformation durchführt, wird in der AsyncOperationId-Eigenschaft der Nachrichtenantwort zurückgegeben.

Hochladen transformierter Daten auf den Zielserver

Nachdem Sie die Transformation erfolgreich abgeschlossen haben, können die Daten auf den Dataverse-Server hochgeladen werden.

Verwenden Sie die Nachricht ImportRecordsImport mit ImportRecordsImportRequest Class oder ImportRecordsImport Action, um einen asynchronen Auftrag zu senden und die transformierten Daten nach Dataverse hochzuladen. Der eindeutige Bezeichner des zugeordneten Imports (Datenimport) muss im ImportId-Parameter der Anforderung angegeben werden. Ein eindeutiger Bezeichner des asynchronen Auftrags, der im Hintergrund ausgeführt wird und die Daten nach Dataverse hochlädt, wird in der AsyncOperationId-Eigenschaft der Antwort zurückgegeben. Alle Importdateien, die dem angegebenen Import (Datenimport) zugeordnet sind, werden importiert.

Jeder Importauftrag hat eine eindeutige Sequenznummer, die er in der Spalte ImportSequenceNumber der Datensätze speichert, die er erstellt. Die Spalte Organization.CurrentImportSequenceNumber enthält eine eindeutige Sequenznummer des letzten Importauftrags, der im System ausgeführt wurde. Sie können diese eindeutigen Sequenznummern verwenden, um Datensätze nachzuverfolgen, die zu einem Importauftrag gehören.

Protokollfehler

Ein Fehler beim Importieren eines Datensatzes kann während der Analyse, der Transformation oder des Hochladens von Daten auftreten. Die Gründe für den Fehler und andere detaillierte Informationen über die Datensätze, die nicht importiert werden konnten, werden in der Tabelle „Importprotokoll“ (ImportLog) festgehalten.

Um herauszufinden, wie viele Datensätze beim Import fehlgeschlagen sind, rufen Sie die Spalte ImportFile.FailureCount des Datensatzes ab. Um zu überprüfen, bei wie vielen Datensätzen der Import teilweise fehlgeschlagen ist, rufen Sie die Spalte ImportData.HasError ab. Wenn die HasError-Spalte true ist, ist ein Teilfehler aufgetreten, wenn sie false ist, wurde der Datensatz erfolgreich importiert.

Importieren von Überwachungsdaten

Die Dataverse-Tabellen haben vier Standardspalten, die dazu dienen, das Datum und die Uhrzeit, wann ein Datensatz erstellt und zuletzt geändert wurde, sowie die Person, die ihn erstellt und geändert hat, zu erfassen.

Die Spalte createdon gibt das Datum und die Uhrzeit an, zu der der Datensatz erstellt wurde. Um Daten in der Spalte createdon zu importieren, ordnen Sie die Quellspalte, die diese Daten enthält, der Spalte overriddencreatedon zu. Während des Imports wird die createdon-Spalte des Datensatzes mit dem Wert aktualisiert, der der overriddencreatedon-Spalte zugeordnet wurde, und die overriddencreatedon-Spalte wird auf das Datum und die Uhrzeit festgelegt, zu der die Daten importiert wurden. Wenn der Spalte overriddencreatedon kein Quellwert zugeordnet ist, wird die Spalte createdon auf das Datum und die Uhrzeit des Datenimports gesetzt und die Spalte overriddencreatedon wird auf keinen Wert festgelegt.

Hinweis

Um den Wert in der Spalte createdon beim Import zu überschreiben, benötigen Sie das Zugriffsrecht prvOverrideCreatedOnCreatedBy. Beachten Sie, dass der Name des Zugriffsrechts andeutet, dass Sie auch die Spalte createdby während des Imports überschreiben können. Allerdings wird diese Funktion derzeit nicht unterstützt.

Sie können keine Daten in die Spalten modifiedon, createdby und modifiedby importieren. Wenn Sie Daten speichern müssen, die sich darauf beziehen, wer die Daten erstellt und geändert hat und wann die Daten geändert wurden, können Sie angepasste Spalten in Dataverse erstellen und die Quellspalten den neuen angepassten Spalten zuordnen.

Siehe auch

Daten importieren
Vorbereiten einer Quelldatei für den Import
Erstellen von Datenzuordnungen für den Import
Hinzufügen von Transformationszuordnungen für den Import
Konfiguration des Datenimports
Datenimport-Tabellen
Beispiel: Exportieren und Importieren einer Datenzuordnung
Beispiel: Importieren von Daten mithilfe der komplexen Datenzuordnung
Blogbeitrag: Wie Anhänge automatisch importiert werden

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