Historial de página

...

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 tanto a la estructura organizativa Universitaria, en caso de disponer de ella tanto como PAS como en calidad de PDI, como la relación que esté vigente en la actualidad con una entidad externa, en caso de disponer de ella.
VinculacionCategoria	Relaciona la vinculación de una persona con la lista de categorías que puede tener vigentes, una como PDI, una como PAS, ambas o ninguna.
VinculacionDepartamento	Relaciona la vinculación de una persona con la lista de departamentos que puede tener vigentes, uno como PDI, uno como PAS, ambos o ninguno.
HistoricoVinculacionEmpresa	Contiene el historial de relaciones de la persona con entidades externas y que ya no son vigentes en la actualidad.
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 qué 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 de una persona

...

Info

title	Cambios

29-abr-2021 Se actualizan los objetos para:

Eliminar objeto "Subcategoria" y su referencia desde el objeto "Vinculacion".
Eliminar la referencia a "Empresa" (Entidad) del objeto "Vinculacion".
Añadir la referencia a "Empresa" (Entidad) en el objeto "Persona".

03-may-2021 Se actualizan los objetos con campos de tipo fecha (DatosPersonales, Vinculacion y DatosAcademicos) para poner correctamente el tipo Fecha en lugar de String.

13-may-2021 Se actualizan los objetos para:

Modificar la definición del campo referencia a "Empresa" (Entidad) en el objeto "Persona".
Añadir en "Vinculacion" los siguientes campos:
- Referencia a Empresa (Entidad).
- Categoría profesional como PDI.
- Categoría profesional como PAS.
- Fecha de obtención de categoría profesional como PDI.
- Fecha de obtención en categoría profesional como PAS.
- Fecha de fin en categoría profesional como PDI.
- Fecha de fin en categoría profesional como PAS.
- Departamento como PDI.
- Departamento como PAS.
Eliminar en la entidad "Vinculacion" los siguientes campos:
- Categoría profesional.
- Fecha de obtención de categoría profesional.
- Departamento.

21-jun-2021 Se modifica la definición de objetos para:

Modificaciones en los campos del objeto DatosContacto-UM relativos al detalle de dirección de contacto:
- Se añaden tipoViaContacto, nombreViaContacto, numeroViaContacto y ampliacionDireccionContacto.
- Se elimina direccionContacto.
Añadir relación del objeto DatosContacto-UM con el objeto TipoVia.

03-sep-2021 Se modifica la definición de objetos para:

Añadir campo activo en la entidad Persona.

13-sep-2021 Se modifica la definición de objetos para:

Añadir campo personalPropio en la entidad Persona.

27-sep-2021 Se modifica la definición de objetos para:

Añadir nuevo campo moviles a la entidad DatosContacto.

12-nov-2021 Se modifica la definición de objetos para:

Añadir entidad Sexenio

15-nov-2021 Se modifica la definición de objetos para:

Añadir campo emails al objeto Persona.
Añadir el nuevo campo entidadPropiaRef a los objetos Persona y Vinculacion relacionarlos con Empresa.
Añadir al Crear el objeto Email con el nuevo campo principal.
Cambiar en el objeto DatosContacto el tipo de elemento de la lista de emails de String a Email.
Añadir al objeto Vinculacion una lista de objetos Categoria y otra de objetos Departamento para reflejar las categorías y departamentos como PDI y como PAS.
Eliminar del objeto Vinculacion los campos de categoría y sus fechas de obtención y fin tanto para PDI como para PAS y los campos de departamento tanto PDI como PAS.

...

Bloque de código

language	java
theme	RDark
title	TipoDocumento
collapse	true

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

Bloque de código

language	java
theme	RDark
title	Email
collapse	true

{ 
    "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 UM - SGI - ESB - SGO.
comAuntonomaNacimientocomAutonomaNacimiento	ComunidadAutonoma	Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en UM - SGI - ESB - SGO.
ciudadNacimiento	String	Ciudad de nacimiento de la persona.

Bloque de código

language	java
theme	RDark
title	DatosPersonales
collapse	true

{
    "fechaNacimiento": "2000-02-10",
    "paisNacimiento": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaNacimientocomAutonomaNacimiento": {
       "id":"ca-1",
       "nombre":"Andalucía"
     }, 
    "ciudadNacimiento": "Sevilla"
    
}

...

Bloque de código

language	java
theme	RDark
title	CategoriaProfesionalVinculacionCategoriaProfesional
collapse	true

{    
	"categoriaProfesional": {
		"id":"catp-1",
   		"nombre":"PDI Numerario"
	},
	"fechaObtencionCategoria" : "2020-03-15",
	"fechaFinCategoria" : "2022-03-15",
	"tipoPersonal":"PDI"
}

...

Bloque de código

language	java
theme	RDark
title	CategoriaProfesionalVinculacionDepartamento
collapse	true

{    
	"departamento": {
		"id":"dpt-145",
		"nombre":"Departamento de Informática aplicada"
	},
   "tipoPersonal":"PAS"
}

...

Método

URL

Parámetros

Respuesta

Permisos

Descripción

Métodos a los que se llama desde el SGI y éstos a su vez llaman a los sistemas de la Universidad

GET

/personas

q+s (query + sort)

La query estará formada por:

id
colectivoId
nombre
apellidos
~~numeroDocumento~~
fechaModificacion
email

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:

Este método tendrá que ser capaz de responder con una lista de las personas modificadas con posterioridad a la fecha/hora proporcionada en el parámetro fechaModificacion.

La modificación debe incluir altas, actualizaciones y borrados lógicos.

GET /personas/{id} id Persona Detalle de los datos generales de una persona (esté la persona activa o no).

POST

/personas/formly

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.

Bloque de código

language	java
theme	RDark
title	Ejemplo de JSON
collapse	true

{
	"nombre": "nombre de prueba",
	"apellidos": "apellidos de prueba",
	"tipoDocumentoId": "2",
	"numeroDocumento": "07852369Y",
	"sexoId": "2",
	"fechaNacimiento": "1981-05-18",
	"paisNacimientoId": "1",
	"regionNacimientoId": "3",
	"ciudadNacimiento": "Madrid",
	"empresaId": "3",
    "tipoViaContactoId": "3",
    "nombreViaContacto": "Castellana",
    "numeroViaContacto": "123",
    "ampliacionDireccionContacto": "ampliación",
	"paisContactoId": "1",
	"regionContactoId": "2",
	"provinciaContactoId": "10",
	"codigoPostalContacto": "48152",
	"ciudadContacto": "Alcorcón (Madrid)",
	"emails": ["a@prueba.com", "a@prueba.com" ],
    "telefonos": ["666123456","666654321"],
}

Expandir

title	Descripción de campos JSON (pulsa para expandir)...

nombre: Nombre
apellidos: Apellidos
tipoDocumentoId: Id tipo de documento procedente de endpoint /tipos-documento
numeroDocumento: Número de documento
sexoId: Id sexo procedente de endpoint /sexos
fechaNacimiento: Fecha de nacimiento en formato yyyy-MM-dd (Ej: 1981-05-18)
paisNacimientoId: Id de pais de nacimiento procedente de endpoint /paises. Ver definición en UM - SGI - ESB - SGO
regionNacimientoId: Id de comunidad autónoma de nacimiento procedente de endpoint /comunidades-autonomas. Ver definición en UM - SGI - ESB - SGO
ciudadNacimiento: Ciudad de nacimiento
empresaId: Id de empresa procedente de endpoint /empresas. Ver definición en UM - SGI - ESB - SGEMP
tipoViaContactoId: Id de tipo de vía de contacto. Ver definición en UM - SGI - ESB - SGO
nombreViaContacto: Nombre de vía de contacto
numeroViaContacto: Número de dirección de contacto
ampliacionDireccionContacto: Descripción de ampliación
paisContactoId: Id de pais de contacto procedente de endpoint /paises. Ver definición en UM - SGI - ESB - SGO
regionContactoId: Id de comunidad autónoma de contacto procedente de endpoint /comunidades-autonomas. Ver definición en UM - SGI - ESB - SGO
provinciaContactoId: Id de provincia de contacto procedente de endpoint /provincias. Ver definición en UM - SGI - ESB - SGO
codigoPostalContacto: Código postal de contacto
ciudadContacto: Ciudad de contacto
emails: Array de emails

telefonos: Array de teléfonos

PUT

/personas/formly/{id}

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.

Bloque de código

language	java
theme	RDark
title	Ejemplo de JSON
collapse	true

{
  "personaId": "1",
  "nombre": "nombre de prueba",
  "apellidos": "apellidos de prueba",
  "tipoDocumentoId": "2",
  "numeroDocumento": "07852369Y",
  "sexoId": "2",
  "fechaNacimiento": "2021-02-14T23:00:00Z",
  "paisNacimientoId": "1",
  "regionNacimientoId": "3",
  "ciudadNacimiento": "Madrid",
  "empresaId": "3",
  "fechaInicioVinculacion": "2021-02-14T23:00:00Z",
  "tipoViaContactoId": "3",
  "nombreViaContacto": "Castellana",
  "numeroViaContacto": "123",
  "ampliacionDireccionContacto": "ampliación",
  "paisContactoId": "1",
  "regionContactoId": "2",
  "provinciaContactoId": "10",
  "codigoPostalContacto": "48152",
  "ciudadContacto": "Alcorcón (Madrid)",
  "emails": ["a@prueba.com", "b@prueba.com"],
  "telefonos": ["666123456","666654321"],
  "areaConocimientoId": "id1",
  "historicosEntidades": [
    {
      "entidad": "entidad 1",
      "inicioVinculacion": "2021-02-14T23:00:00Z",
      "finVinculacion": "2021-02-14T23:00:00Z"
    }
  ],
  "nivelAcademicoId": "1",
  "fechaObtencion": "2021-02-14T23:00:00Z",
  "categoriaPdiId": "1",
  "departamentoPdiId": "2",
  "fechaCategoriaPdi": "2021-02-14T23:00:00Z",
  "fechaFinCategoriaPdi": "2021-02-14T23:00:00Z",
  "categoriaPasId": "2",
  "unidadPasId": "1",
  "fechaCategoriaPas": "2021-02-14T23:00:00Z",
  "fechaFincategoriaPas": "2021-02-14T23:00:00Z"
}

Expandir

title	Descripción de campos JSON (pulsa para expandir)...

personaId: Id de persona
nombre: Nombre
apellidos: Apellidos
tipoDocumentoId: Id tipo de documento procedente de endpoint /tipos-documento
numeroDocumento: Número de documento
sexoId: Id sexo procedente de endpoint /sexos
fechaNacimiento: Fecha de nacimiento en formato ISO 8601 en UTC
paisNacimientoId: Id de pais de nacimiento procedente de endpoint /paises. Ver definición en UM - SGI - ESB - SGO
regionNacimientoId: Id de comunidad autónoma de nacimiento procedente de endpoint /comunidades-autonomas. Ver definición en UM - SGI - ESB - SGO
ciudadNacimiento: Ciudad de nacimiento
empresaId: Id de empresa procedente de endpoint /empresas. Ver definición en UM - SGI - ESB - SGEMP
fechaInicioVinculacion: Fecha de inicio de vinculación en formato ISO 8601 en UTC
tipoViaContactoId: Id de tipo de vía de contacto. Ver definición en UM - SGI - ESB - SGO
nombreViaContacto: Nombre de vía de contacto
numeroViaContacto: Número de dirección de contacto
ampliacionDireccionContacto: Descripción de ampliación
paisContactoId: Id de pais de contacto procedente de endpoint /paises. Ver definición en UM - SGI - ESB - SGO
regionContactoId: Id de comunidad autónoma de contacto procedente de endpoint /comunidades-autonomas. Ver definición en UM - SGI - ESB - SGO
provinciaContactoId: Id de provincia de contacto procedente de endpoint /provincias. Ver definición en UM - SGI - ESB - SGO
codigoPostalContacto: Código postal de contacto
ciudadContacto: Ciudad de contacto
emails: Array de emails

telefonos: Array de teléfonos

areaConocimientoId: Área de conocimiento a la que está adscrita la persona
historicosEntidades: Array de histórico de entidades con objetos que refleja la información devuelta por el esb y que tiene la siguiente estructura:
- entidad: Entidad
- inicioVinculacion: Inicio de vinculación
- finVinculacion: Fin de vinculación
nivelAcademicoId: Id de nivel académico procedente de endpoint /niveles-academicos
fechaObtencion: Fecha de obtención nivel académico en formato ISO 8601en UTC
categoriaPdiId: Id de categoría PDI procedente de endpoint /categorias-profesionales
departamentoPdiId: Id de departamento
fechaCategoriaPdi: Fecha de nacimiento en formato ISO 8601 en UTC
fechaFinCategoriaPdi: Fecha de nacimiento en formato ISO 8601 en UTC
categoriaPasId: Id de categoría PAS procedente de endpoint /categorias-profesionales
unidadPasId: Id de unidad
fechaCategoriaPas: Fecha de nacimiento en formato ISO 8601 en UTC
fechaFincategoriaPas: Fecha de fin de categoría en formato ISO 8601 en UTC

GET

/personas/formly/{id}

JSON

Devuelve los datos a pintar en el formulario de Ver Detalle/Actualizar en el SGI (formly).

Se recibirá el mismo json que en la solicitud de modificación de persona (/personas PUT)

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 y/o de teléfonos fijos y móviles 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:

fechaObtencionCategoria
fechaFinCategoria

Lista[VinculacionCategoriaProfesional]

Si no se especifica ningún filtrado, deberá recuperar la lista de categorías profesionales vigentes.

Para recuperar la lista de vinculaciones activas a una FECHA determinada se generaría una consulta RSQL del tipo:

q=fechaObtencionCategoria<=FECHA;fechaFinCategoria>=FECHA,fechaFinCategoria=na=

Devolver las vinculaciones asociadas a la persona con identificador {id} donde los objetos que viene en la lista vinculacionesCategoriasProfesionales deben cumplir que su atributo fechaObenticionCategoria debe ser menor o igual que una FECHA dada y su atributo fechaFinCategoria debe ser mayor o igual que una FECHA data o no debe tener valor.

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)

GET

/personas/modificadas-ids

q+s (query + sort)

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.

La modificación debe incluir altas, actualizaciones y borrados lógicos.

GET /sexenios/persona/{id} Lista[Sexenio] Contiene la lista de sexenios reconocidos en un país determinado de una persona

Método al que se llama desde los sistemas de la Universidad al SGI

POST /vinculaciones/persona/{id}/vinculaciones-categorias-profesionales Lista[VinculacionCategoriaProfesional] Comunicación de un cambio en los datos de vinculación de una persona, en concreto, de su categoría profesional bien como PAS bien como PDI o como ambas en los sistemas de la UM.

Árbol de páginas

Versiones comparadas

Versión anterior 86

Nueva versión 87

Clave

Email

DatosPersonales