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.
• "Deb. Vorgabedim. am Projekt ignorieren" wird gesetzt, wenn Debitoren-Vorgabedimiension überschrieben werden soll.
• "Arbeitssprache" - Diese Einstellung wird verwendet, um Ihre Tabellenfilter automatisch in dieser Sprache anzulegen. Es ist erforderlich, dass diese Sprache eine installierte Systemsprache ist.

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.

    Wichtig

    Diese Einrichtung wird in der nächsten Version Entfernt werden, weil gleiche Funktion mit Tabellenfilter gelöst wird.
  • "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.
  • "Bei "Einfügen" schreiben" Wenn ein Datensatz neu angelegt wird, erfolgt dies mit einem "Einfügen" Eintrag und einem "Ändern" Eintrag. Der "Einfügen" Eintrag schreibt im Normalfall nur die Schlüsselfelder und der "Ändern" Eintrag zu einem späteren Zeitpunkt alle anderen Werte. Wenn man bestimmte Werte aber schon mit dem "Einfügen" Eintrag zusätzlich schreiben will, so kann man das mit diesem Haken erzwingen. Somit stehen die definieren Felder bereits vor dem "Ändern" Eintrag zur Verfügung: Das kann bei bestimmten Konstellationen mit abhängigen Tabellen sehr hilfreich sein.

  Übertragung an Mandanten Vorschlagswerte

  In dieser Tabelle sind alle sogenannten „Hauptstammdaten“ angeführt. Nur in diesen Tabellen können Sie bei jedem Datensatz (bei der Neuanlage) auswählen, in welche Mandanten er repliziert werden soll. Sie können hier den Vorschlagswert für diese Funktion ("Übertragung an Mandant") definieren.

  Personenkonten/Ländercodes Buchungsgruppen

  Diese Einrichtung ist für alle Kunden relevant, welche Mandanten mit unterschiedlicher Länderzugehörigkeit haben. Beispiel: es gibt einen Mandaten mit österreichischer Legislative und einen Mandanten mit deutscher Legislative. In diesem Fall kann z.B. die Geschäftsbuchungsgruppe nicht aus dem Stammdatenmandanten befüllt werden, da ein Debitor in einem österreichischen Mandanten die Geschäftsbuchungsgruppe INLAND hat, im deutschen Mandanten der gleiche Debitor aber die Geschäftsbuchungsgruppe EU benötigt. Diese Einrichtung muss jeweils im empfangenden Mandanten gemacht werden. Entsprechend dieser Einrichtung werden die Felder bei der Übertragung in den Zielmandanten befüllt. Diese Einrichtung muss für die Art „Debitor“ und „Kreditor“ getrennt gemacht werden. Wichtig ist es dabei auf die Reihenfolge der Felderübernahme zu achten. Der Ländercode muss in der Replikationseirichtung Tabellen für die jeweilige Tabelle zuerst übernommen werden, damit die Buchungsgruppen richtig definiert werden.

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.22.0

• Verbesserungen

• • Feldtyp RecordId wird jetzt repliziert.
  • Systemfelder sind von der "Tabelen hizufügen" - Aktion ausgeschlossen.

NVXRPL 1.0.21.0

• Verbesserungen

• • Replikationseinrichtung Allgemein: neues Häkchen - "Replikation deaktiviert"

NVXRPL 1.0.20.0

• Fehlerbehebungen

• • Einrichtung für Arbeitssprache: Optimierung
  • Kreditoren/Debitoren können vor der Aktivierung der Replikation geändert werden ohne Einfluß auf Replikation.

NVXRPL 1.0.19.0

• Fehlerbehebungen

• • Einrichtung für Arbeitssprache: Optimierung

NVXRPL 1.0.18.0

• Fehlerbehebungen

• • Neue Einrichtung für Arbeitssprache

NVXRPL 1.0.17.0

• Fehlerbehebungen

• • Optimierung für Performance funktioniert jetzt in der Remote-Datenbank.

NVXRPL 1.0.16.0

• Fehlerbehebungen

• • Protokoll für die fehlenden Einfügen-Datensätze wurde entfernt.

NVXRPL 1.0.15.0

• Fehlerbehebungen

• • Problem mit den fehlenden Einfügen-Datensätze wurde beseitigt.

NVXRPL 1.0.14.0

• Verbesserungen

• • Protokoll wird für die fehlenden Einfügen-Datensätze geschrieben.

NVXRPL 1.0.13.0

• Fehlerbehebungen

• • Sprachfehler beim Tabellenfilter wurde beseitigt.

NVXRPL 1.0.12.0

• Fehlerbehebungen

• • Der gleichnamiger Remote-Mandant wird jetzt ignoriert.

• Verbesserungen

• • Einrichtung in der "Replikationseinrichtung Allgemein" , das Häkchen "Deb. Vorgabedim. am Projekt ignorieren."

NVXRPL 1.0.11.0

• Fehlerbehebungen

• • Reihenfolge der abh. Datensätzen richtig gestellt.

NVXRPL 1.0.10.0

• Fehlerbehebungen

• • Sicherstellung, dass ein Datensatz nicht angelegt wird, falls er schon existiert. Das war früher in ganz seltenen Fällen möglich, wo der Primärschlüßel automatisch inkrementiert ist.
  • Mandant Entfenrnen im "Ignoriere für Mandant" korrigiert.

• Verbesserungen

• • "Ubernommen" wurde in "Repliziert" bei den Datentransfers umbenannt.
  • Umbennenung vom schon existierenen gleichnamigen Datensatz wird automatisch übersprungen.
  • Performance Verbesserungen.

NVXRPL 1.0.9.0

• Fehlerbehebungen

• • Tabellenfilter in der Remote Datenbank für Löschen-Datensatz korrigiert.

NVXRPL 1.0.8.0

• Fehlerbehebungen

• • Korrektur im Bezug zu Formatierung den Dezimalzahlen
  • Tabellenfilter in der Remote Datenbank korrigiert.

NVXRPL 1.0.7.0

• Fehlerbehebungen

• • Korrektur im Bezug zu abh. Tabelle.
  • Filter der übergeordneten Tabelle zu abh. Tabelle wird jetzt auch beachtet.

NVXRPL 1.0.6.0

• Fehlerbehebungen

• • Tabellenfilter Problem mit Vorgabedimensionen (als abh. Tabelle) wurde behoben.

NVXRPL 1.0.5.0

• Verbesserungen

• • Neue Funktion: "Replikation mit Filter ausführen".
  • Kachel mit fehlerhaften Replikationseinträgen (Datentransfers) wurde in die Admin Rolle hinzugefügt.
  • Jetzt ist es möglich, wenn notwendig, bestimmte nicht-Primärschlüßel-Felder im "Einfügen" Eintrag hinzuzufügen.

• Fehlerbehebungen

• • Tabellenfilter für abhängige Tabellen funktioniert jetzt korrekt.

NVXRPL 1.0.4.0

• Verbesserungen

• • 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