D365 -Recurring Integration
Recurring Integration (RI) ist eine asynchrone Funktionalität die auf dem Data Management Framework (DMF) von Dynamics 365 basiert. Sie ermöglicht regelmäßige und automatisierte Datenintegration zwischen externen Systemen und Dynamics 365. Mittels RI können verschiedene Datenquellen wie Dateien, APIs oder Datenbanken integriert werden.
Sie haben Fragen oder möchten weitere Informationen rund um unsere Leistungen und Produkte?
Kontaktieren Sie und jetzt über unser Kontaktformular.
Grundlagen
Recurring Integration ist eine auf DMF und Daten-Entitäten basierte Integrationsplattform, um den automatisierten Datenaustausch zwischen D365FO und Drittanbietern zu ermöglichen. Nach der Einrichtung eines Recurring Integration Jobs kann die D365 REST-API verwendet werden, um Daten von/nach D365FO zu importieren/exportieren.
Die untenstehende Abbildung zeigt die Architektur von Recurring Integration.
Standardmäßig wird RI verwendet, wenn größere Datenmengen an D365 zu übertragen sind. Im Gegensatz zu OData ist RI ein asynchroner Prozess.
Vorbereitende Maßnahmen / Voraussetzung (optional)
Um Recurring Integration zu verwenden, muss ein Datenprojekt in D365FO eingerichtet werden.
Erstellen eines Datenprojekts:
Via Data Management Workspace muss ein Datenprojekt erstellt werden.
Entweder „Import“ oder „Export“ wählen (je nach Bedarf).
Jobnamen, Datenquelle und Entitätsnamen definieren.
Hochladen ein oder mehrere Datendateien für eine oder mehrere Entitäten. Hierzu können im Vorwege Beispiel XMLs erzeugt werden.
Eventuell müsse Feldzuordnungen vorgenommen werden.
Speichern des Datenprojekts.
Erstellen eines Recurring Data Jobs::
Wählen Sie auf der Datenprojektseite „Create recurring data job“.
Geben Sie einen gültigen Namen und eine Beschreibung für den wiederkehrenden Datenjob ein.
Geben Sie die Anwendungs-ID ein, die für Ihre Anwendung generiert wurde, und aktivieren Sie sie.
Wählen Sie entweder „File“ oder „Data package“ als Datenquelle.
Legen Sie die Wiederkehroptionen und Überwachungsoptionen fest.
Bestätigen Sie die Einstellungen.
Eine komplette Anleitung sowie weitere Informationen sind unter Recurring integrations – Finance & Operations | Dynamics 365 zu finden.
Code-Beispiele
Das Code-Beispiel entfällt an dieser Stelle, da mittels eines simplen HTTP-Clients die entsprechenden API-Aufrufe getätigt werden müssen. Um die REST API von D365FO aufrufen zu können, muss sich entsprechend authentifiziert werden. Die Authentifizierung ist im Beitrag D365 – FINANCE AND OPERATIONS: EFFIZIENTE INTEGRATION FÜR OPTIMALE PROZESSE beschrieben.
Im Folgenden wird der Ablauf für Import und/oder Export von Daten aus/nach D365FO erläutert.
Der Ablauf für einen Datenimport (enqueue) sieht wie folgt aus:
Die Datei, die hochgeladen werden soll, muss in einen
MemoryStreambzw.ContentStreamkonvertiert werdenPOST-Request an untenstehende URL.
https://<base URL>/api/connector/enqueue/<activity ID>?entity=<entity name>
- Base URL: Instanz des Kunden
- Activity ID: ID des Recurring Integration Jobs
- Entityname: Name der Entität, die hochgeladen wird
Der Ablauf für einen Datenexport (dequeue) sieht wie folgt aus:
- GET-Request, um Daten zu downloaden
https://<base URL>/api/connector/dequeue/<activity ID>
- Base URL: Instanz des Kunden
- Activity ID: ID des Recurring Integration Jobs
- POST-Request, um Download zu quittieren
https://<base URL>/api/connector/ack/<activity ID>
Sie haben Fragen oder möchten weitere Informationen rund um unsere Leistungen und Produkte?
Kontaktieren Sie und jetzt über unser Kontaktformular.
