Objetivo

Este instructivo explica cómo crear, programar, compartir y utilizar una Distribución de datos en Vor-Tex. También muestra cómo suscribirse desde el portal para desarrolladores y consultar o descargar los resultados de las ejecuciones.

Crear una distribución de datos

1. Ingresá a Distribuciones de datos desde el menú lateral y hacé clic en Nueva distribución de datos.
   
   
   

2. En el paso Descripción, completá los campos obligatorios:

   • Título: nombre que identificará la distribución.
   • Descripción: explicación breve del contenido o finalidad de la distribución.

   Hacé clic en Continuar.

   
   

3. En el paso Programación, definí cuándo debe ejecutarse la distribución:

   • Seleccioná una frecuencia y una hora, o utilizá una expresión cron personalizada.
   • Revisá la descripción generada para confirmar la programación.
   • Mantené marcada la opción Activo para habilitar la creación periódica de instancias. Podés desmarcarla si necesitás pausar la distribución.

   Hacé clic en Continuar.

   
   

4. En el paso Método API, seleccioná el método que ejecutará la distribución y completá los parámetros requeridos.

   Elegí el Modo de ejecución adecuado:

   • Ejecución única (un ejecutor): ejecuta el método una vez con las credenciales del usuario seleccionado. En este modo también debés elegir el Usuario ejecutor.
   • Una ejecución por usuario suscrito: ejecuta el método una vez por cada usuario con acceso, utilizando las credenciales de cada uno.

   
   

   
   

5. Configurá la Plantilla de evaluación. Esta plantilla Jinja determina si la respuesta del método se considera exitosa y debe devolver True para indicar éxito o False en caso contrario.

   Revisá la configuración y hacé clic en Guardar.

Verificar y ejecutar la distribución

Después de guardar, se abre la pantalla de detalle. Allí podés consultar la próxima ejecución, ver los contadores de instancias en progreso, fallidas y exitosas, y revisar el historial.

Si necesitás generar una instancia sin esperar la programación, utilizá Ejecutar ahora.

Compartir la distribución

Para permitir que otras personas accedan a la distribución, abrí la acción de compartir y agregá los usuarios, grupos o roles correspondientes. Revisá la lista de destinatarios y hacé clic en Guardar.

Suscribirse desde el portal para desarrolladores

1. Ingresá al portal para desarrolladores y abrí Distribuciones de datos.

2. En la pestaña Disponibles, localizá la distribución y hacé clic en Suscribirse. Desde esta vista también podés consultar el detalle y la próxima ejecución.

   
   

3. Una vez suscripto, la distribución aparecerá en Mis suscripciones. Desde allí podés ver el detalle, activar o desactivar las notificaciones y cancelar la suscripción.

   
   

Consultar y descargar resultados

Al abrir Ver detalle, se muestra el historial de ejecuciones con filtros por estado: todas, exitosas, fallidas o en progreso. Antes de la primera ejecución programada, el historial estará vacío.

Cuando una ejecución finaliza correctamente, el registro muestra la fecha, el estado Éxito y el archivo generado. Hacé clic en Descargar para obtener el resultado.

Resultado esperado

La distribución queda programada y disponible para los usuarios, grupos o roles con los que fue compartida. Los usuarios pueden suscribirse, recibir notificaciones, consultar el historial y descargar los archivos generados por cada ejecución exitosa.