Catálogo de carpetas
La integración por archivo es la más antigua que existe y sigue siendo la más común en planta: un sistema deposita un CSV en una carpeta de red y alguien tiene que leerlo. El trabajo no está en leer el archivo — está en acertar encoding, delimitador y encabezado, que nadie acierta a la primera y que solo fallan con el primer archivo de verdad.
Este asistente responde esas preguntas mirando el archivo.
Abre por el mismo ícono de tabla del catálogo de base de datos, en Conexiones Externas o en la fila de una Aplicación — cuando la conexión es de tipo Archivo, lo que aparece es el catálogo de carpetas.
Navegar
El catálogo muestra carpetas y archivos a partir del directorio base de la conexión, con búsqueda por nombre. Es navegación de verdad: entra en las subcarpetas hasta encontrar el archivo que representa el caso.
A diferencia del catálogo de base de datos, aquí el CMS lee contenido — los primeros KB de un archivo — porque no hay forma de descubrir formato, encoding y delimitador sin mirar. La pantalla lo dice explícitamente, y nada en la carpeta se altera.
Qué descubre la detección
Elegido un archivo, el CMS analiza la muestra y responde:
| Campo | Cómo se decide |
|---|---|
| Encoding | BOM primero (es prueba); después UTF-8 estricto — texto Latin-1 con acento produce secuencia inválida y se delata; bytes nulos alternados indican UTF-16LE; nulos aislados indican binario |
| Formato | JSON, JSON por líneas, CSV, XML, texto o binario |
| Delimitador | Prueba ;, ,, tab y | y elige el que separa consistentemente |
| Encabezado | Si la primera línea del CSV parece nombres de columna |
| Columnas | Nombres del encabezado, o posicionales (campo1, campo2…) cuando no hay |
| Modo de emisión | Archivo entero en un mensaje, o una línea por mensaje |
| Vista previa | Las primeras líneas ya decodificadas, para revisar con los ojos |
La detección es determinística, sin IA. El archivo responde por sí mismo; una suposición de un modelo aquí solo podría equivocarse — mismo criterio del catálogo de base de datos.
Todo lo detectado viene completado y sigue siendo editable. Si la muestra engañó, usted lo corrige antes de generar.
Qué decide usted
| Elección | Por defecto | Por qué |
|---|---|---|
| Máscara de archivos | Las extensiones que existen en la carpeta | * tomaría el archivo de control que el otro lado usa para señalar fin de escritura |
| Modo de emisión | El detectado | Una línea por mensaje da trazabilidad por registro; archivo entero preserva el documento |
| Ignorar encabezado | El detectado | Solo tiene sentido en modo por línea |
| Acción post-lectura | MOVER | Ver abajo |
| Programación | Cron | Con qué frecuencia recorrer la carpeta |
La acción post-lectura nace en MOVER, y no se adivina
Después de leer, el CMS puede mover, renombrar, borrar o dejar el archivo. El asistente siempre sugiere MOVER.
MOVER saca el archivo del camino, lo que da idempotencia por el propio sistema de archivos: el archivo leído no se lee de nuevo, y sigue existiendo si alguien necesita revisarlo.
BORRAR es irreversible. Sugerirlo a partir de lo que se vio en una carpeta sería irresponsable: el asistente no sabe si ese archivo tiene copia en otro lugar. Si la política de su planta es borrar, márquelo usted — pero que sea una decisión, no un valor por defecto.
El sobre, y el Transformador que viene junto
En modo por línea, el CMS entrega un sobre con la línea cruda:
{
"arquivo": "PRODUCAO_20260826.csv",
"caminho": "/dados/entrada/PRODUCAO_20260826.csv",
"linha": 42,
"conteudo": "000060003285;0010;480;12;ST"
}Quien separa las columnas es un Transformador — y el asistente ya lo escribe, a partir de las columnas detectadas, con el delimitador y el encabezado correctos. Por eso las columnas del catálogo no se vuelven contrato de la Recolección: se vuelven el material con que ese Transformador se escribe.
En modo archivo entero, el mensaje es el contenido del archivo, con los metadatos adjuntos.
Solo lectura
El catálogo de carpetas genera únicamente la Recolección. Grabar archivo (FILE_WRITE) depende de
un modelo de contenido — qué columnas, en qué orden, con qué separador, con o sin encabezado — y
eso la carpeta no lo revela. Ver Archivos para configurar la escritura a
mano.
Revisión e instalación
Como en todos los asistentes: la revisión muestra cada objeto con CREAR, ACTUALIZAR o
PERSONALIZADO, las siglas son editables, y la Recolección nace desactivada.