Recolecciones de datos

Recolecciones de datos

Resumen

Recolecciones de Datos es una funcionalidad diseñada para gestionar la recepción de archivos directamente desde el Portal de APIs. A través de esta herramienta, el usuario del portal puede cargar archivos, completar parámetros y ejecutar procesos de integración. 

Puede consultar cómo crear y gestionar recolecciones de datos en este artículo.

Catálogo de recolecciones de datos

En el inicio del Portal puede conocer el listado de recolecciones de datos al que tiene acceso:

Utilizar recolección de datos

Esta pantalla permite a los usuarios finales gestionar y ejecutar las instancias de recolección de datos asignadas. A continuación, se detallan los componentes principales de la interfaz:



1. Panel de Resumen de Instancias

En el lateral izquierdo, se visualiza un tablero con el estado actual de todas las instancias de recolección del usuario:

  • Por hacer: Cantidad de instancias disponibles pendientes de envío.

  • En progreso: Envíos que están siendo procesados actualmente por el sistema.

  • Fallida: Instancias cuya ejecución resultó en un error (según la validación del método o la plantilla Jinja).

  • Expirada: Instancias que no fueron enviadas dentro del límite de tiempo configurado.

  • Éxito: Recolecciones completadas correctamente.


2. Historial de Envíos

Debajo del resumen, se presenta un listado cronológico de cada instancia generada según la frecuencia programada. Cada registro muestra la fecha, hora y su estado actual (ej. "POR HACER", "EXPIRADA", "ÉXITO").

Al seleccionar una instancia Por hacer del historial, se habilita el formulario de envío a la derecha.

3. Formulario de Envío (Enviar Instancia)

Es el área principal de interacción donde el usuario completa la integración:

  • Indicadores de Tiempo: Próxima recolección en Indica cuánto falta para que el sistema genere automáticamente una nueva instancia.

  • Parámetros: Sección donde el usuario debe completar los datos adicionales requeridos por el método de la API (por ejemplo, el campo operatorIdentifier). Estos pueden ser campos obligatorios marcados con un asterisco.

  • Carga de Archivo (Parámetro file): * Área de Drag & Drop para subir el archivo (ej. un CSV en formato UTF-8).

  • Botón Enviar: Ejecuta el método de la API configurado.


4. Conocer resultado de la ejecución

Al seleccionar una instancia Éxito o Fallida del historial, se muestran los detalles de la ejecución.