# WriteData

Utilisez la fonction WriteData pour écrire des données dans un fichier ou ajouter une chaîne de données à un fichier sur un périphérique local ou un serveur FTP. Vous pouvez utiliser cette fonction pour enregistrer les résultats de données et les afficher dans un fichier.

Remarque : Vous pouvez enregistrer le fichier à l’emplacement de stockage sélectionné, en état En ligne ou Hors ligne.

## WriteData – Entrées

Paramètre | Description
Données | Spécifie une chaîne de caractères ou référence à une cellule contenant une chaîne de caractères que vous souhaitez ajouter à un fichier ou écrire dans ce dernier.
Événement | Indique l’événement forçant une mise à jour. Ce paramètre doit être une référence à un événement avec horodatage, par exemple l’un des événements suivants : Une cellule contenant une fonction Event. Une cellule contenant une fonction Button.
Stockage | Permet de préciser que la fonction doit enregistrer les données sur un périphérique local ou sur un serveur FTP. L’emplacement d’enregistrement dépend du périphérique connecté et du paramètre Stockage de la fonction.
Paramètre Stockage | Périphérique connecté | Emplacement d’enregistrement
--- | --- | ---
Périphérique local | Périphérique In-Sight | Périphérique In-Sight Carte SD insérée dans le périphérique In-Sight Remarque : Vous devez utiliser un logiciel FTP, le client FileZilla par exemple, pour afficher les fichiers. Pour plus d’informations, consultez la rubrique Afficher les fichiers stockés sur un périphérique In-Sight. Si vous stockez des fichiers sur une carte SD, assurez-vous d’insérer la carte SD avant d’exécuter le projet. Si l’emplacement de stockage configuré est sur la carte SD et cette dernière n’est pas insérée, le projet enregistrera les fichiers dans le répertoire /sdcard de la mémoire flash interne.
PC | PC Remarque : L’enregistrement sur un PC est uniquement possible avec un serveur FTP.
Serveur FTP | Tout périphérique | Serveur FTP spécifié
Serveur | Spécifie le nom (ou l’adresse IP) du serveur FTP réseau sur lequel enregistrer le fichier de données. Un serveur FTP peut être un émulateur In-Sight ou tout autre périphérique reconnu comme serveur FTP sur le réseau. Remarque : Cette option est activée uniquement lorsque vous sélectionnez Serveur FTP comme type de stockage. Lorsqu’un port particulier est requis, vous pouvez l’ajouter au nom du serveur. Par exemple, le serveur FTP utilise le port 50021, entrez "127.0.0.1:50021".
Nom d’utilisateur | Indique le nom d’utilisateur du serveur FTP. Lorsque ce champ est laissé vide, « admin » est utilisé. Remarque : Cette option est activée uniquement lorsque vous sélectionnez Serveur FTP comme type de stockage.
Mot de passe | Indique le mot de passe du serveur FTP. Le mot de passe est sensible à la casse. Si le serveur FTP ne possède pas de mot de passe, vous pouvez laisser ce champ vide. Remarque : Cette option est activée uniquement lorsque vous sélectionnez Serveur FTP comme type de stockage. Pour des raisons de sécurité, le mot de passe entré sera remplacé par des "*" dans la feuille de propriétés de WriteData et dans la barre de formule. Le mot de passe est enregistré dans le fichier de projet sous forme cryptée.
Chemin d’accès du fichier | Indique l’emplacement où vous souhaitez enregistrer le fichier. Vous pouvez écrire le fichier à l’emplacement de votre choix sur un PC, à l’exception des emplacements pour lesquels vous n’avez pas l’autorisation nécessaire. Dans ce champ, vous pouvez entrer un chemin codé en dur (par ex : X:/, X:/Sous-rép), un chemin UNC (par ex : //Cognex/shared/), un lecteur mappé (par exemple, M:/Sous-rép) ou un chemin relatif (../../ Sous-rép). Si le chemin n’existe pas sur le périphérique In-Sight ou sur le PC, la fonction renvoie #ERR. Si le chemin ou les informations d’identification FTP sont non valides sur le serveur FTP, la fonction ne renvoie pas #ERR. Si vous laissez ce champ vide, vous envoyez le fichier vers l’un des emplacements par défaut suivants : Périphérique In-Sight : répertoire racine du périphérique. Serveur FTP : le répertoire par défaut du serveur FTP spécifié.
Nom du fichier | Indique le nom du fichier de données. Remarque : Respectez les restrictions du système d’exploitation quant aux caractères autorisés.
Format des données | Indique le type de fichier. L’extension est automatiquement attachée au Nom de fichier.
0 = TXT (par défaut) | Format texte ASCII standard (.TXT).
1 = HTML | Format HTML standard (.HTM).
2 = XML | Format XML standard (.XML).
3 = CSV | Format CSV standard (.CSV).
Ajouter | Détermine la méthode d’écriture des données dans le fichier.
0 = OFF | remplace les données existantes dans le fichier.
1 = ON (par défaut) | ajoute la chaîne de données à la fin du fichier.

## WriteData – Sorties

Renvoie | Une structure WriteData qui écrira la chaîne de données contenue dans le paramètre Données sur un périphérique local ou un serveur FTP, à chaque fois que l’événement référencé est déclenché. Renvoie #ERR si un paramètre d’entrée est non valide ou si la file d’attente de fichiers est pleine. Remarque : Un chemin ou nom de fichier de serveur FTP non valide ne renvoie pas #ERR.