Table of Contents

maxLevel	2

1 - Servicio IAdviceService

...

El servicio de avisos y alertas proporciona un sistema centralizado de envío de notificaciones.

1.1 - Método 'createAdvice'

...

Expand

title	Más detalles...

1.2.1 - Signatura

ResultErrorAdviceSMS createAdviceSMS(ParamCreateAdviceSMS paramCreateAdviceSMS)

1.2.2 - Parámetros de invocación

Nombre	Tipo	Longitud máxima	Descripción	Obligatorio
ParamCreateAdviceSMS				Sí
idApplication	String	-	Identificador de la aplicación asignada en PAU.	Sí
user	String	-	NIF del usuario promotor/responsable de la alerta (a efectos de auditoría / estadísticas). Por compatibilidad con versiones anteriores no es obligatorio, pero deberá indicarse en nuevas integraciones ya que en un futuro podría serlo.	No
AdviceSMS				Sí
anagrama	String	30	Dirección de correo electrónico o NIF del usuario al que se le quiere enviar el aviso. En el caso de informarse el NIF, el usuario deberá estar dado de alta en SIU con un correo electrónico asociado.	Sí (si se usa canal MAIL o canal AMBOS)
application	String	50	Código de la aplicación dada de alta en la plataforma SGA	Sí (si se usa canal MAIL o canal AMBOS)
date	String	-	Fecha en la que se enviará el aviso en uno de los siguientes formatos: dd/MM/yy dd/MM/yy HH:mm dd/MM/yyyy dd/MM/yyyy HH:mm Si no se especifica se creará con la fecha de la petición.	No
description	String	-	Descripción. Se permite el uso de HTML.	Sí (si se usa canal MAIL o canal AMBOS)
subject	String	25	Asunto del aviso	Sí (si se usa canal MAIL o canal AMBOS)
type	String	100	Tipo de aviso utilizado para agrupar avisos dentro de una misma categoría	Sí
entityId	Long		Identificador de la entidad de envío, por defecto 0 (Gobierno de Aragón)	No
mailSubject	String	200	Asunto del correo. Si se deja en blanco, el aviso se enviará con el asunto del correo creado por defecto en base de datos	No
phoneNumber	String	9	Número de teléfono al que se enviará el SMS	Sí (si se usa canal SMS o canal AMBOS)
textSMS	String	160	Texto del SMS	Sí (si se usa canal SMS o canal AMBOS)
requestType	String	-	Tipo de canal por el cual se desea mandar el aviso: MAIL, SMS, AMBOS.	Sí (se debe indicar siempre el tipo de canal)

1.2.3 - Parámetros de respuesta

En la respuesta se devuelve siempre un objeto ResultErrorAdviceSMS.

Nombre	Tipo	Descripción
error	String	Este campo siempre será rellenado con uno de los siguientes valores: 0 → No ha habido ningún error 1 → Indica que ha habido un error en el canal MAIL 2 → Indica que ha habido un error en el canal SMS 3 → Indica que ha habido un error en ambos canales
mailErrorCode	String	Este campo solamente se rellena si el campo "error" es 1 o 3
mailErrorMsg	String	Este campo solamente se rellena si el campo "error" es 1 o 3
smsErrorCode	String	Este campo solamente se rellena si el campo "error" es 2 o 3
smsErrorMsg	String	Este campo solamente se rellena si el campo "error" es 2 o 3

Ejemplos de utilización según el tipo de canal invocado:

Invocamos por el canal MAIL → El campo "error" será 0 (si todo ha ido bien) o 1 (si se ha producido un error). Si es 1, pasaremos a obtener mailErrorCode y mailErrorMsg.
Invocamos por el canal SMS → El campo "error" será 0 (si todo ha ido bien) o 2 (si se ha producido un error). Si es 2, pasaremos a obtener smsErrorCode y smsErrorMsg.
Invocamos por el canal AMBOS → El campo "error" será 0 (si todo ha ido bien) o 1 (si se ha producido un error con el MAIL) o 2 (si se ha producido un error con el SMS) o 3 (si ha fallado tanto el MAIL como el SMS)
- Si es 1 → Obtener mailErrorCode y mailErrorMsg
- Si es 2 → Obtener smsErrorCode y smsErrorMsg
- Si es 3 → Obtener mailErrorCode, mailErrorMsg, smsErrorCode y smsErrorMsg

1.2.4 - Códigos de error

Descritos en la sección "Tipificación, codificación y descripción de errores"

Code Block

language	java
title	Invocación por canal MAIL

ParamCreateAdviceSMS paramCreateAdviceSMS = new ParamCreateAdviceSMS();
paramCreateAdviceSMS.setIdApplication("SGA");
         
AdviceSMS adviceSMS = new AdviceSMS();
adviceSMS.setAnagrama("correo@gmail.com");
adviceSMS.setApplication("SGA");
adviceSMS.setDate("18/12/19"); // si no se pone, la fecha será la de la petición
adviceSMS.setDescription("Correo de prueba");
adviceSMS.setEntityId(0L); //si no se pone, será 0 por defecto
adviceSMS.setMailSubject("Prueba createAdviceSMS");
adviceSMS.setSubject("Prueba");
adviceSMS.setType("SGA");
adviceSMS.setRequestType(AdviceSMS.RequestType.MAIL.toString());
         
paramCreateAdviceSMS.setAdviceSMS(adviceSMS);
         
ResultErrorAdviceSMS resultErrorAdviceSMS = adviceServiceWS.createAdviceSMS(paramCreateAdviceSMS);
         
if(resultErrorAdviceSMS.getError().equals(ResultErrorAdviceSMS.NO_ERROR)) {
    System.out.println("Proceso por canal MAIL realizado correctamente");
} else {
    System.out.println("Error al realizar el proceso por canal MAIL");
    System.out.println("Código Error: " + resultErrorAdviceSMS.getMailErrorCode());
    System.out.println("Mensaje Error: " + resultErrorAdviceSMS.getMailErrorMsg());
}

Code Block

language	java
title	Invocación por canal SMS

ParamCreateAdviceSMS paramCreateAdviceSMS = new ParamCreateAdviceSMS();
paramCreateAdviceSMS.setIdApplication("SGA");
         
AdviceSMS adviceSMS = new AdviceSMS();
adviceSMS.setPhoneNumber("611223344");
adviceSMS.setTextSMS("SMS de prueba");
adviceSMS.setRequestType(AdviceSMS.RequestType.SMS.toString());
         
paramCreateAdviceSMS.setAdviceSMS(adviceSMS);
         
ResultErrorAdviceSMS resultErrorAdviceSMS = adviceServiceWS.createAdviceSMS(paramCreateAdviceSMS);
         
if(resultErrorAdviceSMS.getError().equals(ResultErrorAdviceSMS.NO_ERROR)) {
    System.out.println("Proceso por canal SMS realizado correctamente");
} else {
    System.out.println("Error al realizar el proceso por canal SMS");
    System.out.println("Código Error: " + resultErrorAdviceSMS.getSmsErrorCode());
    System.out.println("Mensaje Error: " + resultErrorAdviceSMS.getSmsErrorMsg());
}

Code Block

language	java
title	Invocación por canal AMBOS

ParamCreateAdviceSMS paramCreateAdviceSMS = new ParamCreateAdviceSMS();
paramCreateAdviceSMS.setIdApplication("SGA");
                 
AdviceSMS adviceSMS = new AdviceSMS();
adviceSMS.setAnagrama("correo@gmail.com");
adviceSMS.setApplication("SGA");
adviceSMS.setDate("18/12/19"); // si no se pone, la fecha será la de la petición
adviceSMS.setDescription("Correo de prueba");
adviceSMS.setEntityId(0L); //si no se pone, será 0 por defecto
adviceSMS.setMailSubject("Prueba createAdviceSMS");
adviceSMS.setSubject("Prueba");
adviceSMS.setType("SGA");
adviceSMS.setPhoneNumber("611223344");
adviceSMS.setTextSMS("SMS de prueba");
adviceSMS.setRequestType(AdviceSMS.RequestType.AMBOS.toString());
                 
paramCreateAdviceSMS.setAdviceSMS(adviceSMS);
                 
ResultErrorAdviceSMS resultErrorAdviceSMS = adviceServiceWS.createAdviceSMS(paramCreateAdviceSMS);
                 
if(resultErrorAdviceSMS.getError().equals(ResultErrorAdviceSMS.NO_ERROR)) {
    System.out.println("Proceso por canal AMBOS realizado correctamente");
} else if (resultErrorAdviceSMS.getError().equals(ResultErrorAdviceSMS.MAIL_ERROR)) {
    System.out.println("Error al realizar el proceso MAIL por canal AMBOS");
    System.out.println("Código Error: " + resultErrorAdviceSMS.getMailErrorCode());
    System.out.println("Mensaje Error: " + resultErrorAdviceSMS.getMailErrorMsg());
} else if (resultErrorAdviceSMS.getError().equals(ResultErrorAdviceSMS.SMS_ERROR)) {
    System.out.println("Error al realizar el proceso SMS por canal AMBOS");
    System.out.println("Código Error: " + resultErrorAdviceSMS.getSmsErrorCode());
    System.out.println("Mensaje Error: " + resultErrorAdviceSMS.getSmsErrorMsg());
} else {
    System.out.println("Error al realizar el proceso MAIL y el proceso SMS por canal AMBOS");
    System.out.println("Código Error MAIL: " + resultErrorAdviceSMS.getMailErrorCode());
    System.out.println("Mensaje Error MAIL: " + resultErrorAdviceSMS.getMailErrorMsg());
    System.out.println("Código Error SMS: " + resultErrorAdviceSMS.getSmsErrorCode());
    System.out.println("Mensaje Error SMS: " + resultErrorAdviceSMS.getSmsErrorMsg());
}

...

2. - Servicio IEventsService

...

El servicio de gestión de eventos proporciona un sistema centralizado de envío de notificaciones entre aplicaciones a fin de disminuir el tráfico innecesario entre ellas y aumentar el control sobre el flujo de información.

2.1.- Método 'sendNotification'

Este método es utilizado por las aplicaciones emisoras de eventos para enviar sus eventos a las aplicaciones suscritas por medio de sga. Un evento es un listado genérico de datos, por lo que cada aplicación deberá de informar y explicar a los receptores los datos que envía en los eventos.

Expand

title	Más datos...

2.1.1 - Signatura

ResultError sendNotification(ParamCreateEvent paramCreateEvent)

2.1.2 - Parámetros de invocación

Nombre	Tipo	Descripción
ParamCreateEvent		Encapsula los datos del evento que se quiere enviar y opcionalmente la aplicación destinataria
event	Event	Información del evento que se desea enviar.
appTo	String	Identificador de la aplicación destinataria del evento. Si no se especifica se enviará a todas las aplicaciones que estén suscritas.
Event
appCode	String	Identificador de la aplicación origen del evento.
method	String	Nombre del método origen del evento.
data	Map<String, String>	Datos a enviar en forma de pares clave-valor.

2.1.3 - Parámetros de respuesta

Tipo	Descripción
ResultError	Resultado de la creación del envío.

2.2.4.- Códigos error

Descritos en la sección "Tipificación, codificación y descripción de errores"

2.2.5.- Ejemplo de invocación

Code Block

language	java

// DATOS - Evento
String identificadorAppOrigen = "SNT"; // (Obligatorio) Identificación de la app origen del evento
String method = "enviarNotificacion"; // (Obligatorio) Nombre del método origen del evento
// Se rellenan los datos del evento
Map<String, String> dataMap = new LinkedHashMap<String, String>();
dataMap.put("id", "test");
Event event = new Event(identificadorAppOrigen, method, dataMap);
 
// DATOS - ParamCreateEvent
String identificadorAppDestinataria = "PFI"; // (No obligatorio) Identificación de la app destinataria del evento
ParamCreateEvent paramCreateEvent = new ParamCreateEvent(event, identificadorAppDestinataria);
 
// Petición a SGA
ResultError resultError = eventsServiceWS.sendNotification(paramCreateEvent);
 
// Gestión de la respuesta
if ("true".equals(resultError.getError())) {
    // gestión del error
    System.out.println("Se ha producido un error en la petición");
    if (resultError.getErrorCode() != null) {
        System.out.println("Error: " + resultError.getErrorCode() + ". Mensaje: " + resultError.getErrorMsg());
    }
}

...

Code Block

title	Interfaz NotificationManager

/**
 * Interfaz REST común para las aplicaciones que integren el sistema de eventos
 *
 */
public interface NotificationManager{
     
    @PUT
    @Consumes(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_JSON)
    Map<Long, Boolean> processNotification(RestEvent eventData);
 
}

El objeto RestEvent contiene información sobre la aplicación y el método origen del evento. Además contiene un objeto tipo Map donde cada entrada tiene como clave un id único y como valor el mapa de los datos del evento propiamente dichos.

El servicio tiene que devolver un mapa donde la clave sea ese id único y el valor el resultado de procesar los datos asociados (true → procesado con éxito; false → se ha producido algún error).

ANEXO 2: Clases comunes a los servicios

...

Versions Compared

Old Version 3

New Version 4

Key

1 - Servicio IAdviceService

1.1 - Método 'createAdvice'

1.2.1 - Signatura

1.2.2 - Parámetros de invocación

1.2.3 - Parámetros de respuesta

1.2.4 - Códigos de error

2. - Servicio IEventsService

2.1.- Método 'sendNotification'

2.1.1 - Signatura

2.1.2 - Parámetros de invocación

2.1.3 - Parámetros de respuesta

2.2.4.- Códigos error

2.2.5.- Ejemplo de invocación

ANEXO 2: Clases comunes a los servicios

Page Comparison

Versions Compared

Old Version 3

New Version 4

Key

1 - Servicio IAdviceService

1.1 - Método 'createAdvice'

1.2.1 - Signatura

1.2.2 - Parámetros de invocación

1.2.3 - Parámetros de respuesta

1.2.4 - Códigos de error

2. - Servicio IEventsService

2.1.- Método 'sendNotification'

2.1.1 - Signatura

2.1.2 - Parámetros de invocación

2.1.3 - Parámetros de respuesta

2.2.4.- Códigos error

2.2.5.- Ejemplo de invocación

ANEXO 2: Clases comunes a los servicios