Syntaxe des commandes pour des opérations de fichiers API

Les paramètres décrits ici sont utilisés implicitement par les blocs fonctions FP-I4C.

NOTA

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.

Balises

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 :

Paramètres

Offset de caractères

Paramètre

Valeurs

Exemple

Fichier CSV

Fichier TXT

 

+0

Code de départ

{A

{A_

+3

Type de registre API

D: DT, F : FL, L : LD

D_

+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

00200_

+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 ; 00001_ pour transmettre des données ou 00000_ pour tester une commande avec P

Aucune donnée n’est écrite si l’adresse de départ de la chaîne de caractères de destination est 0000.

CSV : 00066_

TXT : 00001_

+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.

S

+18

Nombre

Nombre de colonnes CSV

Pour r et m : nombre de lignes à rechercher, pour toutes les autres fonctions 01_

04_

+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 *.*).

filename.csv