SQL Parameter Storage

Das SQL Parameter Storage-Plugin wird verwendet, um globale Parameter in der Datenbank zu persistieren. Sie müssen das Plugin anlegen, um globale Parameter in einer bestehenden Datenbank zu persistieren oder eine neue Datenbank zu erstellen. Weitere Informationen zu globalen Parametern finden Sie hier: Globale Parameter.

Wichtig!

Wenn Sie das SQL Parameter Storage-Plugin verwenden möchten, können Sie keine andere Methode für die Global Parameter Storage verwenden. Sie können nur eine Methode zum persistieren der globalen Parameter einsetzen.

Wichtig!

Der erste Start des SQL Parameter Storage-Plugins muss von einem Datenbankbenutzer ausgeführt werden, der über die Berechtigung zum Erstellen von Datenbanktabellen verfügt. Wenn alle erforderlichen Tabellen erstellt wurden, kann auf einen Benutzer mit weniger Berechtigungen umgestellt werden.

Hinweis:

Das SQL Parameter Storage-Plugin kann auf zwei Arten verwendet werden:

Empfohlene Einstellung: Wenn das Element UseLegacyDatabase auf false gesetzt ist, wird eine Verbindung zu einer Datenbank hergestellt, in der keine Parameter-Tabellen vorhanden sind. Die Tabellen für Parameter placeholder_groups und placeholder_values werden automatisch angelegt.
Wenn das Element UseLegacyDatabase auf true gesetzt ist, wird eine Verbindung zu den bereits vorhandenen Parameter-Tabellen in der X4-Datenbank hergestellt und diese Tabellen werden verwendet.

Das SQL Parameter Storage-Plugin wird verwendet, um globale Parameter in der Datenbank zu persistieren. Sie müssen das Plugin anlegen, um globale Parameter in einer bestehenden Datenbank zu persistieren oder eine neue Datenbank zu erstellen. Weitere Informationen zu globalen Parametern finden Sie hier: Globale Parameter.

Wichtig!

Der erste Start des SQL Parameter Storage-Plugins muss von einem Datenbankbenutzer ausgeführt werden, der über die Berechtigung zum Erstellen von Datenbanktabellen verfügt. Wenn alle erforderlichen Tabellen erstellt wurden, kann auf einen Benutzer mit weniger Berechtigungen umgestellt werden.

Hinweis:

Das SQL Parameter Storage-Plugin kann auf zwei Arten verwendet werden:

Empfohlene Einstellung: Wenn das Element UseLegacyDatabase auf false gesetzt ist, wird eine Verbindung zu einer Datenbank hergestellt, in der keine Parameter-Tabellen vorhanden sind. Die Tabellen für Parameter placeholder_groups und placeholder_values werden automatisch angelegt.
Wenn das Element UseLegacyDatabase auf true gesetzt ist, wird eine Verbindung zu den bereits vorhandenen Parameter-Tabellen in der X4-Datenbank hergestellt und diese Tabellen werden verwendet.

So konfigurieren Sie das SQL Parameter Storage-Plugin

Erstellen Sie im Ordner <Serververzeichnis>/configurations die Datei sql_globalparameter_storage_config.xml.

Fügen Sie den folgenden Inhalt ein.

XML

<?xml version="1.0"?>
<Configuration>
	<DatabaseConfiguration>
		<ConnectionString></ConnectionString>
		<UserName></UserName>
		<Password></Password>
	</DatabaseConfiguration>
	<UseLegacyDatabase>false</UseLegacyDatabase>
</Configuration>

Tragen Sie die benötigten Werte in die Datei sql_globalparameter_storage_config.xml ein.

Konfiguration der Datenbank

Element	Beschreibung	Mögliche Werte
`ConnectionString`	JDBC-Verbindungszeichenfolge zur Verbindung mit der Datenbank Weitere Einzelheiten entnehmen Sie der offiziellen JDBC-Datenbank-Dokumentation.	Verbindungs-URL für die JDBC-Datenbank
`UserName`	Benutzername für die Anmeldung bei der Datenbank	Beliebiger String
`Password`	Passwort für die Anmeldung bei der Datenbank	Beliebiger String
`UseLegacyDatabase`	Legt fest, ob: eine neue Datenbank erstellt werden soll (empfohlen) oder die Verbindung zu einer bestehenden Datenbank hergestellt werden soll	`false`: Eine neue Datenbank wird angelegt `true`: Verbindung zu bestehender Datenbank

So installieren Sie das Plugin

Hinweis:

Wenn Sie das SQL Parameter Storage-Plugin aktivieren, wird der standardmäßige Ordner properties mit Unterordnern im Arbeitsspeicher nicht mehr verwendet:

<Serververzeichnis>\wildfly\modules\de\softproject\x4\plugins \globalparameter\properties

Löschen Sie vor Installieren des Plugins den Ordner properties mit Inhalten.

Entpacken Sie die heruntergeladene .zip-Datei mit dem Plugin.
Kopieren Sie den Ordner <Dateiverzeichnis>\de in den Ordner <Serververzeichnis>\wildfly\modules\de\softproject\x4\plugins.
Öffnen Sie die Datei module.xml im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\plugins\main.
Löschen Sie in der Datei module.xml folgende Zeile:
<module name="de.softproject.x4.plugins.globalparameter.properties" export="true"/>
Kopieren Sie den Plugin-Namen in den Tag <dependencies>:
<module name="de.softproject.x4.plugins.globalparameter.sql" export="true"/>

Der Inhalt der Datei sollte in dieser Art aufgebaut sein:
Starten Sie den X4 Server neu.
Nach dem Neustart des X4 Servers steht Ihnen das Plugin zur Verfügung.