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

...

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

...

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

...

Bloque de código
languagejava
themeRDark
titleTipoDocumento
collapsetrue
{ 
    "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".
Bloque de código
languagejava
themeRDark
titleEmail
collapsetrue
{ 
    "email":"email@um.es",
    "principal": true   
}

...

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.

...

  • numeroDocumento
  • 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 lavinculaciónasociada 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)

    Métodos para hacer la integración con Gnoss para el CVN

    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}
    Sexenio
    Devuelve el número de sexenios de la persona

    GET/formacion/modificados-ids

    q+s

    La query estará formada por:

    • fechaModificacion
    • tipoFormacion
    Lista[Long]

    Listado de identificadores de Formación que han sido modificadas (tanto la entidad Formación como todas sus entidades relacionadas).

    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)
    GET/formacion/{id}

    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 tipo






    GET/actividad-docente/modificados-ids

    q+s

    La query estará formada por:

    • fechaModificacion
    • tipoActividad
    Lista[Long]

    Listado de identificadores de Actividad docente que han sido modificadas (tanto la entidad Actividad docente como todas sus entidades relacionadas).

    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"
    • tipoFormacion="030.040.000.000" (para direcciones)
    GET/actividad-docente/{id}

    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 tipo

    Métodos los 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.

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