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).
Email	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

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:

Solicitante ética: personal de investigación que crea las solicitudes de evaluación de proyectos en ética.
Evaluador ética: personal de investigación que puede realizar las evaluaciones de las memorias de investigación o bien personal técnico que puede realizar las tareas de evaluación de memorias.
Equipo trabajo ética: personal de investigación que puede formar parte del equipo de trabajo de una solicitud de evaluación de ética.
Solicitante csp: personal de investigación que puede figurar como solicitante de una ayuda/convocatoria (a pesar de que, por norma general, los colectivos asociados a este tipo pudieran coincidir con los asociados a los roles de tipo "equipo investigación" de la tabla "rol proyecto", se crea este tipo de colectivo para simplificar la búsqueda en pantallas en las que no es necesario distinguir el rol a la vez que para independizar la configuración de colectivos por si fuera necesario llegado el caso).
Responsable económico csp: personal de la Universidad que puede ser el responsable económico de un proyecto
Autor de invención: persona física que tiene un porcentaje de autoría de la invención. Puede ser un investigador de la Universidad o externo.
Responsable proyecto externo: persona que puede participar como responsable (IP) de un proyecto externo (autorización de participación en proyecto externo).

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).

Persona

{
    "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": true,
     "entidadPropiaRef" : "ent-UM-001",
  	 "emails":[{
         email: "prueba@prueba.es",
         principal: true
        },
        {
         email: "prueba2@prueba.es",
         principal: false
        }
     ]
     "activo": true
}

Sexo

Nombre	Tipo	Descripción
id	String	Identificador de la entidad Sexo
nombre	String	Nombre (Posibles valores: Mujer, Hombre)

Sexo

{
   "id":"sex-1",
   "nombre":"Mujer"  
}

TipoDocumento

Nombre	Tipo	Descripción
id	String	Identificador de la entidad TipoDocumento
nombre	String	Nombre (Posibles valores: NIF, NIE, Pasaporte)

TipoDocumento

{ 
    "id":"tp-1",
    "nombre": "NIF"   
}

Email

Nombre	Tipo	Descripción
email	String	Dirección de email
principal	Boolean	Indicador de si el email es principal o no. Podrá tener los valores "true" o "false".

Email

{ 
    "email":"email@um.es",
    "principal": true   
}

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

DatosPersonales

{
    "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.

DatosContacto

{
    "paisContacto": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaContacto": {
       "id":"ca-3",
       "nombre":"Asturias"
     }, 
    "provinciaContacto": {
       "id":"pro-1",
       "nombre":"Asturias"
     }, 
	"ciudadContacto": "Oviedo",
	"direccionContacto": "C/ Uria número 4, puerta A",
	"codigoPostalContacto": "33005"         
	"emails":[{
         email: "prueba@prueba.es",
         principal: true
    	},
        {
         email: "prueba2@prueba.es",
         principal: false
        }
    ],
    "telefonos":["985112233","984445566"],
    "moviles":["666112233","699445566"]  		
}

Vinculacion

Nombre	Tipo	Descripción
categoriaProfesional	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 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.

Vinculacion

{
    "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.

CategoriaProfesional

{
   "id":"catp-1",
   "nombre":"PDI Numerario"
}

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.

DatosAcademicos

{
    "nivelAcademico": {
       "id":"1",
       "nombre":"Doctorado"
     },
     "fechaObtencion":"2000-02-10"
}

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).

NivelAcademico

{
   "id":"1",
   "nombre":"Doctorado"
}

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)

Colectivo

{
    "id":"1",
    "nombre":"PDI"
}

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.

Fotografia

{
    "contenido":"DDfgdfgdfj46gd6f5gdfgdf=",
    "mimeType":"image/jpeg"
}

Sexenio

Nombre	Tipo	Descripción
numero	String	Número de sexenios reconocidos
paisRef	String	País del reconocimiento

Sexenio

{
    "numero":"2",
    "paisRef":"011"
}

Servicios

Método	URL	Parámetros	Respuesta	Descripción
GET	/personas	q+s (query + sort) La query estará formada por: tipoColectivo colectivoId nombre apellidos ~~numeroDocumento~~ email id	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}	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: fechaModificacion	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

Árbol de páginas

SGI - ESB - SGP