SQL-VARA-Objekte
SQL VARA-Objekte beziehen Werte mithilfe von SQL-Anweisungn aus externen Datenbanken.
Voraussetzungen
Um SQL VARA-Objekte definieren zu können, muss Folgendes zutreffen:
-
Ein DB Service-Agent für Variablen, der individuell konfiguriert und gestartet wird, muss zur Verfügung stehen. Dieser Agent ist nicht für die Ausführung von Datenbank-Jobs und -Ereignissen einsetzbar. Weitere Informationen finden Sie unter Den Agenten für Datenbankvariablen installieren.
- Ein Verbindung (CONN) ist definiert, das die Datenbankverbindungsparameter enthält
- Ein Login, in dem der Datenbankbenutzer und das Passwort eingetragen sind
SQL-VARA-Objekte definieren
Die Definition eines SQL-VARA-Objekts besteht aus den folgenden Seiten:
-
Gemeinsam für alle Objekttypen definieren Sie hier grundlegende Objektinformationen und wenden benutzerdefinierte Werte auf sie an.
-
Variablen
Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden in jeweils eigenen Themen beschrieben. In diesem Abschnitt sind die SQL-spezifischen Einstellungen für die Seite Variables beschrieben.
-
Allgemein für alle Objekttypen finden Sie hier eine Liste aller Versionen des Objekts.
-
Hier geben Sie die Informationen ein, die Sie als wichtig erachten, um die Konfiguration und das Verhalten des Objekts zu verstehen.
Wichtige Hinweise
- Für die Länge der Werte gibt es keine Beschränkung. Wenn eine maximale Textbegrenzung in der Seite Seite "Attribute" ausgewählt wurde, gilt dies nur für die erste Wertspalte. Einträge, welche dieses Limit überschreiten, werden ausgegrenzt.
-
Die maximale Anzahl zurückgegebener Zeilen wird in der Einstellung SQLVAR_MAX_ROWS angegeben (UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen).
-
Um die maximale Zeit für die Auflösung von SQL-Variablen zu ändern, verwenden Sie VAR_TIMEOUT (UC_HOSTCHAR_DEFAULT - Host-Charakteristika*).
-
Nicht druckbare Zeichen werden automatisch gelöscht (Zeichen ASCII 0x00 bis 0x20 und 0x7F).
-
Die Automation Engine schneidet Leerzeichen am Ende von SQL-Variablenwerten nicht ab.
-
Datenbank-VARA-Objekte (SEC_SQLI-, SEC_SQL-, SQLI- und SQL-Typen) unterstützen keine Binärfelder. Liefert die SQL-Abfrage Binärdaten zurück, so kommt es zu einem Fehler bei der Vorschau oder der Ermittlung der Werte zur Laufzeit.
-
In Datenbank-VARA-Objekten (SEC_SQLI-, SEC_SQL-, SQLI- und SQL-Typen) prüft das System die verarbeiteten SQL-Anweisungen aus technischen Gründen nicht. Sie können Datensätze mit Hilfe von VARA-Objekten ändern oder löschen. Aus Sicherheitsgründen sollten Sie den Benutzerzugriff entsprechend einschränken. Bei VARA-Objekten, die auf eine externe Datenbank zugreifen (SQL, SQL SECURE), sollte ein Datenbankbenutzer verwendet werden, der nur Leserechte besitzt. Bei internen SQL-Variablen (SQLI, SQLI SECURE), kann der Zugriff auf das Objekt durch ein Recht (SQL-interne Variablen anlegen und ändern) eingeschränkt werden.
-
Abhängig vom Datentyp geben Datenbank-VARA-Objekte (SEC_SQLI-, SEC_SQL-, SQLI- und SQL-Typen) den Wert "" (String, Datum, Zeit, Zeitstempel) oder 0 (Zahl) für NULL-Werte zurück.
-
PromptSet-Variablen werden in ausgewählten Feldern für Variablen des Typs BACKEND, EXEC, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL und XML unterstützt. Die Verwendung von PromptSet-Variablen ist notwendig, wenn die Funktion Dynamisch aktualisieren (Kombinationsfeld-Prompts) verwendet wird.
Die Seite "Variablen" definieren
-
Geben Sie im Abschnitt Variableneinstellungen Folgendes an:
-
Typ
Schreibgeschützt, immer SQL
-
Verbindung
Das Verbindung (CONN) vom Typ Datenbank, das die Verbindungsparameter zur gewünschten Datenbank enthält
-
Login
Das Login-Objekt, das den Namen und das Passwort des Datenbankbenutzers speichert
Ist kein Login-Objekt angegeben und auch die Option Standard-Login nicht gesetzt, so werden die Anmeldedaten für den Datenbank-Zugriff aus dem Verbindungsobjekt bezogen.
-
Standard-Login
Standardmäßiges Login-Objekt, das Ihrer Benutzer (USER) zugewiesen ist.
Wenn Sie diese Option auswählen, wird das Login-Objekt ignoriert, das im VARA-Objekt angegeben ist.
Wenn im Benutzerobjekt kein Login definiert ist, tritt ein Fehler auf, wenn das VARA-Objekt aufgelöst wird.
PromptSet-Variablen können hier nicht verwendet werden.
-
SQL-Anweisung
SQL-Anweisungen zur Auswahl von Einträgen der Datenbank, welche als Variablenwerte dienen.
Variablen, die direkt in SQL angegeben sind, werden ersetzt. Um Variablen einzubinden, verwenden Sie die Bind-Parameter.
Maximale Länge: 4096 Zeichen
Wenn Sie die Funktion für das Dynamisch aktualisieren (Kombinationsfeld-Prompts) für Kombinationsfeld-Prompts verwenden, können Sie hier PromptSet-Variablen hinzufügen. Wenn Sie PromptSet-Variablen in einem dynamischen VARA-Objekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund hierfür ist, dass PromptSet-Variablen im dynamischen VARA-Objekten nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.
-
- Definieren Sie Datentypen und Formatierung.
- Definieren Sie den Script-Zugriff.
- Wenn Sie bei Mandant 0 angemeldet sind, ist ein zusätzlicher Abschnitt verfügbar. Weitere Informationen finden Sie unter Mandant-0-VARA-Objekte in anderen Mandanten.
-
Um ein Kommando auszuführen, wählen Sie dieses aus und klicken Sie auf Vorschau. Die Anweisungen werden ausgeführt und die jeweiligen Ergebnisse angezeigt. Die Vorschaufunktion dient der Überprüfung auf mögliche Fehler in den Datenbank-Anweisungen (z. B. ob der Datentyp des VARA-Objekts und der Datenbank nicht übereinstimmen).
Der Datenbank-Agent sendet die Vorschau-Daten in Form einer Meldung an die Automation Engine. Wenn diese Meldung die maximale Meldungslänge überschreitet, die ein Serverprozess akzeptiert, tritt ein Fehler auf.
Maximale Länge: Im Parameter MaxMsgSize = der Datei UCSRV.INI der Automation Engine festgelegt.
Standardwert: 3145 728 Byte. Sie können das Ergebnis entweder durch die maximale Zeilenanzahl oder die SQL-Anweisungen einschränken.
Siehe auch: