Sistema de Gestión Personas
Entidades
Entidad | Descripción |
---|---|
Persona | Contiene los datos básicos de una persona. |
DatosPersonales | Contiene los datos personales de una persona (datos nacimiento de la persona). |
DatosContacto | Contiene los datos de contacto de una persona (dirección de contacto, teléfonos, email, etc.). |
DatosAcademicos | Contiene los datos académicos, por el momento, únicamente se necesita el nivel académico. |
Vinculacion | Contiene los datos de vinculación de una persona a la estructura organizativa Universitaria. |
TipoDocumento | Listado con los tipos de documento de identificación (NIF/NIE/Pasaporte). |
Sexo | Listado con los valores que puede tomar la entidad sexo (Mujer/Hombre). |
Contiene los email de una persona (el de la universidad, el personal, etc) incluido el indicador de si el email es principal o no. | |
Telefono | Contiene los teléfonos de una persona (móvil, fijo, fax, etc). |
CategoriaProfesional | Listado con las categorías profesionales de la Universidad. |
NivelAcademico | Listado con los niveles académicos (Doctor, Ldo/Graduado, Diplomado, FP, etc). |
Colectivo | Listado de colectivos que tiene la Universidad, sirvan como ejemplos de colectivos "personal de investigación", "personal de administración" ,"alumnos". Agrupación de personas sobre las que se van a realizar las búsquedas de personas (RELACIONES VIGENTES UM.xlsx). |
ColectivoTipoColectivo | Relaciona los colectivos con el enumerado interno del SGI "TipoColectivo". En las búsquedas de personas de los distintos módulos del SGI se podrán buscar personas sobre varios colectivos o sobre un "TipoColectivo". Un "TipoColectivo" estará relacionado con varios colectivos. Por ejemplo se puede tener como "TipoColectivo" evaluador ética, donde los colectivos que lo forman son PDI y Alumnos 5 ciclo. Por lo que al buscar personas para que sean el evaluador de ética se filtrarán por aquellas que sean PDI o sean Alumnos de 5 ciclo. |
ColectivoCategoriaProfesional | Define que categorías profesionales pertenecen a cada uno de los colectivos definidos en la Universidad. En categoría profesionales, podemos tener" PAS FIJO/INDEFINIDO" , "PAS CONTRATADO", "PAS CENTROS ADSCRITOS". |
Fotografia | Foto digital de la persona. |
Sexenio | Contiene el número de sexenios en un país determinado de una persona |
Enumerados
Entidad | Descripción |
---|---|
TipoColectivo | Contiene los tipos de colectivos usados en el SGI para ser usados como filtro a la hora de realizar la búsqueda de personas Valores:
|
Modelo lógico
API
Características generales que todas las API REST deben de cumplir:
Definición de los objetos
Persona
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la persona. |
nombre | String | Nombre de la persona. |
apellidos | String | Apellidos de la persona. |
sexo | Sexo | Se devuelve la entidad Sexo con todos sus campos. |
numeroDocumento | String | Número de documento de identificación personal. |
tipoDocumento | TipoDocumento | Se devuelve la entidad TipoDocumento con todos sus campos. |
empresaRef | String | Se devuelve el identificador/referencia de la entidad Empresa. |
personalPropio | Boolean | Indica si es personal de la Universidad o no (a día de hoy). |
entidadPropiaRef | String | Se devuelve el identificador/referencia de la entidad que representa a la UM en caso de que valor de personalPropio sea true (a día de hoy), esto es, que la relación de la persona con la UM esté vigente. |
emails | Lista[Email] | Lista con los emails de la persona (o con el email que se quiere visualizar en el resultado de la búsqueda de personas) |
activo | Boolean | Indica si la persona esta activa o no (a día de hoy). |
Sexo
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad Sexo |
nombre | String | Nombre (Posibles valores: Mujer, Hombre) |
TipoDocumento
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad TipoDocumento |
nombre | String | Nombre (Posibles valores: NIF, NIE, Pasaporte) |
Nombre | Tipo | Descripción |
---|---|---|
String | Dirección de email | |
principal | Boolean | Indicador de si el email es principal o no. Podrá tener los valores "true" o "false". |
DatosPersonales
Nombre | Tipo | Descripción |
---|---|---|
fechaNacimiento | Fecha | Fecha de nacimiento de la persona |
paisNacimiento | Pais | Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO |
comAuntonomaNacimiento | ComunidadAutonoma | Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO |
ciudadNacimiento | String | Ciudad de nacimiento de la persona |
DatosContacto
Nombre | Tipo | Descripción |
---|---|---|
paisContacto | Pais | Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO. |
comAutonomaContacto | ComunidadAutonoma | Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO. |
provinciaContacto | Provincia | Se devuelve la entidad Provincia con todos sus campos. Ver definición en SGI - ESB - SGO. |
ciudadContacto | String | Ciudad de contacto de la persona. |
direccionContacto | String | Dirección de contacto de la persona. |
codigoPostalContacto | String | Código postal de la dirección de contacto de la persona. |
emails | Lista[Email] | Lista con los emails de la persona. |
telefonos | Lista[String] | Lista con los teléfonos fijos de la persona. |
moviles | Lista[String] | Lista con los teléfonos móviles de la persona. |
Vinculacion
Nombre | Tipo | Descripción |
---|---|---|
vinculacionCategoriaProfesional | VinculacionCategoriaProfesional | Se devuelve la entidad VinculacionCategoriaProfesional con todos sus campos. |
departamento | Departamento | Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO. |
areaConocimiento | AreaConocimiento | Se devuelve la entidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO. |
empresaRef | String | Se devuelve el identificador/referencia de la entidad Empresa externa que es la relacionada en la actualidad con la persona, la vigente. |
personalPropio | Boolean | Indica si es personal de la Universidad o no (a día de hoy). |
entidadPropiaRef | String | Se devuelve el identificador/referencia de la entidad que representa a la Universidad en caso de que valor de personalPropio sea true (a día de hoy), esto es, que la relación de la persona con la Universidad esté vigente. |
VinculacionCategoriaProfesional
Nombre | Tipo | Descripción |
---|---|---|
categoriaProfesional | CategoriaProfesional | Categoría profesional de la persona. |
fechaObtencionCategoria | Fecha | Fecha de obtención de categoría profesional de la persona. |
CategoriaProfesional
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad CategoriaProfesional. |
nombre | String | Nombre de la categoría profesional de la persona dentro de la universidad. |
DatosAcademicos
Nombre | Tipo | Descripción |
---|---|---|
nivelAcademico | NivelAcademico | Se devuelve la entidad NivelAcademico con todos sus campos. |
fechaObtencion | Fecha | Fecha obtención del nivel académico. |
NivelAcademico
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad NivelAcademico. |
nombre | String | Nombre del NivelAcademico (Posibles valores: Doctor, Ldo/Graduado, Diplomado, FP, etc). |
Colectivo
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad Colectivo. |
nombre | String | Nombre del colectivo (Posibles valores: PAS, PSI, Alumnos, Becarios, Externo). (RELACIONES VIGENTES UM.xlsx) |
Fotografia
Nombre | Tipo | Descripción |
---|---|---|
contenido | String | Contenido de la fotografía digital de la persona (en bytes y en base 64). |
mimeType | String | Mimetype de la fotografía. |
Sexenio
Nombre | Tipo | Descripción |
---|---|---|
numero | String | Número de sexenios reconocidos |
paisRef | String | País del reconocimiento |
Servicios
Método | URL | Parámetros | Respuesta | Permisos | Descripción |
---|---|---|---|---|---|
GET | /personas | q+s (query + sort) La query estará formada por:
| Lista[Persona] | Listado de Persona. Ejemplo: colectivoId=in=(refPAS,refPDI);(nombre=like=jim,apellidos=like=jim,email=like=jim) colectivoId=in=(refPAS,refPDI);(nombre=like=nombre.apellido@um.es,apellidos=like=nombre.apellido@um.es,email=like=nombre.apellido@um.es) Nota: tipoColetivo y colectivoId son mutuamente excluyentes. En el caso se recibir un tipoColectivo se traducirá a los colectivos que lo formen. | |
GET | /personas/{id} | id | Persona | Detalle de los datos generales de una persona (este la persona activo o no) | |
POST | /personas | JSON | id Vendrá relleno si la creación es síncrona y no vendrá si es asíncrona. | Recibe como parámetro la respuesta del usuario del formulario de datos de alta (formly) con los campos necesarios para crear una persona. | |
PUT | /personas | JSON | Recibe como parámetro la respuesta del usuario del formulario de datos de modificación (formly) con los campos necesarios para actualizar una persona. | ||
GET | /personas/formly/{id} | JSON | Devuelve los datos a pintar en el formulario de Ver Detalle/Actualizar en el SGI (formly). | ||
GET | /personas/formly/create | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona. Ver IU-GEN-0061- Solicitar alta de persona. | ||
GET | /personas/formly/update | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar modificar persona. | ||
GET | /personas/formly/view | Formly | Devuelve el formulario (formly) a pintar para la pantalla de ver detalle de persona. | ||
GET | /datos-personales/persona/{id} | id | DatosPersonales | Detalle de los datos personales de una persona independientemente de que este activa o no la persona (datos de dirección, nacimiento, etc). | |
GET | /datos-contacto/persona/{id} | id | DatosContacto | Contiene la lista de emails, incluido si cada uno es principal o no, y/o de teléfonos de una persona (independientemente de que este activa o no la persona) | |
GET | /vinculaciones/persona/{id} | Vinculacion | Detalle de los datos de vinculación vigentes de una persona (independientemente de que esté activa o no la persona). Ver UM - SGI - ESB - SGP - Adaptaciones integración para su implementación en el SGI. | ||
GET | /vinculaciones/persona/{id}/vinculaciones-categorias-profesionales | PENDIENTE AF-DIS | |||
GET | /datos-academicos/persona/{id} | id | DatosContacto | Contiene el nivel académico de la persona (independientemente de que este activa o no la persona) | |
GET | /colectivos | Lista[Colectivo] | Listado de colectivos ordenados alfabéticamente de forma ascendente. | ||
GET | /tipos-documento | Lista[TipoDocumento] | Listado de tipos de documento de identificación personal ordenados alfabéticamente de forma ascendente. | ||
GET | /sexos | Lista[Sexo] | Listado de sexos ordenados alfabéticamente de forma ascendente. | ||
GET | /categorias-profesionales | Lista[CategoriaProfesional] | Listado de categorías profesionales ordenadas alfabéticamente de forma ascendente. | ||
GET | /categorias-profesionales/{id} | CategoriaProfesional | Detalle de la categoría profesional cuyo identificador se indica por parámetro. | ||
GET | /niveles-academicos | Lista[NivelAcademico] | Listado de niveles académicos ordenados alfabéticamente de forma ascendente. | ||
GET | /niveles-academicos/{id} | NivelAcademico | Detalle del nivel académico cuyo identificador se indica por parámetro. | ||
GET | /personas/{id}/fotografia | id | Fotografia | Detalle de la fotografía digital de la persona (independientemente de que este activa o no la persona) | |
Métodos para hacer la integración con Gnoss para el CVN | |||||
GET | /personas/modificadas-ids | q+s La query estará formada por:
| Lista[String] | Listado de los identificadores de personas que han sufrido cambios en los datos identificativos (nombre, apellidos, sexo, número de documento y tipo de documento) y/o en los datos personales (fecha de nacimiento, país de nacimiento, comunidad autónoma de nacimiento y ciudad de nacimiento) y/o en datos de contacto (país de contacto, comunidad autónoma de contacto, provincia de contacto, ciudad de contacto, dirección de contacto, código postal, listado de teléfonos y listado de emails) y/o en la fotografía a partir de la fecha de modificación pasada por parámetro y/o en los sexenios. | |
GET | /sexenios/persona/{id} | Lista[Sexenio] | Contiene la lista de sexenios reconocidos en un país determinado de una persona | ||
Métodos los que se llama desde los sistemas de la Universidad al SGI | |||||
POST | /vinculaciones/persona/{id}/vinculaciones-categorias-profesionales | PENDIENTE AF-DIS |