Les paramètres décrits ici sont utilisés implicitement par les blocs fonctions FP-I4C.
Ils sont décrits uniquement pour information ! Toutes les opérations de fichiers et de transmissions FTP ou e-mails sont traitées par les blocs fonctions dans la bibliothèque FP-I4C.
Les opérations de fichiers incluent la lecture et l’écriture dans des fichiers TXT et CSV sauvegardés dans le module FP-I4C ou dans des dispositifs de sauvegarde connectés, ainsi que la transmission via FTP ou e-mails.
Les paramètres des opérations de fichiers sont contenus dans une balise placée en tant que chaîne de caractères dans le programme API. Les balises contiennent les paramètres des opérations de fichiers et les adresses des automates. Le nombre maximum de caractères de chaque balise est de 128 (accolades inclues).
Exemples :
Attacher un fichier CSV : {A_D_00200_00066_S04_filename.csv}
Attacher un fichier texte : {A_D_00200_00001_T01_filename.txt}
Rechercher une chaîne de caractères dans une ligne et écrire toute la ligne dans une chaîne de caractères de destination (00200 : adresse de départ de la chaîne de caractères à rechercher, 00300 : adresse de départ de la chaîne de caractères de destination) : {A_D_00200_00300_r01_filename.txt}
Rechercher la ligne d’une chaîne de caractères spécifiée et la remplacer par une autre ligne (00200 : adresse de départ de la chaîne de caractères à rechercher, 00300 : adresse de départ de la chaîne de caractères de remplacement) : {A_D_00200_00300_m01_filename.txt}
Tester si un fichier existe : {A_D_00200_00000_P01_filename.txt}
Offset de caractères |
Paramètre |
Valeurs |
Exemple |
|
---|---|---|---|---|
Fichier CSV |
Fichier TXT |
|||
+0 |
Code de départ |
{A |
|
|
+3 |
Type de registre API |
D: DT, F : FL, L : LD |
|
|
+5 |
Pointeur au début des données 1 |
Première adresse de registre API à lire |
Adresse de départ de l’en-tête de la chaîne de caractères de Control FPWIN Pro7 |
|
+11 |
Nombre de registres ou pointeur au début des données 2 |
Nombre de registres API à lire |
Adresse de départ de l’en-tête de la chaîne de caractères de destination ou de remplacement de Control FPWIN Pro7 pour les modes d’opérations r et m ; Aucune donnée n’est écrite si l’adresse de départ de la chaîne de caractères de destination est 0000. |
CSV : TXT : |
+17 |
Mode d’opération |
K,k : terminateur de cellule ',' (virgule) S,s : terminateur de cellule ';' (point-virgule) P : rétablir les données des fichiers CSV existants à partir de l’emplacement de sauvegarde des données vers l’automate. F : envoyer un fichier à partir de l’emplacement de sauvegarde des données via FTP ou e-mails. D : supprimer un fichier de l’emplacement de sauvegarde des données. Avec des lettres minuscules, les données sont sauvegardées sans être envoyées via FTP ou e-mails. |
T,t : écrire et transmettre un fichier TXT via FTP ou e-mails. a : ajouter une chaîne de caractères à un fichier TXT existant. Si le fichier n’existe pas, un nouveau fichier est créé. r : rechercher une ligne qui contient le texte spécifié par Pointeur au début des données 1. Chaque ligne se termine avec le caractère de fin de ligne LF (line feed). Si le texte des données 1 commence par * (astérisque), le texte recherché peut être à n’importe quelle position dans la ligne. Le résultat de la lecture ou les informations d’erreur sont sauvegardées dans les données 2. m* : remplacer une ligne qui contient le texte spécifié par Pointeur au début des données 1. Chaque ligne se termine avec le caractère de fin de ligne LF (line feed). Si le texte des données 1 commence par * (astérisque), le texte recherché peut être à n’importe quelle position dans la ligne. Les données remplacées ou les informations d’erreur sont sauvegardées dans les données 2. Si les données 1 sont vides, une nouvelle ligne avec les données 2 est insérée à la ligne spécifiée par Nombre. Avec des lettres minuscules, les données sont sauvegardées sans être envoyées via FTP ou e-mails. |
|
+18 |
Nombre |
Nombre de colonnes CSV |
Pour r et m : nombre de lignes à rechercher, pour toutes les autres fonctions |
|
+17 |
Nom du fichier |
Nom du fichier attaché plus } Vous pouvez utiliser des noms de fichiers avec tous les caractères typiquement autorisés dans les systèmes de fichiers (espace y compris). Vous pouvez utiliser une extension de fichier autre que TXT ou CSV. Pour supprimer un jeu de fichiers, vous pouvez utiliser des symboles de remplacement (*, ? mais pas la combinaison *.*). |
|