|
PREP_PROCESS_VAR |
Séquences de données |
PUT_PROCESS_LINE |
|
Fonction de script : Détermine une liste de valeurs d'un objet Variable XML à l'aide de critères de sélection et met le résultat à disposition comme liste interne (séquence de données) pour un traitement ultérieur.
PREP_PROCESS_VAR_XML(Variable, Key, Value)
|
Syntaxe |
Description / format |
|---|---|
|
Variable |
Nom de l'objet Variable dont les valeurs doivent être lues. |
|
Clé |
Le filtre pour la colonne Clé. Pour les Variables dynamiques, la colonne Clé est toujours la première colonne de valeurs. La colonne Résultat est créée une fois les entrées de variable déterminées. |
|
Valeur |
Le filtre pour la valeur. Vous pouvez utiliser les caractères génériques "*" et "?". "*" signifie n'importe quelle chaîne de caractères et "?" exactement un caractère. Le format de l'objet de variable XML doit être le même pour les deux fonctions de script. |
|
Code retour |
|---|
|
Référence à la séquence de données de l'objet Variable. |
La fonction de script lit les valeurs d'un objet variable XML. Les valeurs lues peuvent être limitées via les paramètres clé et valeur. Attention aux majuscules et aux minuscules !
Valeur se réfère au contenu d'une colonne de valeurs. Avec la colonne, vous définissez le numéro de la colonne de valeurs qui doit être parcourue. Si la colonne n'est pas indiquée, la première colonne de valeurs est automatiquement utilisée. Les Variables statiques possèdent 5 colonnes de valeurs. Le nombre de colonnes de variables dynamiques n'est pas limité et dépend de la source de données ou des paramètres dans l'objet Variable.
La fonction de script PREP_PROCESS_VAR_XML ne peut être utilisée qu'avec l'objet de variable XML qui propose une seule colonne de valeur.
Le code retour de cette fonction de script est la référence d'une séquence de données. Cette dernière est transmise en tant que paramètre de démarrage aux instructions de script :PROCESS et :ENDPROCESS. Grâce à l'utilisation conjointe de la fonction de script GET_PROCESS_LINE vous pouvez maintenant accéder à chacune des lignes de l'objet variable.
Si l'objet Variable ne contient pas les valeurs recherchées, aucun message d'erreur n'apparaît. Le traitement de la séquence de données, défini entre :PROCESS et :ENDPROCESS, n'est tout simplement pas lancé.
Les noms des objets VARA contenant une Variable doivent être indiqués entre guillemets. Sinon, un message d'erreur s'affichera.
Aucune autre valeur ne peut être attribuée à la variable de script contenant la référence de la séquence de données. La séquence de données doit être supprimée explicitement avec l'instruction de script :CLOSE_PROCESS avant de pouvoir réutiliser la variable.
Dans cet exemple, la valeur des lignes de séquence de données représentée par les variables de script &VALUE# et &GB# est lue. En retour, les valeurs "A/B" de la clé "KEY01" de l'objet de variable XML "VARA.XML" sont lues :
:SET &HND# = PREP_PROCESS_VAR_XML(VARA.XML, "KEY01", "A/B")
:PROCESS &HND#
: SET &GB# = GET_PROCESS_LINE(&HND#,1)
: SET &VALUE# = GET_PROCESS_LINE(&HND#,2)
: PRINT "&GB# &WERT#"
:ENDPROCESS
Voir aussi :
| Elément de script | Description |
|---|---|
|
Supprime une séquence de données inutile. |
|
|
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. |
|
|
Détermine le contenu actuel des lignes d'une séquence de données. |
|
| PREP_PROCESS_VAR | Détermine une liste de valeurs d'un objet Variable à l'aide de critères de sélection et met le résultat à disposition comme liste interne (séquence de données) pour un traitement ultérieur. |
Eléments de script - Séquences de données
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle