Référence du Langage Script

Le Processeur Message Alert utilise un langage de script de type Basic pour traiter les messages et déclencher des opérations d'alarme. Cette référence documente tous les mots-clés, opérateurs et fonctions disponibles.

Utilisation des scripts

Les scripts sont des programmes exécutés par le Processeur Message pour extraire les informations significatives des messages entrants et déclencher les traitements Alert en conséquence. Chaque script est associé à un fichier de configuration prototype et peut :

• Extraire les informations d'alarme des messages et activer ou désactiver les alarmes
• Acquitter les alarmes
• Créer dynamiquement des alarmes à partir des données extraites
• Communiquer avec des systèmes externes via liaisons série, TCP/IP ou SMS
• Traiter des données depuis des fichiers, bases de données ou boîtes aux lettres email
• Gérer des appels téléphoniques vocaux entrants et sortants (Serveur Vocal, v4.0+)

Catégories disponibles

Le langage de script est organisé dans les catégories suivantes :

Catégorie	Description
Déclarations	Déclarations de variables (DIM), définitions de fonctions et sous-routines (FUNCTION, SUB), et commentaires (REM)
Contrôle de flux	Branchements conditionnels (IF/ELSE/ELSEIF) et boucles (FOR, DO WHILE, DO UNTIL, LOOP WHILE, LOOP UNTIL)
Opérateurs logiques	Opérateurs booléens et arithmétiques : AND, OR, XOR, NOT, DIV, MOD, EXP
Fonctions mathématiques	Opérations mathématiques et utilitaires numériques
Fonctions chaînes	Manipulation, analyse et formatage de chaînes
Fonctions tableaux	Création et manipulation de tableaux
Fonctions fichiers	Lecture, écriture et gestion de fichiers
Fonctions système	Interactions avec le système d'exploitation et l'environnement
Fonctions Processeur Message	Fonctions spécifiques au traitement des messages et à la gestion des événements
API Alert	Fonctions d'interaction avec la plateforme Alert (tags, alarmes, acquittements)
Objets	Types d'objets tels que FILE, XMLPARSE, DBCONNECTION, MAIL, SNMPTRAP, etc.
Serveur Vocal	Fonctions pour les applications de téléphonie vocale (v4.0+)

Structure d'un script

Un script est un fichier texte .prg associé à un prototype. Il suit les conventions de syntaxe Basic :

• Les variables sont déclarées avec DIM
• Les sous-routines et fonctions sont définies avec SUB / FUNCTION ... END SUB / END FUNCTION
• Les commentaires commencent par REM ou une apostrophe (')
• Le contrôle de flux utilise les constructions IF/ENDIF, FOR/NEXT, et DO/LOOP