Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > GET_CONNECTION

GET_CONNECTION

Script-Funktion: Liest Informationen aus einem DB Verbindungs-Objekt.

Syntax

GET_CONNECTION(Objektname, Attribut)

Syntax	Beschreibung/Format
Objektname	Name eines Verbindungs-Objektes vom Typ DB Format: AE-Name, Script-Literal oder Script-Variable
Attribut	Wert, der aus dem Objekt gelesen werden soll. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: db.type = Datenbank-Typ Mögliche zurückgelieferte Werte: "MSSQL" - MS SQL-Server "DB2" - IBM DB2 "ORACLE" - Oracle "SYBASE" - SyBase "MYSQL" - MyQL "INFORMIX" - Informix "ORACLE_OCI" - Oracle OCI db.server = Name des DB-Servers db.port = Portnummer des DB-Servers db.name = Name der Datenbank DbUserid = Datenbank-Benutzer DbPassword = Password des DB-Benutzers Login = Name des Alternativ-Login-Objektes Bitte beachten Sie: Bei Datenbanken, in denen die Groß- und Kleinschreibung eine Rolle spielt, müssen Sie den Wert DbUserid in der hier gezeigten Schreibweise verwenden.

Syntax

Beschreibung/Format

Objektname

Name eines Verbindungs-Objektes vom Typ DB
Format: AE-Name, Script-Literal oder Script-Variable

Attribut

Wert, der aus dem Objekt gelesen werden soll.
Format: AE-Name, Script-Literal oder Script-Variable

Erlaubte Werte:

db.type = Datenbank-Typ
Mögliche zurückgelieferte Werte:
- "MSSQL" - MS SQL-Server
- "DB2" - IBM DB2
- "ORACLE" - Oracle
- "SYBASE" - SyBase
- "MYSQL" - MyQL
- "INFORMIX" - Informix
- "ORACLE_OCI" - Oracle OCI
db.server = Name des DB-Servers
db.port = Portnummer des DB-Servers
db.name = Name der Datenbank
DbUserid = Datenbank-Benutzer
DbPassword = Password des DB-Benutzers
Login = Name des Alternativ-Login-Objektes

Bitte beachten Sie: Bei Datenbanken, in denen die Groß- und Kleinschreibung eine Rolle spielt, müssen Sie den Wert DbUserid in der hier gezeigten Schreibweise verwenden.

Rückgabewerte
Gewünschter Wert des CONN-Objektes

Anmerkungen

Die Script-Funktion liest einen bestimmten Wert aus einem Verbindungs-Objekt vom Typ DB und liefert diesen als Rückgabewert zurück.

Wurde das angegebene Objekt nicht gefunden, entspricht das Verbindungs-Objekt nicht dem Typ DB oder ist das spezifizierte Attribut ungültig, so kommt es zu einem Laufzeitfehler.

Beispiele

Folgendes Beispiel ermittelt den Datenbank-Typ des Verbindungs-Objektes CONN.DB und schreibt diesen in den Aktivierungsreport.

:SET &VAR# = GET_CONNECTION(CONN.DB, db.type)
:P &VAR#

Im Aktivierungsprotokoll ist anschließend folgende Zeile zu finden:

2013-01-30 12:45:21 - U0020408 MSSQL

Siehe auch:

Script-Sprachmittel	Beschreibung
GET_ATT	Liefert den Wert von Attributen einer Aufgabe während der Generierung.
GET_LOGIN	Liest Informationen aus Login-Objekten.

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support