Árbol de páginas

Versiones comparadas

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

...

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}idPersona
Detalle de los datos generales de una persona (esté la persona activa o no).
POST/personas/formlyJSON

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
languagejava
themeRDark
titleEjemplo de JSON
collapsetrue
{
	"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
titleDescripció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
languagejava
themeRDark
titleEjemplo de JSON
collapsetrue
{
  "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
titleDescripció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}idDatosContacto
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 a las que está asociada la persona y que sean 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 dada o no debe tener valor.


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/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-profesionalesLista[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.