...
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 deterninado determinado de una persona |
Enumerados
Info |
---|
Para la definición de los enumerados en el código seguir lo indicado en: 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:
...
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).activo | |
entidadPropiaRef | Boolean | Indica si la persona esta activa o noString | 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[StringEmail] | 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). |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "id": "ent-002", "nombre": "Prueba", "apellidos": "Apellido1 Apellido2", "sexo": { "id":"sex-1", "nombre":"Mujer" }, "numeroIdentificacion": "11111111H", "tipoDocumento": { "id":"tp-1", "nombre": "NIF" }, "empresaRef: "ent-002", "personalPropio": falsetrue, "activoentidadPropiaRef" : true"ent-UM-001", "emails":[{ email: "prueba@prueba.es","prueba2@prueba.es"] } |
Sexo
...
principal: true
},
{
email: "prueba2@prueba.es",
principal: false
}
]
"activo": true
} |
Sexo
Nombre | Tipo |
---|
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"sex-1",
"nombre":"Mujer"
} |
TipoDocumento
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad TipoDocumentoSexo |
nombre | String | Nombre (Posibles valores: NIFMujer, NIE, PasaporteHombre) |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "id":"tpsex-1", "nombre": "NIFMujer" } |
...
TipoDocumento
Nombre | Tipo | Descripción | ||
---|---|---|---|---|
fechaNacimientoid | FechaString | Fecha de nacimiento Identificador de la personaentidad TipoDocumentopaisNacimiento | ||
nombre | 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 | ||
String | Nombre (Posibles valores: NIF, NIE, Pasaporte) | ciudadNacimiento | String | Ciudad de nacimiento de la persona |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "fechaNacimientoid": "2000tp-02-101", "paisNacimientonombre": { "id":"33", NIF" "nombre":"España" }, "comAuntonomaNacimiento": { } |
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". |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "idemail":"ca-1email@um.es", "nombreprincipal":"Andalucía" }, "ciudadNacimiento": "Sevilla" true } |
...
DatosPersonales
Nombre | Tipo | Descripción |
---|---|---|
fechaNacimiento | Fecha | Fecha de nacimiento de la persona |
paisNacimientopaisContacto | Pais | Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO. |
comAutonomaContactocomAuntonomaNacimiento | ComunidadAutonoma | Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO. |
provinciaContactociudadNacimiento | 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[String] | 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. |
String | Ciudad de nacimiento de la persona |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"fechaNacimiento": "2000-02-10",
"paisNacimiento": {
"id":"33",
"nombre":"España"
},
"comAuntonomaNacimiento": {
"id":"ca-1",
"nombre":"Andalucía"
},
"ciudadNacimiento": "Sevilla"
} |
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. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"paisContacto": {
"id":"33",
"nombre":"España"
},
"comAuntonomaContacto": {
"id":"ca-3",
"nombre":"Asturias"
},
"provinciaContacto | ||||||||
Bloque de código | ||||||||
| ||||||||
{ "paisContacto": { "id":"33pro-1", "nombre":"EspañaAsturias" }, "ciudadContacto": "Oviedo", "direccionContacto": "C/ Uria número 4, puerta A", "comAuntonomaContactocodigoPostalContacto": { "33005" "idemails":"ca-3", [{ "nombre"email: "Asturiasprueba@prueba.es", }, "provinciaContacto"principal: {true "id":"pro-1" }, "nombre":"Asturias" { }, "ciudadContacto" email: "Oviedoprueba2@prueba.es", "direccionContacto": "C/ Uria número 4, puerta A", "codigoPostalContacto": "33005" principal: false "emails":["prueba@prueba.es","prueba2@prueba.es"} ], "telefonos":["985112233","984445566"], "moviles":["666112233","699445566"] } |
...
Nombre | Tipo | Descripción | |||
---|---|---|---|---|---|
categoriaProfesionalCategoriaProfesional | CategoriaProfesional | Se devuelve la entidad CategoriaProfesional con todos sus campos. | |||
fechaObtencionCategoria | Fecha | Fecha en la que se obtiene la categoría profesional. | |||
departamento | Departamento | Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO. | |||
areaConocimiento | AreaConocimiento | Se devuelve la entidad CategoriaProfesionalentidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO. fechaObtencionCategoria | |||
empresaRef | Fecha | Fecha en la que se obtiene la categoría profesional. | |||
departamento | Departamento | Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO. | |||
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 | areaConocimiento | AreaConocimiento | Se devuelve la entidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"categoriaProfesional":{
"id":"catp-1",
"nombre":"PDI Numerario"
},
"fechaObtencionCategoria":"2020-03-15",
"departamento": {
"id":"dpt-1",
"nombre":"Departamento Ciencias de la tecnología"
},
"areaConocimiento": {
"id":"ac-1",
"nombre":"Área de conocimiento A"
},
"empresaRef": "ent-002",
"personalPropio" : true,
"entidadPropiaRef": "ent-UM-001"
} |
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. |
...
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= | 11111111Hjim,apellidos=like= | 11111111Hjim, | numeroDocumentoemail=like= | 11111111Hjim) 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} | id | Vinculacion | Detalle de los datos de vinculación de una persona (independientemente de que este activa o no la persona). | |||||
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) | |||||
Nuevo 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 |