Monitor de Bprocs

bcabrera · 14 Agosto, 2024 17:36

Monitor de Bprocs

¿Qué es?

Se monitorean los procesos ejecutados desde los Bprocs, a través del uso de servicios propios o de terceros (distintos orígenes).

El monitor muestra cada una de las ejecuciones de los Bprocs (Maestros, Transacciones) , con su estado actual, y los tiempos de la última ejecución, o ejecución en curso.
Se puede ejecutar desde el monitor la siguiente acción:
- Acción “Reprocesar última ejecución”
  Está disponible solo para Bproc de Maestro o transacciones, en modo Webhook, cuando el estado de ejecución sea “Finalizado con error” y si el bproc tiene activo el check de permite reprocesado.
El Bproc informa los errores ocurridos que estén dentro de su alcance de ejecución (Controlados o no Controlados).
Informa acerca del estado de avance de la ejecución.
La fecha y hora exacta de la última actualización.
El resultado (estado): “Error” o “Finalizado ok”
Un mensaje de error para el caso que el resultado haya sido Error.
Otros datos de interés particulares, por ejemplo información en formato json, que puedan ser usados luego en otros procesos.

Vista de Monitor de Bprocs

Menú de acceso:

Menú → Configuración → Diseño del Espacio de Trabajo → Actualizaciones → Monitor de BProcs

Al ingresar se muestran los siguientes parámetros en los cual se puede filtrar qué bprocs mostrar:

Fecha de ejecución desde y hasta, ambos de carga obligatoria.
Por defecto ambos tienen asignada la fecha del día.
Tipo: se puede elegir: Maestro o Transacción, por defecto muestra todos.
Modo de ejecución: se puede elegir: Manual o Webhook, por defecto muestra todos.
El estado: se puede elegir por el estado en que se encuentra el bproc, por defecto muestra todos.

Datos que se pueden ver en el Monitor de Bprocs

Se muestran a continuación la descripción de los campos disponibles para la vista. Un usuario puede agregar y/u ocultar los campos en el monitor de forma personalizada si los necesita.

Accion:
- Reprocesar: solo disponible para el modo de ejecución Webhook, cuando el estado es “Finalizado error”, y sí el bproc tiene activo el check de permite reprocesado.
Año - InicioEjecucion: el año en el que se inició la ejecución.
Año - LastUpdate: el año en el que fue la última actualización.
Bprocwebhooktransactionid: identifica de forma unívoca cada una de las ejecuciones de Webhooks que ocurre. Es un número autoincremental de transacciones.
Codigo: es el código que identifica de forma unívoca al Bproc para el espacio de trabajo.
Duración: es el tiempo en horas y minutos “hhhh:mm” que duró la ejecución (Tiempo comprendido entre fecha y hora de inicio y fecha y hora de finalización. Si no hay fecha de finalización se muestra vacío.
Empresa: es el código de la empresa desde donde se ejecutó la transacción.
Estado de ejecución: puede ser alguno de estas opciones:
- Si la ejecución síncrona (modos manuales de ejecución de transacción y maestros)
  - 0 - Enviado: La transacción del sistema inserta los registros dejándolos en este estado inicial antes de hacer el llamado al servicio.
  - 1 - Recibido ok: no aplicable
  - 2 - En Proceso: si el microservicio informa un estado de avance (% > 0 y < 100%) entonces pasa a este estado.
  - 3 - Finalizado ok: si el microservicio informa un estado de avance del 100% entonces pasa a este estado.
  - 4 - Finalizado error: a este estado se llega por distintos motivos:
    - Si al hacer el llamado al servicio (API Rest) ocurre algún error no controlado.
    - Si el servicio que se ejecuta devuelve un error

Importante: en estos casos, a diferencia de la ejecución webhook, siempre es el Bproc quien registra los errores

Si la ejecución asíncrona (Modos de ejecución Webhook de transacción y maestro)
- 0 - Enviado: La transacción del sistema inserta los registros dejándolos en este estado inicial, previamente al llamado al servicio.
- 1 - Recibido ok: tras recibir el acuse de recibo “Ok” del receptor, el Emisor (1 hilo x Webhook) pone el registro en este estado
- 2 - En Proceso: si el microservicio informa un estado de avance (% > 0 y < 100%) entonces pasa a este estado.
- 3 - Finalizado ok: si el microservicio informa un estado de avance del 100% entonces pasa a este estado.
- 4 - Finalizado error: a este estado se llega por distintos motivos:
  - El Bproc: si al hacer el llamado al servicio (API Rest) ocurre algún error no controlado.
  - El Bproc: si el servicio que se ejecuta devuelve un error en vez del response de confirmación de recepción
  - El servicio: si ocurre algún error en la ejecución del servicio, este a través de la API, cambia a este estado y registra el mensaje de error correspondiente.
Eventid: es la identificación del objeto. Puede ser el código de un documento o bien el del maestro afectado por el evento.
Evento: es el evento que se ejecutó, esto significa:
- Si es un Webhook es el evento que ocurrió que disparó el Bproc.
- Caso contrario (Manual), es el nombre de la actividad del Bproc que el usuario ejecutó.
Inicio de ejecución: Es el momento exacto en que se ejecuta el Bproc.
Mes - InicioEjecucion: el mes en el que se inició la ejecución.
Mes - LastUpdate: el mes en el que fue la última actualización.
Nombre: es el nombre del Bproc que se ejecutó.
Objeto tipo:
- Si es un maestro (tanto en modo manual como webhook): se debe indicar el VO (ProductoVO, ClienteVO, ProveedorVO, etc).
- Si es una transacción (tanto en modo manual como webhook): se debe indicar el tipo de documento (FV, FC, etc).
Objetoid: es la identificación del objeto. Puede ser el código de un documento o bien el del maestro afectado por el evento.
Observaciones: puede ser usado tanto el Bproc como el servicio receptor para registrar errores.
Payload: guarda todo el Payload enviado a la API Rest. Su uso es opcional, si es nulo entonces no se habilita el reproceso.
Progreso: puede tomar valores desde 0 a 100. Inicialmente es 0, es actualizado por los propios servicios a través de APIs disponibles.
Semana - InicioEjecucion: el día en el que se inició la ejecución.
Semana - LastUpdate: el día en el que fue la última actualización.
Tipo: Indica si el Bproc es de tipo “Transacción” o “Maestro”.
Trimestre - InicioEjecucion: el número de Q en el que se inició la ejecución.
Trimestre - LastUpdate: el número de Q en el que fue la última actualización.
Ultima actualización: es la fecha y hora del último cambio de estado, sirve para controlar cuándo fue la última vez que hubo novedades del servicio, se actualiza al cambiar el estado, el porcentaje de avance, o bien al indicar la fecha de finalización.
Usuario: el código del usuario que generó el evento. (en go se usan los emails como código)

Para agregar y/u ocultar campos en el monitor tienes que seleccionar en “Visibilidad de campos” donde se muestran todos los campos. Puedes seleccionar en caso que quieras que se muestren o deseleccionar en caso que quieras que se oculten. Luego hace click en “Aceptar” para que se guarden los cambios.