# WriteData

Utilice la función WriteData para escribir datos en un archivo o anexar una cadena de datos a un archivo en un dispositivo local o en un servidor FTP. Puede utilizar esta función para registrar resultados de datos y verlos en un archivo.

Nota: Puede guardar el archivo en la ubicación de almacenamiento seleccionada tanto si se está en línea como sin conexión.

## Entradas de WriteData

Parámetro | Descripción
Datos | Especifica una cadena de texto o una referencia a una celda que contiene una cadena de texto que ha de escribirse o anexarse a un archivo.
Evento | Especifica el evento que fuerza una actualización. Este parámetro debe ser una referencia para cualquier evento con una marca de fecha y hora, por ejemplo, uno de los siguientes: Una celda que contiene una función Event. Una celda que contiene una función Button.
Almacenamiento | Especifica si el archivo de datos ha de guardarse en un dispositivo local o en un servidor FTP. La ubicación para guardar depende del dispositivo conectado y de los ajustes de almacenamiento de la función.
Configuración de almacenamiento | Dispositivo conectado | Ubicación de almacenamiento
--- | --- | ---
Dispositivo local | Dispositivo In-Sight | Dispositivo In-Sight Tarjeta SD instalada en el dispositivo In-Sight Nota: Debe utilizar un software de FTP, como FileZilla Client, para ver los archivos. Para más información, consulte el tema Cómo ver los archivos almacenados en el dispositivo In-Sight. Si utiliza el almacenamiento de datos en tarjeta SD, asegúrese de tener conectada la tarjeta SD antes de ejecutar la tarea. Si configura el almacenamiento en tarjeta SD sin tener conectada una tarjeta SD, la tarea guardará los archivos en el directorio /sdcard de la unidad flash interna.
PC | PC Nota: Solo se pueden guardar datos en un ordenador mediante un servidor FTP.
Servidor FTP | Cualquier dispositivo | Servidor FTP especificado
Servidor | Especifica el nombre (o dirección IP) del servidor FTP en la red en el que ha de escribirse el archivo de datos. Un servidor FTP puede ser un emulador de In-Sight o cualquier otro dispositivo reconocido como servidor FTP en la red. Nota: Esta opción está habilitada únicamente si se ha seleccionado Servidor FTP como lugar de almacenamiento. Si se requiere un puerto en particular, puede anexar su identificación al nombre del servidor. Por ejemplo, si el servidor FTP utiliza el puerto 50021, introduzca "127.0.0.1:50021".
Nombre de usuario | Especifica el nombre de usuario del servidor FTP. Si se deja este campo en blanco, el sistema considerará el nombre "admin". Nota: Esta opción está habilitada únicamente si se ha seleccionado Servidor FTP como lugar de almacenamiento.
Contraseña | Especifica la contraseña para el servidor FTP. La contraseña distingue entre mayúsculas y minúsculas. Si el servidor FTP no requiere ninguna contraseña, puede dejar este campo en blanco. Nota: Esta opción está habilitada únicamente si se ha seleccionado Servidor FTP como lugar de almacenamiento. Por razones de seguridad, la contraseña introducida se enmascara con asteriscos en la hoja de propiedades de WriteData y en la barra de fórmulas. La contraseña se guardará en forma cifrada en el archivo de tareas.
Ruta del archivo | Especifica la ubicación en la que desea guardar el archivo. Si quiere guardar el archivo en el ordenador, podrá grabar el archivo en cualquier ubicación para la que tenga el permiso de escritura del sistema operativo. Puede introducir en este campo una ruta codificada (por ejemplo, X:/, X:/Subdir), una ruta UNC (por ejemplo, //Cognex/shared/), una unidad asignada (por ejemplo, M:/Subdir) o una ruta relativa (../../ Subdir) en este campo. Si la ruta no existe en el dispositivo In-Sight o en el ordenador, la función devolverá #ERR. La función no devuelve #ERR si la ruta de acceso o las credenciales FTP no son válidas en el servidor FTP. Si deja este campo en blanco, enviará el archivo a una de las siguientes ubicaciones predeterminadas: Dispositivo In-Sight: Directorio raíz del dispositivo. Servidor FTP: El directorio predeterminado del servidor de FTP especificado.
Nombre de archivo | Especifica el nombre del archivo de datos. Nota: Tenga en cuenta las restricciones del sistema operativo en cuanto a caracteres válidos.
Formato de datos | Especifica el tipo de archivo. Se añadirá automáticamente la extensión al nombre de archivo.
0 = TXT (por defecto) | Formato de archivo de texto ASCII estándar (.TXT).
1 = HTML | Formato de archivo HTML estándar (.HTML).
2 = XML | Formato de archivo XML estándar (.XML).
3 = CSV | Formato de archivo CSV estándar (.CSV).
Anexar | Especifica cómo se escriben los datos en el archivo.
0 = DESACTIVADO | Sobrescribe los datos existentes en el archivo.
1 = ACTIVADO (por defecto) | Anexa la cadena de datos al final del archivo.

## Salidas de WriteData

Devuelve | Una estructura WriteData con la que se escribe la cadena de datos contenida en el parámetro Data en un dispositivo local o en un servidor FTP, siempre que se active el evento referenciado. Devuelve #ERR si alguno de los parámetros de entrada no es válido o si la cola de archivos está llena. Nota: No devolverá #ERR si el servidor FTP, la ruta de acceso al servidor FTP o el nombre de archivo no válidos.