Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > GET_CONNECTION

GET_CONNECTION

Fonction de script : Lit les informations à partir d'un objet Connexion BD.

Syntaxe

GET_CONNECTION(Nom de l'objet, Attribut)

Syntaxe

Description / format

Nom d'objet

Nom d'un objet Connexion de type DB
Format : Nom AE, littéral de script ou variable de script

Attribut

Valeur devant être lue à partir de l'objet
Format : Nom AE, littéral de script ou variable de script

Valeurs autorisées :

  • db.type = Type de base de données
    Valeurs renvoyées possibles :
    • "MSSQL" - MS SQL Server
    • "DB2" - IBM DB2
    • "ORACLE" - Oracle
    • "SYBASE" - SyBase
    • "MYSQL" - MyQL
    • "INFORMIX" - Informix
    • "ORACLE_OCI" - Oracle OCI
  • db.server = Nom du serveur de la base de données
  • db.port = Numéro de port du serveur de la base de données
  • db.name = Nom de la base de données
  • DbUserId : utilisateur de la base de données
  • DbPassword = Mot de passe de l'utilisateur de la base de données
  • Login = Nom de l'objet Login alternatif

Attention : La valeur DbUserid doit être utilisée dans les bases de données respectant la casse, exactement comme ici.

Codes retour

Valeur souhaitée de l'objet CONN

Commentaires

La fonction de script lit une certaine valeur d'un objet Connexion de type BD et la renvoie dans le code retour.

Si l'objet indiqué est introuvable, l'objet Connexion ne correspond pas au type DB ou si l'attribut spécifié est invalide, une erreur de durée d'exécution se produit.

Exemples

L'exemple suivant détermine le type de base de données de l'objet Connexion CONN.DB et l'écrit dans le rapport d'activation.

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

La ligne suivante doit ensuite être trouvée dans le protocole d'activation :

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

 

Rubriques connexes :

Eléments de script Description
GET_ATT Cette fonction renvoie les valeurs des attributs d'une tâche pendant la génération.
GET_LOGIN Lit les informations à partir d'objets Login.


Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle