Saltar al contenido principal

Convertir a CSV

Configuración actual de la tarea Convertir a CSV en el Diseñador de Flujos de Trabajo

La Tarea Convertir a CSV tiene como objetivo convertir un archivo de datos estructurados, típicamente una hoja de cálculo Excel (.xlsx), en un archivo de texto en formato CSV (Coma Separada). Esta operación es fundamental para transformar datos de un formato legible y formateado a un formato universal y fácilmente procesable por otros sistemas automatizados o Tareas posteriores (como CSV a Tabla).

Configuración​

La configuración de la Tarea permite especificar el archivo de origen, el separador para la salida y, opcionalmente, la destinación del archivo CSV generado.

  • Archivo a Importar: En este campo se debe ingresar la ruta completa del archivo a convertir (por ejemplo, un archivo .xlsx). Puede ser un valor estático o un parámetro dinámico proveniente de un Tarea anterior o de los parámetros del Flujo de Trabajo.
  • Separador de Salida CSV: Este campo permite especificar el carácter que se utilizará para separar los valores en las columnas del archivo CSV de salida. Es una configuración crucial para garantizar la compatibilidad con el sistema que deberá leer el archivo.
  • El valor predeterminado es la coma (,).
  • Puede personalizarlo con otros separadores comunes, como el punto y coma (;) o la barra vertical (|).
  • Ruta del Archivo (Casilla de Verificación): Seleccionando esta opción, es posible especificar una destinación personalizada para el archivo de salida, en caso contrario se utilizará una destinación predeterminada. Al seleccionarla, se mostrarán los siguientes campos:
  • Ruta de salida: Aquí se debe ingresar la ruta de la carpeta en la que se desea guardar el archivo CSV convertido.
  • Crear ruta si no existe: Si se activa, crea automáticamente la carpeta de destino si no existe. Si se desactiva, la Tarea fallará si la carpeta no está presente.

Destinación Predeterminada​

El comportamiento predeterminado depende de cómo se proporciona el archivo de origen:

  • Caso 1: Entrada a través de un Parámetro de tipo "Archivo" Cuando el archivo de origen se pasa a través de un parámetro dinámico proveniente de una Tarea anterior o de los parámetros del Flujo de Trabajo, el archivo CSV convertido se guarda en una directorio gestionado por el sistema.
  • Caso 2: Entrada a través de Ruta Escrita Manualmente Cuando en el campo "Archivo a importar" se escribe directamente la ruta completa de un archivo existente (por ejemplo, /datos/entrada/report.xlsx), el archivo CSV convertido se guarda por defecto en la misma carpeta que el archivo de origen (es decir, en /datos/entrada/).

Parámetros de Salida​

Una vez completada la conversión, la Tarea expone los siguientes parámetros:

  • file: Devuelve la ruta completa del archivo CSV recién creado (por ejemplo, /ruta/salida/report.csv). Este parámetro es ideal para pasar el archivo a Tareas posteriores, como por ejemplo un enviar correo electrónico con anexo.
  • filename: Devuelve solo el nombre del archivo CSV generado (por ejemplo, report.csv).
  • result: Indica el estado general de la operación de conversión (por ejemplo, "Éxito" o un mensaje de error).
  • resultJson: Representa el resultado de la ejecución de la tarea en formato JSON, incluyendo información general, configuraciones y detalles sobre la ejecución.