Este instructivo explica cómo configurar un método de publicación con tipo de acceso Archivo en Deals, cubriendo los tres medios disponibles: Email, FTP/SFTP y Manual.
10 min
¿Para qué sirve?
El acceso Archivo permite ingresar datos a Deals desde archivos estructurados en formato Excel (.xlsx) o CSV. Según el medio elegido, el archivo puede llegar por correo electrónico, ser levantado desde un servidor remoto (FTP/SFTP) o cargarse manualmente desde la interfaz. En los tres casos, el contenido se interpreta y transforma mediante el motor de mapeo de Deals antes de ser procesado por la descarga configurada.
Antes de empezar
- Tener creado el documento en el Catálogo de Documentos con su SCHEMA definido.
- Tener configurada la Descarga asociada al documento.
- Para Email y FTP/SFTP con URL Genérica activada: contar con un mapeo dinámico configurado (ver [Deals — Mapeo Dinámico]).
Modo de uso
Menú → Deals → Publicaciones → Nuevo → Acceso: Archivo
Al seleccionar Archivo en el campo Acceso, aparece el campo Medio con tres opciones: Email, FTP/SFTP y Manual. Cada medio despliega su propia solapa de configuración.
Medio: Email
El método recibe el archivo como adjunto de un correo electrónico enviado a una dirección fija asignada a la empresa.
Opciones generales del medio Email
| Campo / Check | Descripción |
|---|---|
| URL genérica de Procesamiento (check) | Al activarse, Deals procesa el archivo Excel/CSV de forma nativa usando su motor de mapeo visual, sin necesidad de programar microservicios externos. Al desactivarse, se habilita el campo URL Procesamiento para apuntar a un microservicio propio que puede manejar cualquier formato (incluidos PDF o formatos especiales). |
| URL Procesamiento | Campo opcional visible cuando el check de URL genérica está desactivado. Permite especificar un endpoint externo que valide credenciales o parámetros antes de ejecutar la acción principal. |
Solapa “Configuración de Email”
| Campo | Descripción |
|---|---|
| Dirección de Email | Dirección fija asignada automáticamente a la empresa al momento de su activación en Deals. No es editable. |
| Asunto (obligatorio) | Texto exacto que debe incluir el asunto del correo para que el método identifique y procese el adjunto. Correos con asunto distinto son ignorados. |
| Notificar Errores | Permite seleccionar uno o más usuarios del sistema para que reciban una alerta por correo si el archivo adjunto falla los controles previos antes de ingresar al monitor. |
| Controlar direcciones de Email (Lista Blanca) | Filtro de seguridad que restringe la recepción únicamente a correos enviados desde direcciones registradas en la lista. Los mensajes de remitentes no autorizados son rebotados automáticamente. |
| Aplica Mapeo | Activa el motor de mapeo dinámico para este método. Al marcarse, aparece la solapa Mapeo donde se configura la relación entre las columnas del archivo y los campos del SCHEMA. Ver [Deals — Mapeo Dinámico]. |
Medio: FTP/SFTP
El método consulta periódicamente una carpeta en un servidor remoto y levanta los archivos nuevos que encuentre.
El check Genera Job está activado por defecto y no puede desactivarse para este medio. Los servidores FTP/SFTP no generan eventos automáticos al recibir un archivo, por lo que el sistema requiere una consulta periódica obligatoria para detectar archivos nuevos.
Opciones generales del medio FTP/SFTP
| Campo / Check | Descripción |
|---|---|
| Genera Job (check) | Activado por defecto. Genera un Servicio Programable que consulta el servidor remoto de forma periódica. La frecuencia se ajusta desde Menú → GO → Servicios Programables. |
| URL genérica de Procesamiento (check) | Mismo comportamiento que en el medio Email. |
| URL Procesamiento | Mismo comportamiento que en el medio Email. |
Solapa “Configuración de FTP/SFTP”
| Campo | Descripción |
|---|---|
| Protocolo | Permite alternar entre FTP y SFTP. Determina el protocolo de transporte utilizado. |
| Host | Nombre de dominio o dirección IP del servidor remoto. Campo obligatorio. |
| Usuario | Nombre de cuenta para autenticarse en el servidor. |
| Clave | Contraseña asociada al usuario configurado. |
| Puerto | Canal de comunicación del servidor. Se asigna automáticamente 21 al elegir FTP y 22 al elegir SFTP. |
| Directorio Origen | Ruta de la carpeta remota donde se depositan los archivos a leer (ej. data/origen). El sistema busca archivos nuevos en esta ubicación en cada ciclo. |
| Directorio Procesada | Ruta de la carpeta remota a la que el sistema mueve los archivos una vez leídos con éxito (ej. data/destino). Evita que un mismo archivo se reprocese en ciclos posteriores. |
| Mantener archivos con error | Si se activa y el procesamiento de un archivo falla, el archivo no se traslada al Directorio Procesada y permanece en el Directorio Origen para su revisión. |
| Generar archivos con detalle de errores | Al activarse, el sistema genera un archivo de log con la descripción detallada de los errores detectados, dentro de la carpeta de procesados. |
| Aplica Mapeo | Mismo comportamiento que en el medio Email. Ver [Deals — Mapeo Dinámico]. |
Medio: Manual
El método habilita la carga de archivos directamente desde la interfaz de Deals, sin intervención de un canal externo (correo o servidor).
Para usar la Carga Manual, el usuario debe acceder a la grilla de Publicaciones, localizar el método y seleccionar la acción Carga Manual desde el ícono de tres puntos (⋮).
Solapa “Configuración Manual”
| Campo | Descripción |
|---|---|
| Asociación de Mapeo | Exige la selección de un mapeo existente o la creación de uno nuevo para interpretar el contenido del archivo subido. Sin mapeo configurado, la carga no puede ejecutarse. |
| Filtro de Extensiones | Permite delimitar los formatos de archivo aceptados. El usuario escribe manualmente las extensiones permitidas (ej. XLS, XML). Si el campo queda vacío, la plataforma acepta cualquier tipo de archivo. |
Solapa “Parámetros” (todos los medios)
Disponible en los tres medios, permite definir variables de entrada adicionales para el método.
| Campo | Descripción |
|---|---|
| Código | Identificador interno del parámetro. |
| Tipo de dato | Tipo del valor esperado: Texto, Password o Fecha. |
| Valor por defecto | Valor que toma el parámetro si no se envía uno explícito. |
| Visibilidad | Controla si el parámetro es visible en la interfaz de usuario. |
| Nombre amigable | Etiqueta que se muestra al usuario en la interfaz. |
| Descripción | Texto explicativo del propósito del parámetro. |
Qué hace y qué no hace
- Sí: recibe archivos Excel/CSV por tres vías distintas (email, servidor remoto o carga directa) y los procesa con el motor de mapeo de Deals.
- Sí: permite usar un microservicio propio para procesar formatos no estándar desactivando la URL Genérica de Procesamiento.
- Sí: el medio FTP/SFTP mueve automáticamente los archivos procesados al Directorio Procesada para evitar reprocesamiento.
- No: el acceso Archivo no admite documentos PDF no estructurados; para eso se usa el tipo Acceso Archivo PDF con IA (ver Unidad 5).
- No: el medio Manual no tiene configuración de origen externo; el usuario debe subir el archivo de forma activa desde la interfaz en cada ocasión.