Datenbank (JDBC)-Sync konfigurieren

Wenn Daten an Aeneis über eine Datenbank-Tabelle synchronisiert werden sollen oder Daten aus Aeneis in eine Datenbank exportiert werden sollen, muss eine Synchronisationsinstanz angelegt und entsprechend konfiguriert werden. Für jede Synchronisationsinstanz kann entweder die Synchronisation oder der Export konfiguriert werden.

Voraussetzung: Für die Synchronisation von Daten aus einer Datenbank muss die Datenbank mit den befüllten Tabellen vorliegen. Pro Kategorie, die synchronisiert werden soll, muss in der Datenbank eine Tabelle angelegt sein. Für jedes Attribut der entsprechenden Kategorie, das synchronisiert werden soll, muss in der Datenbank-Tabelle eine Spalte angelegt sein.

Voraussetzung: Für den Export von Daten in eine Datenbank muss eine Vorlage einer Datenbank mit der Tabellen-Struktur vorliegen. Pro Kategorie, die exportiert werden soll, muss in der Datenbank eine Tabelle angelegt sein. Für jedes Attribut der entsprechenden Kategorie, das exportiert werden soll, muss in der Datenbank-Tabelle eine Spalte angelegt sein.

Mögliche Datenbanken:

Datenbanksystem	Treiber	Beispiel-Verbindung
IBM-DB2	com.ibm.db2.jcc.DB2Driver	jdbc:db2://[HOSTNAME]:[PORT]/[DATABASE]
MariaDB	org.mariadb.jdbc.Driver	jdbc:mariadb://[SERVERNAME]:[PORT]/[DATABASE]
Microsoft SQL Server	com.microsoft.sqlserver.jdbc.SQLServerDriver	jdbc:sqlserver://[SERVERNAME]:[PORT]
MySQL DB	com.mysql.jdbc.Driver	jdbc:mysql://[SERVERNAME]:[PORT]/[DATABASE]
Oracle	oracle.jdbc.driver.OracleDriver	jdbc:oracle:thin:@[SERVERNAME]:[PORT]:[DATABASE]
MSSQL (jTDS)	net.sourceforge.jtds.jdbc.Driver	jdbc:jtds:sqlserver://[SERVERNAME]:[PORT]
Sybase	com.sybase.jdbc4.jdbc.SybDriver	jdbc:sybase:Tds:[SERVERNAME]:[PORT]/[DATABASE]
HSQL	org.hsqldb.jdbcDriver	jdbc:hsqldb:hsql://[SERVERNAME]/[ALIAS]

Konfiguration:

Wenn Sie eine Synchronisationsinstanz angelegt haben, wie unter Synchronisationsinstanz anlegen beschrieben, können Sie diese in den Eigenschaften weiter konfigurieren.

Eigenschaft	Beschreibung
Konfiguration
Trigger	In diesem Attribut können Sie einen Trigger hinterlegen, der steuert, wann die Synchronisation ausgeführt wird und die Daten aus der Datenbank an Aeneis übertragen oder aus Aeneis in die Datenbank exportiert werden.
Gruppe	Diese Eigenschaft ist für den internen Gebrauch, um Trigger und Jobs zu bündeln, und sollte nicht verändert werden!
Zeitmuster (Cron)	Hier können Sie ein Zeitmuster eintragen, das steuert, wann die Synchronisation automatisch ausgeführt wird. Siehe auch: Zeitmuster (Cron)
Aktiviert	Neu angelegte Synchronisationsinstanzen sind standardmäßig deaktiviert. Über diese Eigenschaft können Sie die Synchronisationsinstanz aktivieren.
Nachfolge Job	Hier können Sie Jobs miteinander verketten. Nachdem die Ausführung des Jobs abgeschlossen wurde, wird der Nachfolge-Job, der hier referenziert ist, unmittelbar ausgeführt. Hinweis: Wenn der Nachfolge-Job deaktiviert ist, wird er übersprungen und der nächste aktive Nachfolge-Job in der Verkettung wird ausgeführt. Hinweis: Nachfolge-Jobs benötigen keinen eigenen Trigger und kein eigenes Zeitmuster.
Datenbank (JDBC)
Treiber	Hier ist der Treiber der Datenbank eingetragen, die synchronisiert wird.
Verbindung	Hier ist die Verbindung für die Datenbank eingetragen, die synchronisiert wird.
Benutzer	Hier wird angezeigt, mit welchem Benutzer auf die Datenbank zugegriffen wird.
Export	Über diese Eigenschaft können Sie steuern, ob die Daten aus Aeneis in die Datenbank-Tabelle(n) exportiert werden sollen. Achtung: Das Feature ist veraltet und wird in einer späteren Version abgekündigt. Bitte verwenden Sie dieses Attribut nicht mehr!
Weitere Attribute
Log	Sobald eine Synchronisation ausgeführt wurde, erscheint in der Eigenschaft Log der Log-Eintrag der Synchronisation. Im Log-Eintrag wird angezeigt, ob die Synchronisation erfolgreich war und wie viele Objekte erstellt, aktualisiert, gemappt, entfernt, verschoben und gelöscht wurden.
Bezeichnung der DB-Tabelle	Referenzieren Sie hier eine Kategorie aus Aeneis, mit der die Datenbank-Tabelle synchronisiert werden soll (z.B. die Kategorie Mitarbeiter, wenn Mitarbeiter/-innen synchronisiert werden sollen) oder deren Objekte in die Datenbank-Tabelle exportiert werden sollen.
Schlüsselspalte	Hier können Sie eine Spalte im Fremdsystem wählen, die den Datensatz eindeutig identifiziert (Primärschlüssel). Wenn hier keine Schlüsselspalte ausgewählt wurde, wird die erste Spalte im Fremdsystem als Schlüsselspalte interpretiert. Hinweis: Die Schlüsselspalte in der Fremdsystem-Dateneinheit sollte vom Typ Zeichenkette sein. Die Schlüsselspalte muss den Datensatz eindeutig identifizieren. Schlüsselfelder müssen aus einer einzigen Spalte bestehen und dürfen nicht aus mehreren Schlüsseln zusammengesetzt werden.
Standard-ACL für neue Objekte	Definieren Sie hier die Zugriffskontrollliste, die für neu erstellte Objekte automatisch gesetzt wird.
ACL Feld (optional)	Über diese Eigenschaft können Sie einstellen, ob die ACL über die Synchronisation mit dem Fremdsystem gesetzt wird. Sind im Fremdsystem in einer Spalte IDs enthalten, die die ACLs einstellen, können Sie in dieser Eigenschaft die entsprechende Spalte zuordnen. Bei der Synchronisation wird die ACL über die Werte der hinterlegten Spalte befüllt.
Nicht mehr vorhandene Objekte löschen	Über diese Eigenschaft können Sie einstellen, dass Objekte, die zwischen zwei Synchronisationen im Fremdsystem gelöscht wurden, auch in Aeneis gelöscht werden. Ist diese Eigenschaft nicht aktiviert, werden die Objekte, die im Fremdsystem gelöscht wurden, in Aeneis nur als gelöscht markiert.
Neue Objekte erzeugen	Über diese Eigenschaft können Sie steuern, ob bei einer Synchronisation mit dem Fremdsystem neue Objekte in Aeneis erzeugt werden.
Version bei Löschungen erstellen	Über diese Eigenschaft können Sie einstellen, dass, wenn zwischen zwei Synchronisationen Objekte im Fremdsystem gelöscht wurden, in Aeneis vor der Synchronisation eine neue Version erstellt wird.
Version bei Änderungen erstellen	Über diese Eigenschaft können Sie einstellen, dass, wenn zwischen zwei Synchronisationen Objekte im Fremdsystem geändert wurden, in Aeneis nach der Synchronisation eine neue Version des Objekts erstellt und freigegeben wird.
Nicht referenzierte Objekte hier hinzufügen	Hier können Sie ein Objekt referenzieren, zu dem Objekte zugeordnet werden, die keinem anderen Objekt zugeordnet sind. Hier können nur Objekte referenziert werden, unter denen Objekte der entsprechenden Kategorie angelegt werden dürfen.
Trennzeichen Spalten (CSV)	Nur relevant für Web-Service-Synchronisationen.
Bezeichnung der Spalte	Referenzieren Sie in den Eigenschaften mit den Bezeichnungen der Spalten ein passendes Attribut der Kategorie, die für die Datenbank-Tabelle hinterlegt wurde. Bei der Synchronisation werden die Werte der Spalte aus dem Fremdsystem in das Attribut in Aeneis übertragen. Hinweis: Sie können hier erst ein Attribut referenzieren, wenn Sie eine Kategorie referenziert und bereits abgespeichert haben.
Verweist auf	Hier können Sie für die Spalte eine Datenbank-Tabelle auswählen, auf die die Spalte im Fremdsystem verweist (Relation). Die Spalte wird immer mit der Schlüsselspalte der ausgewählten Dateneinheit verknüpft.
Wert wenn als gelöscht markiert	Hier können Sie einen Wert hinterlegen, der in das Attribut geschrieben wird, wenn es bei einer Synchronisation als gelöscht markiert wird. Über diese Eigenschaft kann so ein Statusfeld gefüllt werden oder die Bezeichnung eines Objekts nach dem Löschen gesetzt werden.
Ausschließlich leere Attribute füllen	Über diese Eigenschaft können Sie einstellen, dass beim Synchronisieren nur Attribute befüllt werden, die noch keinen Wert haben.
Nur Referenzen zulassen	Über diese Eigenschaft können Sie einstellen, dass das Attribut in den Objekten der Kategorie nur referenziert wird und nicht hauptzugeordnet. Die Hauptzuordnung des Attributs findet dann im Objekt der Kategorie statt, die in der Eigenschaft Nicht referenzierte Objekte hier hinzufügen referenziert ist.
Objektdarstellung	Hier können Sie eine Objektdarstellung referenzieren, die die Ausgabe der Referenz bestimmt (z. B. Vorname Nachname oder Nachname, Vorname )