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 y/o de un grupo.
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).
Autor prc: personal de investigación que alimenta su CVN y que por lo tanto figura como autor de items de producción científica.
Destinatario comunicado: personal de la Universidad o de investigación (de la Universidad o externo) que puede ser destinatario de un comunicado enviado por el SGI.
Persona autorizada grupo: personal de la Universidad que puede der la persona autorizada de un grupo para realizar la tarea de validar/rechazar items de producción científica y persona autorizadas para la creación de solicitudes de modificación del grupo.
Tutor csp: personal de investigación que puede ser tutor/a de un trabajo postdoctoral, predoctoral, etc, trabajos de solicitudes de RRHH.
Miembro Equipo Empresa de Explotación de Resultados: personal de la Universidad que puede participar en una empresa de explotación de resultados como solicitante, parte del equipo emprendedor, de la composición de la sociedad o de la administración de la misma.

Modelo lógico

Hércules > SGI - ESB - SGP > ESB SGP Logical Model.png

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

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

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

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

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

{
    "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
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.
centro	Centro	Se devuelve la entidad Centro con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - 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":{
		"categoriaProfesional":{
			"id":"catp-1",
	        "nombre":"PDI Numerario"
     	},
    	"fechaObtencionCategoria":"2020-03-15"
	},
    "departamento": {
       "id":"dpt-1",
       "nombre":"Departamento Ciencias de la tecnología"
     },
	"centro": {
		"id":"cen-1",
		"nombre": "Centro 1 de la Universidad de Murcia"
	 },
     "areaConocimiento": {
       "id":"ac-1",
       "nombre":"Área de conocimiento A"
     },
	"empresaRef": "ent-002",
	"personalPropio" : true,
	"entidadPropiaRef": "ent-UM-001"
}

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": {
		"id":"catp-1",
   		"nombre":"PDI Numerario"
	},
	"fechaObtencionCategoria" : "2020-03-15"
}

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.

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

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

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

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

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

Sexenio

Nombre	Tipo	Descripción
numero	String	Número de sexenios reconocidos
paisRef	String	País del reconocimiento
personaRef	String	Identificador de la persona que tiene el sexenio

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

DireccionTesis

Nombre	Tipo	Descripción
id	String	Identificador del doctorado
personaRef	String	Identificador de la persona que es el Director de la tesis
tituloTrabajo	String	Título del trabajo
fechaDefensa	Fecha	Fecha de obtención del título Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").
alumno	String	Identificador en el SGP si existe el alumno y sino nombre y apellidos del alumno.
tipoProyecto	TipoTrabajoDirigido	Tipo del trabajo dirigido: Otros, Proyecto de fin de carrera, Tesina, Tesis doctoral, Trabajo conducente a la obtención de DEA
calificacionObtenida	String	P.e. "Cum laude"
coDirectorTesisRef	String	Identificador del co-director/a que ha intervenido
doctoradoEuropeo	Bool	Indica si se ha recibido una mención europea
fechaMencionDoctoradoEuropeo	Fecha	Fecha de la mención del doctorado europeo. Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").
mencionCalidad	Boolean	Indica si el dotorado ha recibido una mención de calidad
fechaMencionCalidad	Fecha	Fecha de la homologación del doctorado extranjero. Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").
mencionInternacional	Boolean	Indica si tiene mención internacional o no
mencionIndustrial	Boolean	Indica si tiene mención industrial o no

TipoTrabajoDirigido

Nombre

Tipo

Descripción

id

String

Identificador del tipo de trabajo-proyecto dirigido (055, 067, 071, 066, OTHERS)

nombre

String

Tipo de trabajo dirigido.

Posibles valores:

Proyecto de fin de carrera (valor 055)
Tesis doctoral (valor 067)
Trabajo conducente a la obtención de DEA (valor 071)
Tesina (valor 066)
Otros (valor OTHERS)

Servicios

Para componer la URL llamada completa, se debe anteponer a lo indicado en la columna URL lo siguiente: {HOST}/api/spg, donde {HOST} de deberá sustituir el dominio correspondiente al entorno al que se está accediendo y dicho acceso será por http o https según el caso.