In der Replikations-App gibt mehrere Einrichtungsmöglichkeiten. Die Menüpunkte dafür befinden sich im Replikation Menu (RPL Replikation -> RPL Einrichtungen)...
In dieser Page befinden sich neben den Einrichtungsmöglichkeiten auch die zu replizierenden Datensätze sowie die Aktion "Replikation ausführen".
RPL Einrichtungen
Die Einrichtungen müssen in folgender Reihenfolge durchgeführt werden:
Replikationseirichtung Allgemein
Replikation Datenbank Einrichtung (falls in Verwendung)
Replikationseinrichtung Mandanten
Replikationseinrichtung Tabellen
Übertragung an Mandanten Vorschlagswerte
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
Unter Hauptstammdaten fallen folgende Tabellen:
Sachkonto, Kontakt, Debitor, Kreditor, Artikel, Projekt und Ressourcengruppe. Nur diese Stammdaten haben die Felder "Übertragung an Mandanten" und "Replizieren" , wie z.B. hier:
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
Wenn angehakt, ist für diesen User im Fenster „Barbeiten – RPL Replikation“ die Funktion „Replikation mit Filter ausführen“ verfügbar.
Replikationseinrichtung Datenbank
Sobald die Replikation zwischen Datenbanken aktiviert ist (siehe "Replikationseinrichtung Allgemein"), wird die "Replikationseinrichtung Datenbanken" sichtbar.
Es können mehrere Datenbanken und pro Datenbank mehrere Remote - Mandanten eingerichtet werden.
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
Am Anfang werden alle gewünschten Mandanten als Replikationseinrichtung Mandanten definiert.
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.
In dieser Page befinden sich neben den Einrichtungsmöglichkeiten auch die zu replizierenden Datensätze sowie die Aktion "Replikation ausführen".
Es können mehrere Datenbanken und pro Datenbank mehrere Remote - Mandanten eingerichtet werden.
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.
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.
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.
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.
