NVXRPL Replication

Handbuch

☰ Inhaltsverzeichnis

Allgemein

• App Replication

Einrichtung

• App Einrichtung

Aufgaben

• Arbeiten mit der App

Anhang

• Versionshinweise

Docs  /  NVXRPL Replication  /  Allgemein
Allgemein

• Unterteilung der Mandanten in Stammmandanten, operative Mandanten und sonstige Mandanten
• Detailierte Replikationseinrichtung mit unterschiedlichen Möglichkeiten bis auf Feld-Ebene
• Entscheidungsmöglichkeit wie die Daten repliziert werden
• Kontrolle und Transparenz wird gewährleistet
• Replikation auch direkt aus bestimmten Datensätzen wie z.B. Debitorenkarte, Sachkonto oder Artikelkarte usw.
• Abhängige Tabellen werden berücksichtigt
• Transparenz und Kontrolle für richtige Entscheidung vor der finalen Replikationsausführung
• Replikation kann per Aufgabenwarteschlange automatisiert werden
• Replikation zwischen Datenbanken

Docs  /  NVXRPL Replication  /  Einrichtung
Einrichtung

RPL Einrichtungen

1. Replikationseirichtung Allgemein
2. Replikation Datenbank Einrichtung (falls in Verwendung)
3. Replikationseinrichtung Mandanten
4. Replikationseinrichtung Tabellen
5. Übertragung an Mandanten Vorschlagswerte
6. Personenkonten/Ländercodes Buchungsgruppen

Replikationseinrichtung Allgemein

• Die Felder und Feldnamen werden automatisch beim Installieren der App ausgefüllt und können nicht mehr geändert werden. Diese Felder dienen dazu, dass sogenannte Hauptstammdaten vom System erkannt werden können.
• Der Haken "Datenbank Replikation" aktiviert die Replikation zwischen unterschiedlichen Datenbanken. Dadurch werden zus. Felder und "Replikation Datenbank Einrichtung" sichtbar und können definiert werden.
• Sobald "Datenbank Replikation" gesetzt ist, kann man mit dem Haken "Aktuelle Datenbank ist Empfänger" entscheiden, ob diese DB Daten sendet oder empfängt.

Hauptstammdaten

• Das Feld "Übertragung an Mandanten" bestimmt pro Datensatz wo die Replikation ausgeführt wird:
  • "Keine" - Der Datensatz wird nicht repliziert.
  • "Alle operativen" - Daten werden in Mandanten mit dem Kennzeichen "Operativer Mandant" in der "Replikationseinrichtung Mandanten", repliziert.
  • "Nur bestimmte" - Wenn diese Option ausgewählt wird, müssen die gewünschten Mandanten ausgewählt werden. Klicken Sie dazu auf die drei Punkte rechts vom Feld.
  • "Komplettes Unternehmen" - Daten werden in Mandanten, welche keinen Kennzeichen „Keine Replikation“ in der "Replikationseinrichtung Mandanten" haben, repliziert.
  Die Vorschlagswerte für dieses Feld kommen aus der Einrichtung "Übertragung and Mandanten Vorschlagswerte" (s.u.).
• Replizieren ist ein nicht-editierbares Feld das nach der Aktivierung der Replikation automatisch gesetzt wird (Aktion "Replikation aktivieren" - Datentransfer werden erstellt).

Benutzer Einrichtung – Replikation mit Filter

Replikationseinrichtung Datenbank

• Das Feld Datenbankname, gibt den Datenbanknamen an, aus welchem Daten übertragen werden sollen.
• In das Feld "Datenbank Servername" muss der Link zu Server samt "https://" eingetragen werden.
• Port ist der OData Port aus der BC Dienst - Konfiguration.
• Die Option "Tenant Datenbank" bestimmt, ob die sendende Datenbank eine Cloud DB ist.
• Die Felder "Verzeichnis-ID (Mandant)", Anwendungs-ID (Client) sowie "Geheime Clientschlüssel werden mit den Daten aus der Azure App-Registrierung befüllt.
• Mandantenname ist der Name des Stammdatenmandant aus der sendenden Datebnank.
• Mit der Aktion Aktionen -> "Verbindung prüfen" kann es gepüft werden, ob die Einrichtung für die datebankübergreifende Replikation korrekt ist.

Replikationseinrichtung Mandanten

• Mit dem Kenner "Stammdatenmandant" wird jener Mandant markiert, in welchem die Stammdaten verwaltet werden. Dieser Kenner kann nur bei einem Mandanten gesetzt werden.
• Mit dem Kenner "Operativer Mandant" werden die Mandanten markiert, welche das operative Geschäft abbilden.
• Mit dem Kenner "Keine Replikation" werden jene Mandanten markiert, welche nie Daten aus dem Stammdatenmandanten erhalten werden.
• Mandanten, welche in dieser Tabelle eingetragen wurden, aber keinen Kenner haben, werden weiterführend als "Sonstige Mandanten" benannt. Sie erhalten allgemeine Stammdaten wir z.B. Zahlungsbedingungen vom Stammdatenmandanten. "Hauptstammdaten" (siehe oben) erhalten sie nur jene, welche auf der Karte im Feld "Übertragung an Mandanten" den Eintrag "Komplettes Unternehmen" haben.
• Bei einer DB-übergreifenden Replikation, erscheinen hier zwei zusätzliche Felder: "Remote" - Wenn Sie diesen Haken setzen, können nur Mandanten der Remote - Datenbanken ausgewählt werden. "Datenbankname" - Hier wird die Datenbank ausgewählt wo sich der Remote - Mandant befindet.

Replikationeirichtung Tabellen

• Mit der Aktion "Tabelle hinzufügen" können Sie die gewünschte Tabelle und die Felder der Tabelle in die Replikationseinrichtung hinzufügen.
• Wenn eine Tabelle eingefügt wurde, sind folgende Felder zu beachten:
  • Art In der Art wird nach "Tabelle", "Feld" oder "Abhängige Tabelle" unterschieden.
  • Tabellennr. Die Nummer der Tabelle wird vom System befüllt, wenn der Eintrag mit "Tabelle hinzufügen" erstellt wurde. Sie kann auch manuell eingetragen werden.
  • Tabellenname Name der entsprechenden Tabelle, wird vom System befüllt.
  • Feldnr. Nummer des Feldes, wird vom System befüllt wenn der Eintrag mit "Tabelle hinzufügen" erstellt wurde. Kann aber auch manuell eingetragen werden.
  • Feldname Name des entsprechenden Feldes, wird vom System befüllt.
  • Tabellen Reihenfolge Reihenfolge, in der die Tabellen abgearbeitet werden. Je niedriger die Zahl, desto früher die Verarbeitung.
  • Feldvalidierung nicht ausführen Ist dieses Kennzeichen gesetzt, wird das Feld mit der Replikation zwar übertragen, es erfolgt aber keine Validierung des Feldinhaltes. Dieses Kennzeichen darf nur in bestimmten Fällen gesetzt werden.
  • Feld ignorieren Grundsätzlich dürfen Felder, welche in der Replikationseinrichtung Tabellen vorhanden sind, nur im Stammdatenmandant editiert werden. In den anderen Mandanten replizierten kommt es zu einer Fehlermeldung. Wurde dieses Kennzeichen gesetzt, kann dieses Feld sowohl im Stammdatenmandant, als auch in allen anderen Mandanten editiert werden. Es wird nicht repliziert. Systemfelder, wie zB "Erstellt von" oder "Erstellt am" sollten dieses Kennzeichen immer erhalten.
  • Neu Kennzeichnet Zeilen, welche in der Replikationseinrichtung Tabellen neu hinzugekommen sind. Beim Schließen der Replikationseinrichtung Tabellen wird für alle Zeilen mit diesem Kennzeichen geprüft, ob es entsprechende Einträge im Stammdatenmandant gibt. Wenn ja, werden die erforderlichen Einträge in der Datentransfertabelle erstellt. Dieses Kennzeichen kann manuell entfernt werden, wenn bestehende Einträge aus dem Stammdatenmandant nicht übertragen werden sollen. Dies sollte aber nur in Sonderfällen gemacht werden.
  • "Tabellenfilter" in "RPL Replikationseinrichtung Tabellen" Der Tabellenfilter dient dazu, nur bestimmten Datensätze der betroffenen Tabelle zu replizieren. Die Verwendung des Tabellenfilter ist nur für Einrichtungsdatensätze mit der Art "Tabelle" und "Abhängige Tabelle" möglich. Wenn ein Filter angelegt wurde, werden Replikationseinträge (Datentransfers) nur für die laut Filter gewählten Datensätze erstellt.
  • "Ignoriere für Feld"/"Ignoriere für Feldwert" Manchmal will man, dass nur bestimmte Datensätze einer Tabelle repliziert werden (abhänging vom Wert eines Feldes) und andere nicht. Dafür dienen die Felder "Ignoriere für Feld" u. "Ignoriere für Feldwert" in der "Replikationseinrichtung Tabellen", die nur für die Einrichtung mit der Art Tabelle verwendet werden dürfen: Bei beiden Felder dürfen die Werte nicht manuell eingegeben werden (außer in "Ignoriere für Feld", falls man den Wert komplett löschen will). Wenn man auf Lookup Punkte klickt, kommt zur Auswahl die Liste der Felder für die selektierte Tabelle: Gleich darauf öffnet sich entsprechende Seite. Bei den Optionen, eine Optionenauswahl und bei anderen Felder eine Eingabe-Seite: Somit ist die Einrichtung fertig: WICHTIG: Man muss aus den "Replikationseinrichtung Tabellen" aussteigen, damit die Änderungen gespeichert werden. Für die Tabellen mit derartiger Einrichtung wird die Replikation gar nicht aktiviert und diese können eingefügt/gelöscht/geändert. Da der zu ignorierte Feldwert unmittelbar nach der Datensatzanlage in Verwendung kommt, muss es gleich beim Anlegen dieses Feld befüllt werden. In diesem Beispielsfall verwenden wir die Art bei Ressourcen. Das System muss also beim Anlegen schon den Wert des Feldes wissen. In diesen Fällen poppt, bei der manuellen Eingabe, die Eingabe-Seite für das definiertes Feld auf: WICHTIG: Bei programmatisch angelegten Datensätzen, muss unbedigt der entsprechende Feldwert mitgegeben werden.
  • "Ignoriere für Mandant" Das Feld "Ignoriere für Mandant" wird für die Fälle benutzt, wo man bestimmte Tabellen oder Felder in den bestimmten Mandanten ignorieren will. Beim Replizieren kann auf Tabellenebene die "Ignorieren für Mandant" Einrichtung berücksichtigt werden. Wenn der Wert Ja ausgewählt wird, kann man den Mandant auswählen. Wenn ein oder meherere Mandanten definiert sind Datentransfer wird für diese Mandanten auf "Überspringen" gesetzt. Im Fehlertext kommt "Der Datensatz konnte nicht übernommen werden, weil es in der Datenbank keine Definition für diese Tabelle gibt." Neuanlage, Löschen und Änderungen in Tabellen sind erlaubt, wenn für diesen Mandanten "Ignorieren für Mandant" gesetzt ist. Auf Feldebene kann "Ignorieren für Mandant" auch berücksichtigt werden. Wenn gesetzt, der Feldinhalt wird nicht übernommen, indem das Feld in den Datentransfer - Details automatisch auf "Überspringen" gesetzt wird. Außerdem sind Änderungen in Feldern erlaubt, wenn für diesen Mandanten "Ignorieren für Mandant" für dieses Feld gesetzt ist.

Übertragung an Mandanten Vorschlagswerte

Personenkonten/Ländercodes Buchungsgruppen

Docs  /  NVXRPL Replication  /  Aufgaben
Arbeiten mit der App

Replikation zwischen Mandanten einer Datenbank

• Mit der Aktion "Replikation ausführen" wird die Verarbeitung der bisher nicht bearbeiteten Datentransfers gestartet. Diese Aktion kann auch per Aufgabenwarteschlange durchgeführt werden.
• Alle Einträge, die verarbeitet wurden, erhalten das Kennzeichen "Übernommen", sowie das Datum und die Uhrzeit der Übernahme.
• Falls es in der Verarbeitung zu einem Fehler kommt, wird das Kennzeichen "Fehler" gesetzt und zusätzlich das Datum und die Uhrzeit des Fehlers dokumentiert. Falls es zu einem Fehler kommt wird die Verarbeitung aller weiteren vom betroffenen Mandanten Replikationssätze gestoppt. Alle anderen Mandanten werden weiterhin repliziert. Wenn der Fehler behoben ist, wird die Replikation für den betroffenen Mandanten an dieser Stelle wieder fortgesetzt.
• Mit dem Kennzeichen "Überspringen" kann der Datentransfer in der Verarbeitung übersprungen werden, um die Verarbeitung folgender Datensätze durchzuführen. Wird das Kennzeichen "Überspringen" wieder entfernt, wird die Replikation wieder versuchen diesen Datentransfer zu übernehmen.
• Die Verarbeitung in der Replikation erfolgt innerhalb eines Mandanten immer aufsteigend nach der laufenden Nummer. Die Daten werden wegen der Übersichtlichkeit absteigend angezeigt.
• Die Replikation kann auch in den einzelnen Mandanten ausgeführt werden. Dann werden aber nur die Datentransfers für den jeweiligen Mandanten berücksichtigt.

Replikation der Hauptstammdaten

Replikation mit Filter ausführen

Replikation zwischen Datenbanken

• Bei einer DB-übergreifenden Replikation werden die Datentransfers aus der Basis - Datenbank mit der Aktion "Übertragung aus Basis-Datenbank" übernommen.
• Falls es in diesem Prozessschritt zu einem Fehler kommt, wird die Übernahme unterbrochen und der entsprechende Datentransfer entsprechend gekennzeichnet.
• Um die Datensätze für die Mandanten dieser Datenbank zu verarbeiten, muss auch hier die Aktion "Replikation durchführen" gewählt werden.
• Der Stammdatenmandant in der Remote - Datenbank ist nicht zwingend erforderlich. Wenn Sie allerdings die Datentransfers für alle Mandanten mit EINEM Aufruf der Funktion "Replikation durchführen" starten wollen, benötigen Sie auch in der Remote Datenbank einen Stammdatenmandanten.
• Beim Holen der Replikationsdefinitionen werden immer alle Definitionen übertragen. Das passiert automatisiert beim Übertragen der Datentransfers. In einer Remote-Datenbank dürfen diese Definitionen nicht mehr geändert werden.
• Die Aktionen "Übertragung aus Basis-Datenbank" und "Replikation ausführen" können mit Hilfe einer Aufgabenwarteschlange automatisiert werden (Bericht 61882 - RPLTransferRemoteDTNVX und Codeunit 61883 - RPLStartReplicationNVX).

Docs  /  NVXRPL Replication  /  Anhang
Versionshinweise

Build-Übersicht in DevOps

NVXRPL 1.0.4.0

• Erweiterungen

• • Tabellenfilter für Replikation von nur bestimmten Datensätzen.

NVXRPL 1.0.3.0

• Fehlerbehebungen

• • Filter wird für nicht gefilterte Aktion gelöscht.

NVXRPL 1.0.2.0

• Replikationseinträge können jetzt gefiltert repliziert werden.

NVXRPL 1.0.1.0

• Umbennenung der Datensätzen ist jetzt möglich.

NVXRPL 1.0.0.0

• Ursprungsversion