ECR-FIC-LIG-VOL
BUT
Permet d’écrire un fichier ascii physique dans un répertoire donné ; son contenu doit être auparavant initialisé dans la liste standard WfFicContenu.
Cette fonction est accessible dans les types de requêtes PSD, RCT et REB.
TYPE
CARACTERE
SYNTAXE
Variable = ECR-FIC-LIG-VOL( IDENTIFIANT=Identifiant, NOM= Nom_Fichier, REPERTOIRE= Adresse répertoire, PARAMETRES= Paramètres)
PARAMETRES
Paramètre | E/S | O | Type | Description |
Identifiant | E | Oui | Caractère | Correspond à la valeur de la clé de la liste WfFicContenu pour laquelle le contenu doit être écrit dans le fichier ascii ; l’identifiant doit correspondre à la valeur WfFicContenu.NomFichier. Cet identifiant peut être donnée par une variable locale, une constante globale, une constante locale ou une variable contextuelle de la requête. Il peut avoir comme valeur également *VIDE afin de générer un fichier ascii vide. |
Nom | E | Oui | Caractère | Correspond au nom du fichier physique à écrire. Cette valeur peut être donné par une variable locale, une constante globale, une constante locale ou une variable contextuelle de la requête. Le nom du fichier peut être donné en absolu ou par son simple nom (à compléter dans ce cas là avec le paramètre suivant répertoire). |
Répertoire | E | Oui | Caractère | Correspond au répertoire dans lequel le fichier physique doit être écrit. Cette valeur peut être donné par une variable locale, une constante globale, une constante locale ou une variable contextuelle de la requête. Le répertoire du fichier peut être vide si le nom est donné en absolu. |
Paramètres | E | Oui | Caractère | Correspond aux paramètres du fichier physique à écrire. Cette valeur peut être donné par une variable locale, une constante globale, une constante locale ou une variable contextuelle de la requête. Les paramètres sont passés sous la forme d’une liste chaînée de propriétés passées sous forme de liste chaînée (séparateur : ;), chaque paramètre étant identifié par un code suivi du caractère = et de la valeur du paramètre. Les valeurs de paramètres sont : - AJOUTER=+ : indique que le contenu à écrire sera ajouté à la suite du fichier si celui existe déjà. |
EXEMPLE
VLO.VarRésultat = ECR-FIC-LIG-VOL( IDENTIFIANT=CLE. «FIC1», NOM= CLO. «sortie.txt», REPERTOIRE= CLO. «/tmp/», PARAMETRES= CLE. «»)
Cette instruction permet d’écrire dans le fichier /tmp/sortie.txt le contenu de la liste standard WfFicContenu dont la clé est telle que WfFicContenu .NomFichier = « FIC1» ; si le fichier /tmp/sortie.txt existe déjà, DIAPASON remplace le contenu du fichier par le contenu de la liste WfFicContenu telle que WfFicContenu .NomFichier = « FIC1».
Attention à donner le chemin complet « /tmp/ », et non « /tmp »
VLO.VarRésultat = ECR-FIC-LIG-VOL( IDENTIFIANT=CLE. «FIC2», NOM= CLO. «/tmp/sortie.txt», REPERTOIRE= CLO. «», PARAMETRES= CLE. «AJOUTER=+»)
Cette instruction permet d’écrire dans le fichier /tmp/sortie.txt le contenu de la liste standard WfFicContenu dont la clé est telle que WfFicContenu .NomFichier = « FIC2» ; si le fichier /tmp/sortie.txt existe déjà, DIAPASON ajoute le contenu de la liste WfFicContenu telle que WfFicContenu .NomFichier = « FIC2» à la suite du contenu du fichier existant.
NOTES
La variable retour est vide si l’exécution de la fonction s’est correctement déroulée ; sinon, elle contient la valeur *ERR suivie d’un code erreur (nom fichier incorrect, fichier non accessible en écriture, erreur durant l’écriture).
Le nom du répertoire doit être complet en termes de séparateurs (voir exemples ci-dessus).