...
| 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 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). |
| 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 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". |
| Fotografia | Foto digital de la persona. |
| Sexenio | Contiene el número de sexenios en un país determinado de una persona |
...
| Entidad | Descripció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:
|
Modelo lógico
API
Características generales que todas las API REST deben de cumplir:
...
| Nombre | Tipo | Descripción |
|---|---|---|
| id | String | Identificador de la persona. |
| nombre | String | Nombre de la persona. |
| apellidos | String | Apellidos de la persona. |
| sexo | Sexo | Se devuelve la entidad Sexo con todos sus campos. |
| numeroDocumento | String | Número de documento de identificación personal. |
| tipoDocumento | TipoDocumento | Se devuelve la entidad TipoDocumento con todos sus campos. |
| empresaRef | String | Se devuelve el identificador/referencia de la entidad Empresa. |
| personalPropio | Boolean | Indica si es personal de la Universidad o no (a día de hoy). |
| entidadPropiaRef | String | Se 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. |
| emails | Lista[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) |
| activo | Boolean | Indica si la persona esta activa o no (a día de hoy). |
...
| Bloque de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"tp-1",
"nombre": "NIF"
} |
| Nombre | Tipo | Descripción |
|---|---|---|
| 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 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"email":"email@um.es",
"principal": true
} |
...
| Nombre | Tipo | Descripción |
|---|---|---|
| paisContacto | Pais | Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO. |
| comAutonomaContacto | ComunidadAutonoma | Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO. |
| provinciaContacto | Provincia | Se devuelve la entidad Provincia con todos sus campos. Ver definición en SGI - ESB - SGO. |
| ciudadContacto | String | Ciudad de contacto de la persona. |
| direccionContacto | String | Dirección de contacto de la persona. |
| codigoPostalContacto | String | Código postal de la dirección de contacto de la persona. |
| emails | Lista[Email] | Lista con los emails de la persona. |
| telefonos | Lista[String] | Lista con los teléfonos fijos de la persona. |
| moviles | Lista[String] | Lista con los teléfonos móviles de la persona. |
...
Vinculacion
| Nombre | Tipo | Descripción |
|---|---|---|
| vinculacionCategoriaProfesional | VinculacionCategoriaProfesional | Se devuelve la entidad VinculacionCategoriaProfesional con todos sus campos. |
| departamento | Departamento | Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO. |
| centro | Centro | Se devuelve la entidad Centro con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO). |
| areaConocimiento | AreaConocimiento | Se devuelve la entidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO. |
| empresaRef | String | Se devuelve el identificador/referencia de la entidad Empresa externa que es la relacionada en la actualidad con la persona, la vigente. |
| personalPropio | Boolean | Indica si es personal de la Universidad o no (a día de hoy). |
| entidadPropiaRef | String | Se 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. |
| Bloque de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"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
| Nombre | Tipo | Descripción |
|---|---|---|
| categoriaProfesional | CategoriaProfesional | Categoría profesional de la persona. |
| fechaObtencionCategoria | Fecha | Fecha de obtención de categoría profesional de la persona. |
| Bloque de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"categoriaProfesional": {
"id":"catp-1",
"nombre":"PDI Numerario"
},
"fechaObtencionCategoria" : "2020-03-15"
} |
...
| Nombre | Tipo | Descripción |
|---|---|---|
| numero | String | Número de sexenios reconocidos |
| paisRef | String | País del reconocimiento |
| personaRef | String | Identificador de la persona que tiene el sexenio |
| Bloque de código | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"numero":"2",
"paisRef":"011",
"personaRef":11111111
} |
...
DireccionTesis
| Nombre |
| Tipo |
| Descripción |
| id |
| String |
| Identificador del doctorado |
| personaRef | String | Identificador de la persona que es el Director de la tesis |
| tituloTrabajo | String | |
| fechaDefensa | Date | Fecha de obtención del título |
| alumno | String | Nombre del alumno. |
| tipoProyecto | TipoTrabajoDirigido | Tipo del trabajo dirigido: Otros, Proyecto de fin de carrera, Tesina, Tesis doctoral, Trabajo conducente a la obtención de DEA |
| calificacionObtenida | String | P.e. "Cum laude" |
| coDirectorTesisRef | String | Identificador del co-director/a que ha intervenido |
| doctoradoEuropeo | Bool | Indica si se ha recibido una mención europea |
| fechaMencionDoctoradoEuropeo | Date | Fecha de la mención del doctorado europeo |
| mencionCalidad | Bool | Indica si el dotorado ha recibido una mención de calidad |
| fechaMencionCalidad | Date | Fecha de la homologación del doctorado extranjero |
| mencionInternacional | Bool | |
| mencionIndustrial | Bool |
TipoTrabajoDirigido
| Nombre | Tipo | Descripción |
| id | String | Identificador del tipo de trabajo-proyecto dirigido |
| nombre | String | Tipo de trabajo dirigido. Posibles valores:
|
Servicios
Método | URL | Parámetros | Respuesta | Permisos | Descripción | |||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| GET | /personasFast |
| 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:
| 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} | id | Persona | Detalle de los datos generales de una persona (este la persona activo o no) | ||||||||||||||||||||||||||||||||
| POST | /personas | 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. | ||||||||||||||||||||||||||||||||
| PUT | /personas | 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. | |||||||||||||||||||||||||||||||||
| 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 | /personasFast |
| 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:
| 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} | id | Persona | Detalle de los datos generales de una persona (este la persona activo o no) | POST | /personas | 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. | PUT | /personas | 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. | 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} | id | DatosContacto | 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:
| 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: 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} | 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 ascendenteordenados 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 | /sexosniveles-academicos | Lista[SexoNivelAcademico] | Listado de sexos niveles académicos 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) | 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 | /sexenios | anio | Lista[Sexenio] | 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:
| ||||||||||||||||||||||||||||||||
| GET | /direccion-tesis | anioDefensa | Lista[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:
| ||||||||||||||||||||||||||||||||
Métodos para hacer la integración con Gnoss para el CVNMé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:
| 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, 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 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 | 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:
| ||||||||||||||||||||||||||||||||
| GET | /formacion/modificados-ids | q+s La query estará formada por:
| 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:
Ejemplo:
| ||||||||||||||||||||||||||||||||
| 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: | GET | /formacion/modificados-ids | q+s La query estará formada por:
| 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
Ejemplo:
| 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 |
Ejemplo:
| ||||||||||||||||||||||
| GET | /actividad-docente/modificados-ids | q+s La query estará formada por:
| Lista[Long] | Listado de identificadores de Actividad docentelas personas que han sido modificadas (tanto la entidad Actividad docente como todas sus entidades relacionadas)tenido modificaciones en la actividad docente. Se utilizarán los siguientes parámetros en la llamada al servicio:
Ejemplo:
| ||||||||||||||||||||||||||||||||
| 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 tipo | ||||||||||||||||||||||||||||||||
Docente, dependiendo del ID de la persona y el tipo de actividad. Se utilizará el siguiente parámetro en la llamada al servicio:
Ejemplo:
|
| |||||||||||||||||||||||||||||||||||