Árbol de páginas



Sistema de Gestión Personas

Entidades

EntidadDescripción
PersonaContiene los datos básicos de una persona.
DatosPersonalesContiene los datos personales de una persona (datos nacimiento de la persona).
DatosContactoContiene los datos de contacto de una persona (dirección de contacto, teléfonos, email, etc.).
DatosAcademicosContiene los datos académicos, por el momento, únicamente se necesita el nivel académico.
VinculacionContiene 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).

EmailContiene los email de una persona (el de la universidad, el personal, etc)  incluido el indicador de si el email es principal o no.
TelefonoContiene los teléfonos de una persona (móvil, fijo, fax, etc).
CategoriaProfesionalListado con las categorías profesionales de la Universidad.
NivelAcademicoListado con los niveles académicos (Doctor, Ldo/Graduado, Diplomado, FP, etc).
ColectivoListado 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).
ColectivoTipoColectivoRelaciona 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.
ColectivoCategoriaProfesionalDefine 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".
FotografiaFoto digital de la persona.
SexenioContiene 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
EntidadDescripció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

Definición de los objetos

Persona

NombreTipoDescripción
idStringIdentificador de la persona.
nombreStringNombre de la persona.
apellidosStringApellidos de la persona.
sexoSexoSe devuelve la entidad Sexo con todos sus campos.
numeroDocumentoStringNúmero de documento de identificación personal.
tipoDocumentoTipoDocumentoSe devuelve la entidad TipoDocumento con todos sus campos.
empresaRefString

Se devuelve el identificador/referencia de la entidad Empresa.

personalPropioBooleanIndica si es personal de la Universidad o no (a día de hoy).
entidadPropiaRefStringSe 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.
emailsLista[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)
activoBooleanIndica 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

NombreTipoDescripción
idStringIdentificador de la entidad Sexo
nombreStringNombre (Posibles valores: Mujer, Hombre)
Sexo
{
   "id":"sex-1",
   "nombre":"Mujer"  
}

TipoDocumento

NombreTipoDescripción
idStringIdentificador de la entidad TipoDocumento
nombreStringNombre (Posibles valores: NIF, NIE, Pasaporte)
TipoDocumento
{ 
    "id":"tp-1",
    "nombre": "NIF"   
}

Email

NombreTipoDescripción
emailStringDirección de email
principalBooleanIndicador de si el email es principal o no. Podrá tener los valores "true" o "false".
Email
{ 
    "email":"email@um.es",
    "principal": true   
}

DatosPersonales

NombreTipoDescripción
fechaNacimientoFechaFecha de nacimiento de la persona
paisNacimientoPais

Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO

comAuntonomaNacimientoComunidadAutonoma

Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO

ciudadNacimientoStringCiudad 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

NombreTipoDescripción
paisContactoPais

Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO.

comAutonomaContactoComunidadAutonoma

Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO.

provinciaContactoProvincia

Se devuelve la entidad Provincia con todos sus campos. Ver definición en SGI - ESB - SGO.

ciudadContactoStringCiudad de contacto de la persona.
direccionContactoStringDirección de contacto de la persona.
codigoPostalContactoStringCódigo postal de la dirección de contacto de la persona.
emailsLista[Email]Lista con los emails de la persona.
telefonosLista[String]Lista con los teléfonos fijos de la persona.
movilesLista[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

NombreTipoDescripción
vinculacionCategoriaProfesionalVinculacionCategoriaProfesional

Se devuelve la entidad VinculacionCategoriaProfesional con todos sus campos.

departamentoDepartamento

Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO.

centroCentroSe devuelve la entidad Centro con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO)
areaConocimientoAreaConocimiento

Se devuelve la entidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO.

empresaRefString

Se devuelve el identificador/referencia de la entidad Empresa externa que es la relacionada en la actualidad con la persona, la vigente.

personalPropioBooleanIndica si es personal de la Universidad o no (a día de hoy).
entidadPropiaRefStringSe 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
{
    "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

NombreTipoDescripción
categoriaProfesionalCategoriaProfesionalCategoría profesional de la persona.
fechaObtencionCategoriaFechaFecha de obtención de categoría profesional de la persona.
VinculacionCategoriaProfesional
{    
	"categoriaProfesional": {
		"id":"catp-1",
   		"nombre":"PDI Numerario"
	},
	"fechaObtencionCategoria" : "2020-03-15"
}

CategoriaProfesional

NombreTipoDescripción
idStringIdentificador de la entidad CategoriaProfesional.
nombreStringNombre de la categoría profesional de la persona dentro de la universidad.
CategoriaProfesional
{
   "id":"catp-1",
   "nombre":"PDI Numerario"
}

DatosAcademicos

NombreTipoDescripción
nivelAcademicoNivelAcademico

Se devuelve la entidad NivelAcademico con todos sus campos.

fechaObtencionFechaFecha obtención del nivel académico.
DatosAcademicos
{
    "nivelAcademico": {
       "id":"1",
       "nombre":"Doctorado"
     },
     "fechaObtencion":"2000-02-10"
}

NivelAcademico

NombreTipoDescripción
idStringIdentificador de la entidad NivelAcademico.
nombreStringNombre del NivelAcademico (Posibles valores: Doctor, Ldo/Graduado, Diplomado, FP, etc).
NivelAcademico
{
   "id":"1",
   "nombre":"Doctorado"
}

Colectivo

NombreTipoDescripción
idStringIdentificador de la entidad Colectivo.
nombreStringNombre del colectivo (Posibles valores: PAS, PSI, Alumnos, Becarios, Externo).  (RELACIONES VIGENTES UM.xlsx)
Colectivo
{
    "id":"1",
    "nombre":"PDI"
}

Fotografia

NombreTipoDescripción
contenidoStringContenido de la fotografía digital de la persona (en bytes y en base 64).
mimeTypeStringMimetype de la fotografía.
Fotografia
{
    "contenido":"DDfgdfgdfj46gd6f5gdfgdf=",
    "mimeType":"image/jpeg"
}

Sexenio

NombreTipoDescripción
numeroStringNúmero de sexenios reconocidos
paisRefStringPaís del reconocimiento
personaRefStringIdentificador de la persona que tiene el sexenio
Sexenio
{
    "numero":"2",
    "paisRef":"011",
    "personaRef":11111111
 }

DireccionTesis


NombreTipoDescripción
idStringIdentificador del doctorado
personaRefStringIdentificador de la persona que es el Director de la tesis
tituloTrabajoStringTítulo del trabajo
fechaDefensaFecha

Fecha de obtención del título

Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").

alumnoStringIdentificador en el SGP si existe el alumno y sino nombre y apellidos del alumno.
tipoProyectoTipoTrabajoDirigidoTipo del trabajo dirigido: Otros, Proyecto de fin de carrera, Tesina, Tesis doctoral, Trabajo conducente a la obtención de DEA
calificacionObtenidaString P.e. "Cum laude"
coDirectorTesisRefStringIdentificador del co-director/a que ha intervenido
doctoradoEuropeoBoolIndica si se ha recibido una mención europea
fechaMencionDoctoradoEuropeoFecha

Fecha de la mención del doctorado europeo.

Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").

mencionCalidadBooleanIndica si el dotorado ha recibido una mención de calidad
fechaMencionCalidadFecha

Fecha de la homologación del doctorado extranjero.

Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").

mencionInternacionalBooleanIndica si tiene mención internacional o no
mencionIndustrialBooleanIndica si tiene mención industrial o no

TipoTrabajoDirigido

NombreTipoDescripción
idStringIdentificador del tipo de trabajo-proyecto dirigido (055, 067, 071, 066, OTHERS)
nombreString

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


Método

URL

Parámetros

Respuesta

Permisos

Descripción

GET/personasFast
  • búsqueda (cadena a buscar en nombre / apellidos / email).
  • colectivoId (uno o varios colectivos sobre los que realizar la búsqueda).

Lista[Persona]


Listado de Persona.

Ejemplo:

[mailto:busqueda=skarmeta@um.es&colectivoId=]busqueda=skarmeta@um.es&colectivoId=(1,2,3,4)

busqueda=jorge carrillo&colectivoId=(2)

NOTA:

La búsqueda no es sensible a mayúsculas ni minúsculas. Los parámetros no deben ir entrecomillados.

Si no se indica el parámetro colectivoId, se buscará en todos los colectivos.

Se devuelven como máximo 11 registros, al devolver más de 10 registros el buscador indicará que existen más registros y se puede refinar la búsqueda.

GET/personas

q+s (query + sort)

La query estará formada por:

  • id
  • tipoColectivo
  • colectivoId
  • nombre
  • apellidos
  • email
  • nombreApellidos

Lista[Persona]


Listado de Persona.

Ejemplo:

colectivoId=in=(refPAS,refPDI);(nombre=like=jim,apellidos=like=jim,email=like=jim,nombreApellidos=like=jim)

colectivoId=in=(refPAS,refPDI);(nombre=like=nombre.apellido@um.es,apellidos=like=nombre.apellido@um.es,email=like=nombre.apellido@um.es,nombreApellidos=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}idPersona
Detalle de los datos generales de una persona (este la persona activo o no)
POST/personasJSON

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/personasJSON

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}idDatosContacto
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

q+s (query + sort)

La query estará formada por:

  • fechaObtencion
  • fechaFin
VinculacionCategoriaProfesional

Si no se especifica ningún filtrado, deberá recuperar la categoría profesional a la que está asociada la persona y que sea vigente.

Para recuperar la vinculación activa a una FECHA determinada se generaría una consulta RSQL del tipo:

q=fechaObtencion<=FECHA;fechaFin>=FECHA,fechaFin=na=

Devolver la vinculación asociada a la persona con identificador {id} donde el objeto que viene en la  vinculacionCategoriaProfesional de esa vinculación debe cumplir que su atributo fechaObtencion sea menor o igual que una FECHA dada y su atributo fechaFin sea mayor o igual que una FECHA dada o no debe tener valor.

Ver UM - SGI - ESB - SGP - Adaptaciones integración para su implementación en el SGI.


GET/datos-academicos/persona/{id}idDatosContacto
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}/fotografiaidFotografia
Detalle de la fotografía digital de la persona (independientemente de que este activa o no la persona)

GET/sexeniosfechaLista[Sexenio]

Devuelve una lista de identificadores de persona con el número de sexenios en la fecha pasada por parámetro.

En caso de que la fecha se envíe vacía se enviará el número de sexenios en el momento actual

Se tendrá que mirar para la fecha pasada por parámetro el número de sexenios de cada PDI de la Universidad.

Si no tiene sexenios no se enviarán

Ejemplo:

  • fecha="2021-12-31T23:00:00Z"
GET/direccion-tesisanioDefensaLista[DireccionTesis]

Devuelve la lista de Direcciones de tesis (incluida la personaRef indicando la persona que es el director de la tesis) cuya fecha de defensa sea en el año que se le pasa por parámetro

Si se le pasa el parámetro del año de la fecha de defensa.

Ejemplo:

  • anioDefensa="2019"

Métodos donde el SGI solo hace de pasarela entre Universidad y CVN (No son necesarios para el funcionamiento del SGI)

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}

fecha

Sexenio

Devuelve el número de sexenios de la persona. Si se le pasa el parámetro de la fecha devuelve el número de sexenios en esa fecha, sino se devuelve el número de sexenios a la fecha actual.

Ejemplo:

  • fecha="2021-08-18T22:00:00Z"

GET/formacion/modificados-ids

q+s

La query estará formada por:

  • fechaModificacion
  • tipoFormacion
Lista[Long]

Listado de identificadores de las personas que han tenido modificaciones en formación realizada.

Se utilizarán los siguientes parámetros en la llamada al servicio:

  • fechaModificacion: se le pasará la fecha a partir de la cual se quieren ver los cambios
  • tipoFormacion: se le pasa el tipo de formación que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • /formacion/modificados-ids?q=fechaModificacion=ge="2022-01-01T00:00:00Z";tipoFormacion="020.010.020.000"
GET/formacion/{id}tipoFormacion

Lista[Formación (del tipo solicitado)]

Ver entidades en https://confluence.um.es/confluence/pages/viewpage.action?pageId=397534658


Detalle sobre los datos de la Formación Recibida, dependiendo del ID de la persona y el tipo de formación.

Se utilizará el siguiente parámetro en la llamada al servicio:

  • tipoFormacion: se le pasa el tipo de formación que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • /formacion/22468643?tipoFormacion="020.050.000.000"

GET/actividad-docente/modificados-ids

q+s

La query estará formada por:

  • fechaModificacion
  • tipoActividad
Lista[Long]

Listado de identificadores de las personas que han tenido modificaciones en la actividad docente.

Se utilizarán los siguientes parámetros en la llamada al servicio:

  • fechaModificacion: se le pasará la fecha a partir de la cual se quieren ver los cambios
  • tipoActividad: se le pasa el tipo de actividad docente que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • actividad-docente/modificados-ids?q=fechaModificacion=ge="2022-01-01T00:00:00Z";tipoActividad="030.040.000.000"
GET/actividad-docente/{id}tipoActividad

Lista[Actividad docente (del tipo solicitado)]

Ver entidades en https://confluence.um.es/confluence/display/HERCULES/Actividad+docente+-+CVN


Detalle sobre los datos de la Actividad Docente, dependiendo del ID de la persona y el tipo de actividad.

Se utilizará el siguiente parámetro en la llamada al servicio:

  • tipoActividad: se le pasa el tipo de actividad docente que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • actividad-docente/23019512?tipoActividad="030.040.000.000"

  • Sin etiquetas