Manuel des Scripts Automation Engine > Organisation fonctionnelle > Séquences de données > GET_PROCESS_INFO

GET_PROCESS_INFO

Fonction script : Déterminer des informations d'une séquence de données.

Syntaxe

GET_PROCESS_INFO(Référence Séquence de données, information [ , ligne])

Elément de syntaxe	Description/format
Référence Séquence de données	Référence à la séquence de données dont les informations doivent être lues. Format : Variable de script
Information	Indique quelle information doit être communiquée. Format : Nom AE Valeurs autorisées : INDEX - Déterminer la position actuelle dans la séquence de données. Utile uniquement dans les boucles de processus. COLUMNS - Nombre de colonnes de la ligne mentionnée. Si aucune ligne n'est mentionnée, le nombre de colonnes de la ligne actuelle (pour les boucles de processus) ou de la première ligne est calculé. ROWS - Nombre de lignes de la séquence de données
Ligne	Ligne dont le nombre de colonnes doit être calculé. Format : littéral de script, nombre sans guillemets ou Variable de script Ce paramètre peut être mentionné uniquement lorsque le nombre de colonnes est lu (Information = COLUMNS).

Elément de syntaxe

Description/format

Référence Séquence de données

Référence à la séquence de données dont les informations doivent être lues.
Format : Variable de script

Information

Indique quelle information doit être communiquée.
Format : Nom AE

Valeurs autorisées :

INDEX - Déterminer la position actuelle dans la séquence de données. Utile uniquement dans les boucles de processus.
COLUMNS - Nombre de colonnes de la ligne mentionnée. Si aucune ligne n'est mentionnée, le nombre de colonnes de la ligne actuelle (pour les boucles de processus) ou de la première ligne est calculé.
ROWS - Nombre de lignes de la séquence de données

Ligne

Ligne dont le nombre de colonnes doit être calculé.
Format : littéral de script, nombre sans guillemets ou Variable de script

Ce paramètre peut être mentionné uniquement lorsque le nombre de colonnes est lu (Information = COLUMNS).

Code retour
Information correspondante de la séquence de données

Remarques

La fonction de script permet de communiquer des informations générales (par ex. : le nombre de lignes ou de colonnes) des séquences de données. La référence de la séquence de données et l'information à communiquer doivent alors être indiquées.

Si le nombre de colonnes doit être lu, vous pouvez également spécifier le numéro de la ligne à utiliser. En l'absence d'indication, la ligne suivante est invoquée en fonction de l'utilisation du script :

Le script est utilisé dans une boucle de processus : Ligne à laquelle la boucle accède actuellement.
Le script se trouve en dehors d'une boucle de processus : Première ligne

Si la valeur INDEX est utilisée pour Information, le script doit être exécuté dans une boucle de processus. Dans ce cas, la ligne de la séquence de données actuellement traitée par la boucle est alors déterminée.

La lecture du nombre de lignes de la séquence de données n'est pas soumise à des dépendances particulières.

Veuillez noter que la séquence de données mentionnée existe et n'a pas encore été fermée avec le script :CLOSE_PROCESS. Sinon, une erreur de durée se produit.

Exemples

Dans l'exemple suivant, une séquence de données est créée et complétée avec plusieurs entrées d'un objet Variable. Le nombre de colonnes par ligne est ensuite calculé puis indiqué dans le protocole d'activation.

:SET &HND# = PREP_PROCESS_VAR(VARA.SQL,"*WIN*")
:SET &LNR# = GET_PROCESS_INFO(&HND#, ROWS)

:PROCESS &HND#
:SET &IND# = GET_PROCESS_INFO(&HND#,INDEX)
:SET &COL# = GET_PROCESS_INFO(&HND#,COLUMNS,&IND#)
:PRINT "Ligne &IND# / &LNR# possède &COL# Colonnes"
:ENDPROCESS

:CLOSE_PROCESS &HND#

Rubriques connexes :

Elément de script	Description
:CLOSE_PROCESS	Supprime une séquence de données au sein d'un script.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	Définissent une boucle pour le traitement par lignes d'une séquence de données, comme le contenu d'un fichier séquentiel ou le résultat de type texte d'une commande.
CREATE_PROCESS	Crée une nouvelle séquence de données.
GET_PROCESS_LINE	Détermine le contenu actuel des lignes d'une séquence de données.

Elément de script - Séquences de données

Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle