Historial de página

...

Modelo lógico

Image Removed

API

Características generales que todas las API REST deben de cumplir:

• Consultas filtradas y paginadas
• Formatos de datos API

Definición de los objetos

Persona

Modelo lógico

Image Added

API

Características generales que todas las API REST deben de cumplir:

• Consultas filtradas y paginadas
• Formatos de datos API

Definición de los objetos

Persona

...

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

DireccionTesis

TipoTrabajoDirigido

TipoTrabajoDirigido

Servicios

...

...

URL

...

Parámetros

...

Respuesta

...

Permisos

...

Descripción

...

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

...

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.

...

id

Vendrá relleno si la creación es síncrona y no vendrá si es asíncrona.

...

Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona. Ver  IU-GEN-0061- Solicitar alta de persona.

...

...

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.

...

q+s (query + sort)

La query estará formada por:

• fechaObtencion
• fechaFin

...

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=

...

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

...

Listado de colectivos ordenados alfabéticamente de forma ascendente.

...

Devuelve una lista de identificadores de persona con el número de sexenios en el año pasado por parámtro.

Se tendrá que mirar para el año pasado por parámetro el número de sexenios de cada PDI de la Universidad.

Si no tiene sexenios no se enviarán

Si se le pasa el parámetro del año.

Ejemplo:

• anio="2019"

...

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)

...

q+s

La query estará formada por:

• fechaModificacion

...

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.

...

fecha

...

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"

...

q+s

La query estará formada por:

• fechaModificacion
• tipoFormacion

...

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:

• fechaModificacion=ge="2021-08-18T22:00:00Z"
• tipoFormacion="020.010.020.000" (para Doctorados)

...

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:

• tipoFormacion="020.010.020.000" (para Doctorados)

...

q+s

La query estará formada por:

• fechaModificacion
• tipoActividad

...

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:

• fechaModificacion=ge="2021-08-18T22:00:00Z"
• tipoActividad="030.040.000.000" (para direcciones)

...

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:

...