Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Datenimport wird 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, die über entsprechende Berechtigungen verfügen, 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 Analysetabelle wird in der ImportFile.ParsedTableName Spalte gespeichert. Die Spaltenüberschriften der Quelldatei werden in der ImportFile.HeaderRow Spalte angegeben. Wenn die Quelldatei keine erste Zeile enthält, die die Spaltenüberschriften enthält, gibt diese Spalte die vom System generierten Standardspaltenüberschriften an.
Speichern Sie analysierte Daten in der Analysetabelle mithilfe der ParseImport-Nachricht. Rufen Sie Daten aus der Analysetabelle mithilfe der GetDistinctValuesImportFile Nachricht und der RetrieveParsedDataImportFile Nachricht ab.
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 |
Description |
|---|---|
ParseImportRequestParseImportRequest-Klasse ParseImport-Aktion |
Gibt einen asynchronen Auftrag ein, der alle Importdateien analysiert, die dem angegebenen Import (Datenimport) zugeordnet sind. Übergeben 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 die Analyse von Daten durchführt, wird in der AsyncOperationId Eigenschaft der Antwort zurückgegeben. |
GetDistinctValuesImportFileGetDistinctValuesImportFileRequest-Klasse GetDistinctValuesImportFile-Funktion |
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 unterschiedlichen Werte werden in einem Array von Zeichenfolgen 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. |
RetrieveParsedDataImportFileRetrieveParsedDataImportFileRequest-Klasse RetrieveParsedDataImportFile-Funktion |
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 Array von Zeichenfolgen 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 mithilfe der TransformImportRequest-Klasse oder transformImport-Aktion , um einen asynchronen Auftrag zum Transformieren der analysierten Daten zu senden. Übergeben Sie einen eindeutigen Bezeichner des zugeordneten Imports (Datenimport) in der Import.ImportId Spalte der Anforderung. 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 ImportRecordsImport Nachricht mithilfe der ImportRecordsImportRequest-Klasse oder der ImportRecordsImport-Aktion , um einen asynchronen Auftrag zum Hochladen der transformierten Daten in Dataverse zu senden. 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 in 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 verfügt über eine eindeutige Sequenznummer, die in der ImportSequenceNumber-Spalte der erstellten Datensätze gespeichert wird. Die Organization.CurrentImportSequenceNumber Spalte 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 Fehlergründe und andere detaillierte Informationen zu den Datensätzen, die nicht importiert werden konnten, werden in der Importprotokolltabelle (ImportLog) erfasst.
Um herauszufinden, wie viele Datensätze nicht importiert werden konnten, rufen Sie die ImportFile.FailureCount Spalte des Datensatzes ab. Rufen Sie die ImportData.HasError Spalte ab, um zu überprüfen, wie viele Datensätze während des Imports teilweise Fehler hatten. Wenn die HasError-Spalte true entspricht, ist ein partieller Fehler aufgetreten; wenn sie false entspricht, wurde der Datensatz erfolgreich importiert.
Importieren von Überwachungsdaten
Die Dataverse-Tabellen verfügen über vier Standardspalten, die verwendet werden, um das Datum und die Uhrzeit nachzuverfolgen, zu dem ein Datensatz erstellt und zuletzt geändert wurde, sowie die Person, die ihn erstellt und geändert hat.
Die createdon Spalte gibt das Datum und die Uhrzeit an, zu dem 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 Spalte des createdon Datensatzes mit dem Wert aktualisiert, der der overriddencreatedon Spalte zugeordnet wurde, und die overriddencreatedon Spalte wird auf das Datum und die Uhrzeit festgelegt, zu dem die Daten importiert wurden. Wenn der Spalte kein Quellwert zugeordnet overriddencreatedon ist, wird die createdon Spalte auf das Datum und die Uhrzeit festgelegt, zu dem die Daten importiert wurden, und die overriddencreatedon Spalte wird nicht auf einen Wert festgelegt.
Hinweis
Um den Wert in der Spalte während des createdon Imports außer Kraft zu setzen, benötigen Sie die prvOverrideCreatedOnCreatedBy Berechtigung. 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 modifiedon, createdby und modifiedby Spalten importieren. Wenn Sie Daten im Zusammenhang mit der Person speichern müssen, die die Daten erstellt und geändert hat und wann die Daten geändert wurden, können Sie benutzerdefinierte Spalten in Dataverse erstellen und die Quellspalten den neuen benutzerdefinierten Spalten zuordnen.
Siehe auch
Importieren von Daten
Vorbereiten einer Quelldatei für den Import
Datenzuordnungen für Import erstellen
Hinzufügen von Transformationszuordnungen für den Import
Konfigurieren des Datenimports
Datenimport-Tabellen
Beispiel: Exportieren und Importieren einer Datenzuordnung
Beispiel: Importieren von Daten mithilfe einer komplexen Datenzuordnung
Blogbeitrag: Wie Anhänge automatisch importiert werden