9.- Procedimiento para suscripción a eventos en SGA + PAU
Configuración en PAU.
Antes de nada, debe existir una aplicación dada de alta en PAU, la cual se quiera configurar para recibir eventos desde SGA. Se adjunta captura de la aplicación que utilizaremos para ilustrar el proceso: XFILES.
Una vez estamos seguros de que la aplicación receptora existe en PAU, debemos asegurarnos de que tiene permisos para acceder a los métodos de la aplicación emisora que va a emitir los eventos. Tomaremos como ejemplo los eventos expiredDocument y sendEvent de la aplicación PFI:
Configuración en SGA.
El primer paso a seguir si se quiere suscribir una aplicación a los eventos de otra aplicación por medio de SGA, es registrar la aplicación a la que se desean recibir los eventos desde SGA.
Para ello, debemos estar identificados en el portal de administración de la aplicación de SGA y acceder en el menú lateral, en la sección de “Registrar aplicaciones”:
Tras esto, se han de rellenar los campos:
Código: código de la aplicación (ya existente en
PAU)
Url: url de la aplicación que se va a añadir como enlace en el correo de notificación.
Url REST: la url a la que
SGAenviará los eventos, que tiene que estar disponible en la aplicación.
Número máximo de avisos: número máximo de correos que emitirá
SGAhacia la aplicación antes de agrupar.
Periodicidad: minutos transcurridos antes de enviar un correo, sino se rellena, los correos se mandan por defecto a las 00:00 del día siguiente. A este tiempo hay que sumarle el tiempo de la tarea programada
Nombre real de la aplicación: si se está creando una aplicación con otro alias distinto, sería útil rellenar aquí el nombre de la aplicación.
Se muestra un ejemplo de la aplicación XFILES:
Una vez se ha registrado la aplicación receptora de los eventos, debemos suscribirnos a los métodos de una aplicación que los tenga expuestos en SGA (sección “Métodos expuestos” del ejemplo de XFILES anterior). Esto lo haremos desde la sección del menú lateral “Administración de suscripciones”:
En esta sección, seleccionamos la opción “Añadir” y se nos abrirá la ventana para poder poner la aplicación receptora, la aplicación emisora y el método al que se suscribe, aparte de otros parámetros de configuración.
Aplic. destino: código de la aplicación que se ha registrado previamente.
Método: aquí se configura el código y el método de la aplicación que emite los eventos a los que se desea suscribir.
Activa: para que funcione correctamente y no se ignore.
Asíncrona / Agrupable: las suscripciones asíncronas sólo reciben las notificaciones cuando se realiza la tarea programada de SGA de enviar los avisos pendientes, en lugar de recibir las notificaciones en el momento en el que se generan por parte de la aplicación / método configurados. A su vez, en dicha tarea programada se mandan primero los avisos de suscripciones no agrupables (se envían los avisos por separado) y después los de las agrupables (se engloban todos los avisos sucedidos en un intervalo de horas definido por el usuario)
Intervalo: intervalo en horas que debe de transcurrir para que se envíen los eventos agrupables (obligatorio si “Agrupable” está marcado).
Reintentos: número de intentos de envío de la notificación. Una vez pasado este número, se marcará el evento como erróneo.
Tomaremos, como se ha hecho anteriormente, la suscripción de XFILES a los métodos expiredDocument y sendEvent de la aplicación PFI:
Método expiredDocument:
Método sendEvent:
Una vez se ha configurado en PAU y en SGA, cada vez que la aplicación emisora envía eventos a SGA, ésta notificará a las aplicaciones suscritas a dichos métodos, a la Url REST configurada de la/s aplicación/es suscrita/s.