Ausführen des Datenimports
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Datenimporte werden direkt auf dem Microsoft Dynamics 365-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 Microsoft Dynamics 365 hoch.
Alle Microsoft Dynamics 365-Benutzer mit entsprechenden Rechten können den Datenimport ausführen.
In diesem Thema
Analysieren von Quelldaten
Transformieren analysierter Daten
Hochladen transformierter Daten auf den Zielserver
Protokollfehler
Importieren von Überwachungsdaten
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 im ImportFile.ParsedTableName-Attribut gespeichert. Die Spaltenüberschriften der Quelldatei werden im Attribut ImportFile.HeaderRow angegeben. Wenn die Quelldatei keine erste Zeile mit Spaltenüberschriften enthält, gibt dieses Attribut die vom System generierten Standardspaltenüberschriften an.
Speichern Sie analysierte Daten in der Analysetabelle mithilfe der ParseImportRequest-Nachricht. Rufen Sie Daten aus der Analysetabelle ab, indem Sie die Nachrichten GetDistinctValuesImportFileRequest und RetrieveParsedDataImportFileRequest 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.
Meldung |
Beschreibung |
|---|---|
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 Nachrichtenantwort zurückgegeben werden. |
|
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 Nachrichtenantwort zurückgegeben. Verwenden Sie diese Meldung nur, nachdem Sie eine Analysetabelle erstellt haben, indem Sie die ParseImportRequest-Nachricht verwenden. Wichtig Verwenden Sie diese Meldung nicht, wenn Sie die Nachricht ImportRecordsImportRequest verwenden. Sie können nicht auf die Analysetabelle zugreifen, nachdem der Importauftrag, der durch die ImportRecordsImportRequest-Nachricht gesendet wurde, abgeschlossen wurde. |
|
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 Nachrichtenantwort 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 ParseImportRequest-Nachricht verwenden. Wichtig Verwenden Sie diese Meldung nicht, wenn Sie die Nachricht ImportRecordsImportRequest verwenden. Sie können nicht auf die Analysetabelle zugreifen, nachdem der Importauftrag, der durch die ImportRecordsMessage-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 TransformImportRequest-Nachricht, um einen asynchronen Auftrag zu senden und die analysierten Daten zu transformieren. Übergeben Sie einen eindeutigen Bezeichner des zugeordneten Imports (Datenimport) im Import.ImportId-Attribut 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 Microsoft Dynamics 365-Server hochgeladen werden.
Verwenden Sie die ImportRecordsImportRequest-Nachricht, um einen asynchronen Auftrag zu senden und die transformierten Daten nach Microsoft Dynamics 365 hochzuladen. Der eindeutige Bezeichner des zugeordneten Imports (Datenimport) muss in der ImportId-Eigenschaft der Anforderung angegeben werden. Ein eindeutiger Bezeichner des asynchronen Auftrags, der im Hintergrund ausgeführt wird und die Daten nach Microsoft Dynamics 365 hochlädt, wird in der AsyncOperationId-Eigenschaft der Nachrichtenantwort zurückgegeben. Alle Importdateien, die dem angegebenen Import (Datenimport) zugeordnet sind, werden importiert.
Jeder Importauftrag besitzt eine eigene Sequenznummer, die im ImportSequenceNumber-Attribut der erstellten Datensätze gespeichert ist. Das Organization.CurrentImportSequenceNumber-Attribut enthält eine eindeutige Sequenznummer des letzten Importauftrags, der im System lief. 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 Fehlerursachen und andere ausführliche Informationen zu den nicht importierten Datensätzen werden in der Importprotokollentität (ImportLog) aufgezeichnet.
Um festzustellen, wie viele Datensätze nicht importiert werden konnten, rufen Sie das ImportFile.FailureCount-Attribut des Datensatzes ab. Um zu überprüfen, wie viele Datensätze beim Importieren teilweise fehlgeschlagen sind, rufen Sie das ImportData.HasError-Attribut ab. Wenn das HasError-Attribut true ist, ist ein Teilfehler aufgetreten, wenn es false ist, wurde der Datensatz erfolgreich importiert.
Importieren von Überwachungsdaten
Die Microsoft Dynamics 365-Entitäten haben vier Standardattribut, die verwendet werden, um nachzuverfolgen, an welchem Datum und zu welcher Uhrzeit ein Datensatz erstellt und zuletzt geändert wurde. Außerdem wird die Person nachverfolgt, die den Datensatz erstellt und geändert hat:
Das Attribut createdon gibt das Datum und die Uhrzeit an, an dem bzw. zu der der Datensatz erstellt wurde. Um Daten in das createdon-Attribut zu importieren, ordnen Sie die Quellspalte, die diese Daten enthält, dem overriddencreatedon-Attribut zu. Während des Imports wird das createdon-Attribut des Datensatzes mit dem Wert aktualisiert, der dem overriddencreatedon-Attribut zugeordnet ist, und das overriddencreatedon-Attribut wird auf das Datum und die Uhrzeit festgelegt, an dem bzw. zu der die Daten importiert wurden. Wenn dem overriddencreatedon-Attribut kein Quellcode zugeordnet ist, wird das createdon-Attribut auf das Datum und die Uhrzeit festgelegt, an dem bzw. zu der die Daten importiert werden. Das overriddencreatedon-Attribut ist auf keinen Wert festgelegt.
Hinweis
Wenn Sie den Wert im createdon-Attribut beim Importieren überschreiben möchten, benötigen Sie das prvOverrideCreatedOnCreatedBy-Recht. Beachten Sie, das der Name des Rechts besagt, dass Sie das createdby-Attribut auch während des Imports überschreiben können. Allerdings wird diese Funktion derzeit nicht unterstützt.
Sie können keine Daten in die Attribute modifiedon, createdby und modifiedby importieren. Wenn Sie Information dazu speichern müssen, wer den Datensatz erstellt und geändert hat und wann die Daten geändert wurde, können Sie in Microsoft Dynamics 365 benutzerdefinierte Attribute erstellen und die Quellspalten den neuen benutzerdefinierten Attributen zuordnen.
Siehe auch
Daten importieren
Konfiguration des Datenimports
Blogbeitrag: Wie Anhänge automatisch importiert werden
Datenimportentitäten
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright