TipoComunicado
Tabla maestra precargada con el catálogo de tipos de comunicado en el modelo de datos del módulo de comunicados. Viene a representar las posibles gestiones que pueden generar comunicados, no es un catálogo de todos los posibles tipos de comunicado que se puedan generar el en SGI, ya que esto será contemplado por cada gestión particular que gestionará su propio catálogo de códigos de tipo de comunicado (campo codigo de la tabla Comunicado) y la informará al módulo de comunicados al generar cada uno.
| Campo | Descripción | Propiedades |
|---|---|---|
| id | Identificador único del tipo de comunicado | Autogenerado Obligatorio Primary Key |
| prefijo | Prefijo agrupación. Se usará para localizar en el fichero de recursos los siguientes datos (suponiendo que PREFIJO es la variable que hace referencia a cada prefijo concreto y CODIGO la que hace referencia al código de comunicado que se informe en la tabla de comunicados descrita más abajo):
| Obligatorio Unique Key |
| descripcion | Descripción de la agrupación | Opcional |
ConfiguracionComunicado
Tabla maestra de configuración de la recepción de comunicados por email parte de cada usuario. Solo se configura si se recibe email o no y para qué gestiones recibir los comunicados por email, considerándose a efectos de BBDD los comunicados "Generales" como una gestión más.
Dentro del SGI se recibirán siempre los comunicados por parte de los destinatarios de los mismos, tengan activa la recepción por email o no. (Caso potencialmente excepcional, comunicados Generales, pendiente de definir).
La ausencia de un registro de configuración en esta tabla para un usuario será equivalente a que haya un registro indicando que no desea recibir por email ningún comunicado (enviar email = NO)
| Campo | Descripción | Propiedades |
|---|---|---|
| id | Identificador único de la configuración de recepción de comunicados por email para un destinatario. | Autogenerado Obligatorio Primary Key |
| destinatarioRef | Identificador del destinatario en el sistema de gestión de personas. | Obligatorio Foreing Key a GESPER |
| enviarEmail | Flag que indica si el usuario desea recibir comunicados por email o no. | Obligatorio |
| Email en el que recibir los comunicados. | Opcional a nivel de modelo de datos / Obligatorio a nivel funcional si enviarEmail = Sí |
TipoComunicadoConfiguracionComunicado
Tabla relacional entre los tipos de comunicado (TipoComunicado) y la configuración para la recepción por email de los mismos por parte de cada usuario (ConfiguracionComunicado).
Si existe un registro en la tabla ConfiguracionComunicado donde su campo enviarEmail sea "Sí", debe existir al menos un registro asociado en esta tabla.
| Campo | Descripción | Propiedades |
|---|---|---|
| id | Identificador único de la relación. | Autogenerado Obligatorio Primary Key |
| configuracionComunicado | Identificador de la configuración de comunicado relacionada. | Obligatorio Foreing Key a ConfiguracionComunicado |
| tipoComunicado | Identificador del tipo de comunicado relacionado. | Obligatorio Foreing Key a TipoComunicado |
Comunicado
Tabla donde se insertará la información de cada comunicado que generen las diferentes gestiones.
| Campo | Descripción | Propiedades |
|---|---|---|
| id | Identificador único del comunicado. | Autogenerado Obligatorio Primary Key |
| codigo | Código del comunicado. Será un código único dentro de la gestión que lo genera. | Obligatorio |
| fechaLimite | Fecha límite para la realización de las acciones que se indiquen en el comunicado. | Opcional |
| vigencia | Días de vigencia del comunicado a contar desde su fecha de creación (fecha comunicado). | Obligatorio |
| destinatarios | Lista de destinatarios (personasRef) del comunicado. | Formato JSON (varchar (5000)) {destinatarios: [ "personaRef1",personaRef2, ...]} Opcional a nivel de modelo de datos / Obligatorio a nivel funcional que para un registro esté informado bien este campo o bien el campo permisos (Pendiente de concretar caso de comunicados Generales) |
| permisos | Lista de permisos que han de tener los destinatarios del comunicado. Se enviará el comunicado a todos los usuarios que tengan asociado al menos uno de esos permisos. Si se ha informado el campo destinatarios, se hará el factor común de ambos campos, enviando el comunicado solo a los destinatarios de la lista que además tengan alguno de los permisos indicados. El módulo/gestión llamante es la que gestionará el catálogo de permisos que tiene que enviar para cada comunicado que genera. Desde el módulo de comunicados se llamará al módulo de usuarios para obtener la lista de usuarios asociados a la lista de permisos indicados. | Formato JSON (varchar (5000)) {permisos: [AES-MER-VAL, ...] } Opcional a nivel de modelo de datos / Obligatorio a nivel funcional que para un registro esté informado bien este campo o bien el campo permisos. (Pendiente de concretar caso de comunicados Generales) |
| parametros | Lista de parametros a reemplazar en el campo descripcion de un comunicado tras recuperar su texto "plantilla" del fichero de recursos del módulo de comunicados. El catálogo de claves o identificadores de cada parámetro (ej: divulgacion, fecha, ...) las ha de tener el módulo llamante para informarnos qué valor se quiere dar a cada uno. En una primera aproximación, se supondrá que los comunicados no informan este dato hasta confirmar su necesidad. | Formato JSON (varchar (5000)) { parametros: [{divulgacion: "texto a poner"}, {fecha: "fecha a poner"}, ...] } Opcional |
| modulo | Dato de texto que representará el identificador de un módulo y se utilizará para componer la url de acceso a la gestión que generó el comunicado o que requiere que se realice alguna acción en base al mismo. Ej: "3" que podría corresponder al módulo de CSP. | Opcional en el modelo de datos / Obligatorio funcionalmente si se informa el tipoEntidad |
| tipoEntidad | Dato de texto que representará al tipo de entidad, siendo un valor de una enumeración y se utilizará para componer la url de acceso a la gestión que generó el comunicado o que requiere que se realice alguna acción en base al mismo. Ej: "33" que podría corresponder a la entidad "Proyecto" | Opcional en el modelo de datos / Obligatorio funcionalmente si se informa el idEntidad |
| idEntidad | Dato de texto que representará el identificador concreto de una entidad y se utilizará para componer la url de acceso a la gestión que generó el comunicado o que requiere que se realice alguna acción en base al mismo. Ej: "333", identificador del proyecto que requiere revisar algún dato. | Opcional |
| fechaCreacion | Campo que está ya contemplado para todas las tablas del modelo y que en este caso se utilizará para utilizarla como dato de fecha de comunicado. | Obligatorio |
EnvioComunicado
Tabla relacional donde se insertará la información del envío de cada comunicado concreto a cada usuario partiendo del comunicado generado en la tabla Comunicado.
Se generará un único registro por destinatario donde se gestionará tanto si se ha logrado enviar por email o no, puede que haya que realizar reintentos si ocurriese algún problema en el proceso, como si el usuario lo ha marcado como leído o no en el SGI.
La inserción en esta tabla a de ser transaccional con la de la inserción en la tabla de Comunicado.
La lista de destinatarios finales puede depender de la obtención de los mismos a partir de los permisos que se consulten al módulo de usuarios, por lo que podría haber algún error que impida su inserción directa y en este caso habría que devolver un error a la gestión que envía el comunicado indicando que no ha sido posible generarlo.
| Campo | Descripción | Propiedades |
|---|---|---|
| id | Identificador único del envío del comunicado a cada usuario destinatario concreto. | Autogenerado Obligatorio Primary Key |
| comunicado | Identificador del comunicado asociado al envío. | Obligatorio Foreing Key a Comunicado |
| destinatarioRef | Identificador del destinatario del envío del comunicado en el sistema de gestión de personas. | Obligatorio Foreing Key a GESPER |
| emailEnviado | Flag que indica si el email, de tener el usuario configurado este tipo de notificación, le ha sido enviado o no. Si el usuario no tiene configurado el envío de emails, estará con el valor que represente "No". | Obligatorio |
| leidoSGI | Flag que indica si el usuario ha marcado el comunicado que ha recibido como "Leído" o no. No se gestiona en el modelo la lectura o no del comunicado en el email en caso de que el usuario lo tuviese activado. | Obligatorio |