|
PREP_PROCESS_VAR_XML |
Séquences de données |
SAVE_PROCESS |
|
Fonction de script : Ajoute une ligne à une séquence de données spécifique.
PUT_PROCESS_LINE(Data sequence reference, Line, [Delimiter ])
|
Syntaxe |
Description / format |
|---|---|
|
Référence Séquence de données |
Référence à la séquence de données à laquelle une ligne doit être ajoutée. |
| Ligne |
Ligne associée à la séquence de données. Vous pouvez aussi spécifier un tableau de script. |
|
Séparateur |
Caractère quelconque qui répartit la ligne donnée en colonnes. Lorsqu'un tableau est indiqué pour Ligne, ce paramètre n'a aucun effet. |
|
Code retour |
|---|
|
"0" - La séquence de données a été étendue avec succès à la ligne mentionnée. |
La fonction de script ajoute une ligne à la séquence de données. La séquence de données est alors directement modifiée - le Code Retour de la fonction indique uniquement si l'ajout de la ligne a pu être réalisé correctement. La référence de la séquence de données à modifier et la valeur devant être insérée comme nouvelle ligne sont indiquées.
Les séquences de données peuvent être créées avec l'élément de script CREATE_PROCESS ou avec les fonctions PREP_PROCESS*.
Veuillez noter que la séquence de données dont la référence a été indiquée existe réellement ou n'a pas encore été fermée via :CLOSE_PROCESS. S'il tel n'est pas le cas, une erreur de durée se produit. Vous ne pouvez pas utiliser cette fonction de script pour créer une nouvelle séquence de données.
La ligne à ajouter peut être spécifiée sous la forme d'une chaîne de caractères (littéral de script ou variable de script) ou d'un tableau de script (variable de script). Un séparateur peut être mentionné pour une chaîne de caractères et permet de répartir cette dernière en plusieurs colonnes. Si aucun séparateur n'est spécifié, la nouvelle ligne dispose d'une seule colonne qui contient la valeur complète.
Si vous spécifiez un tableau de script, il est automatiquement réparti en colonnes selon ses éléments. Tous les éléments vides à la fin du tableau ne sont pas pris en compte.
Dans l'exemple suivant, une séquence de données est créée pour enregistrer une liste de fichiers. Puis un nom de fichier est lu à partir d'une variable d'objet et rajouté à la séquence de données.
:SET &HND# = PREP_PROCESS_FILENAME("WIN01","C:\AUTOMIC\temp\test*.txt","Y",,)
:SET &LINE# = GET_VAR(VARA.FILELIST)
:SET &RET# = PUT_PROCESS_LINE(&HND#,&LINE#)
Rubriques connexes :
| 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. |
|
| CREATE_PROCESS | Crée une nouvelle séquence de données. |
|
Détermine le contenu actuel des lignes d'une séquence de données. |
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