Table of Contents

Stammdatensynchronisation im Schnellstart

Webdienst in Zieldatenbank veröffentlichen

Um Daten in eine Zieldatenbank zu schreiben, benötigt die Universal Data Connection dort einen bestimmten Webdienst. Dieser ist im Zielsystem unter "Webdienste" einzurichten. Veröffentlichen Sie dort die Codeunit 5320654 als Webdienst mit dem Namen "MDSReceipt".

ODataV4
Veröffentlichen Sie dort die Codeunit 5577803 als Webdienst mit dem Namen "MDSReceipt". Die Veröffentlichung des Webservices sowie die Bereitstellung eines geeignet berechtigten Benutzers sind die einzigen Anpassungen, die Sie im Zielsystem vornehmen. Alle weiteren Arbeiten finden im Quellsystem statt, das Daten in die Zielsysteme verteilt.

Hinweis

Die vollständige Bereitstellung eines Webdienstes erfordert verschiedene Voraussetzungen und Maßnahmen im Bereich der technischen Infrastruktur, die nicht Gegenstand dieser Extension und ihrer Dokumentation sind. Dazu zählen z. B. die Einrichtung geeigneter Service Tiers, Freigaben im Netzwerk und ein geeigneter Zugriffsschutz. Bitte lassen Sie sich dazu bei Bedarf beraten. Bei On-Premises-Installationen muss das Service-Tier für den Webservice so konfiguriert werden, dass die Authentifizierung über OAuth und nicht über User Password erfolgt.

UDC-Aktivierung

Öffnen Sie die "Universal Data Connection Einrichtung". Im Abschnitt "Allgemein" aktivieren Sie zunächst die Extension mit Hilfe des Schalters "Universal Data Connection aktiv". Die weiteren Einrichtungsfelder belassen Sie zunächst in ihren Initialwerten.

Partner anlegen und aktivieren

Machen Sie nun die Zieldatenbank als Partner bekannt. Gehen Sie dabei wie folgt vor:

  1. Öffnen Sie über die UDC Einrichtung "Partner für Stammdatensynchronisation", die Sie über die Navigationsleiste erreichen.

  2. Legen Sie einen neuen Partner an, indem Sie eine "Partner ID" vergeben sowie "Beschreibung" hinzufügen, und aktivieren Sie ihn mittels des Kennzeichens "Aktiv".

  3. Geben Sie im "Ziel-Webdienst" die URL des Webdienstes an, den Sie zuvor im Zielsystem veröffentlicht haben. Verwenden Sie dafür eine Schreibweise, unter der der Endpunkt vom Quellsystem aus erreichbar ist.

    Beispiel: https://services.unitop.de:7077/BC/WS/CRONUS%20NL/Codeunit/MDSReceipt?Tenant=default

    Hinweis

    Für ODataV4: Wählen Sie als "Transport-Typ” das Protokoll "OData V4” aus. Geben Sie im "Ziel-Webdienst” die URL des Service Tiers an, das im Zielsystem den Webdienst "MDSReceipt” bereitstellt.
    Beispiel: https://services.unitop.de:7078/BC

  4. Geben Sie im Feld "Ziel-Webdienstname" den Namen des Webdienstes ("MDSReceipt”) separat an, wie er auch in der vollständigen URL enthalten ist.

  5. Tragen Sie den Namen des Zielmandanten in das Feld "Mandantenname” ein.

  6. Für OAuth2:
    Über den Menüpunkt "Zugehörig", "OAuth Authentifizierung" können Sie eine OAuth2-Authentifizierung einrichten. Eine Anleitung dafür, finden Sie hier.
    Sollten Ihnen die dafür benötigten Informationen nicht vollständig vorliegen, dann stimmen Sie sich mit der Administration Ihrer technischen Infrastruktur ab. Testen und aktivieren Sie anschließend die vervollständigte OAuth2-Einrichtung.

  7. Prüfen Sie die Verbindung zum Zielsystem über "Zugehörig”, "Ping”. Diese Funktion ruft im ausgewählten Zielsystem (Partner für Stammdatensynchronisation) eine einfache Funktion ohne weitere Parameter auf und erhält im Erfolgsfall den aktuellen Zeitstempel aus dem Zielsystem zurück. Wenn Sie eine Erfolgsmeldung mit dem Zeitstempel erhalten, dann ist die Verbindung zum Zielsystem einsatzbereit. Sollten Sie eine andere Meldung erhalten, dann entnehmen Sie dieser Meldung bitte nach Möglichkeit weitere Details, um die Einrichtung zu vervollständigen oder zu korrigieren – oder um mögliche Hindernissen im Netzwerk oder Zielsystem nachzugehen.

Eine Tabelle abonnieren

Sobald Sie einen Partner angelegt haben, können Sie für diesen Tabellen abonnieren.

  1. Klicken Sie dazu in der Liste der Partner ("Partner für Stammdatensynchronisation") auf "Zugehörig" und "Abonnierte Tabellen".

  2. Ordnen Sie Ihrem Partner die Tabellen zu, welche für ihn relevant sind. Tragen Sie die gewünschte "Tabellen Nr." ein, welche abonniert werden soll. Falls Sie die Tabellennummer nicht kennen, können Sie die Lookup-Funktionalität nutzen.

    Hinweis

    Für den Schnellstart können Sie die Tabelle 5059567 "GOB UDC Transaction Check” verwenden.

Tabellenfelder einrichten

Anders als bei der Änderungsverfolgung richten Sie für die Stammdatensynchronisation die relevanten Felder explizit ein. Zu jedem Feld können Sie die Reihenfolge und Art der Verarbeitung später noch weiter präzisieren, im Schnellstart gehen wir zunächst davon aus, dass alle unterstützten Felder einer Tabelle übertragen werden sollen:

  1. Navigieren Sie aus der Seite "UDC Abonnement Tabelle" über "Zugehörig" zu "Abonnierte Felder".

  2. Klicken Sie dort in der Navigationsleiste auf "Aktionen", "Felder füllen". Die Liste wird so automatisch vorbelegt. Bitte prüfen Sie die Liste auf Warnungen bzgl. veralteter Felder oder möglicher Fremdschlüssel auf ausgelagerte BLOBs. Im Zweifel löschen Sie bitte für diese ersten Tests kritische oder unklare Felder aus der Liste..

Die Einrichtung ist nun vorerst abgeschlossen, Sie können nun die Datenübertragung wie folgt anstoßen.

Testweise Daten erzeugen

Warten Sie die eingerichtete Aktualisierungsrate (in der Regel 60 Sekunden) ab und nehmen Sie dann eine Datenänderung in der neu abonnierten Tabelle vor. Zu der Tabelle 5059567 "GOB UDC Transaction Check” gelangen Sie z. B. aus der Einrichtungskarte heraus über "Aktionen", "Transaktionen testen". Hier können Sie testweise im Menüpunkt "Neu" neue Datensätze (Test-Transaktionen) erstellen. Wenn Sie eine andere Tabelle abonniert haben, dann nehmen Sie dort eine Veränderung vor, die auch in die Datenbank zurückgeschrieben wird.

Datenbereitstellung manuell ausführen

Führen Sie manuell die Datenbereitstellung aus, indem Sie in der "Universal Data Connection Einrichtung" auf "Aktionen" und "Datenbereitstellung jetzt ausführen" klicken. Damit transportieren Sie die bisher nur in einem Puffer aufgezeichnete(n) Datenänderung(en) in die "Ausgehende Warteschlange für Stammdatensynchronisation", von wo aus sie dann in einem weiteren Schritt an die Zielsysteme übertragen werden.

Im späteren Regelbetrieb übernimmt ein Aufgabenwarteschlangenposten diese Arbeit.

Datenübertragung manuell ausführen

Führen Sie manuell die Datenübertragung aus, indem Sie in der "Universal Data Connection Einrichtung" auf "Aktionen" und "Übertragen" klicken. Damit starten Sie tatsächlich die Schreibprozesse innerhalb der Zieldatenbank(en) via Webdienst.

Im späteren Regelbetrieb übernimmt ein Aufgabenwarteschlangenposten diese Arbeit.

Ergebnis im Zielsystem kontrollieren

Sie können nun prüfen, ob Ihre Datenänderung im Zielsystem angekommen ist. Bei Bedarf können Sie die Änderung auf gleiche Weise wieder rückgängig machen, indem Sie den betroffenen Datensatz im Quellsystem wieder in den vorherigen Zustand versetzen und anschließend die Datenbereitstellung und -übertragung erneut manuell starten.

×
Vergrößertes Bild