...
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). Se necesita un mapeo con los valores de la Fecyt para poder mostrarlo en el módulo CVN. Se tomará como id los códigos de la Fecyt. | ||
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 (RELACIONES VIGENTES UM.xlsx). | ||
SubcategoriaProfesional | Una clasificación dentro de la categoría profesional. Es una subclasificación de la categoría profesional. Por ejemplo una persona que tiene categoría profesional PDI Numerario, se puede clasificar en: catedrático de universidad, titular de universidad, profesor ayudante y/o profesor. | ||
NivelAcademico | Listado con los niveles académicos (Doctor, | 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. |
Modelo lógico
API
Características generales que todas las API REST deben de cumplir:
Definición de los objetos
Persona
...
Sexenio | Contiene el número de sexenios en un país determinado de una persona |
Enumerados
Info |
---|
Para la definición de los enumerados en el código seguir lo indicado en: Enumerados |
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:
Definición de los objetos
Persona
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id": "ent-002",
"nombre": "Prueba",
"apellidos": "Apellido1 Apellido2",
"sexo": {
"id":"sex-1",
"nombre":"Mujer"
},
"numeroIdentificacion": "11111111H",
"tipoDocumento": {
"id":"tp-1",
"nombre": "NIF"
}
} |
Sexo
...
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"sex-1",
"nombre":"Mujer"
} |
TipoDocumento
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad TipoDocumentopersona. |
nombre | String | Nombre (Posibles valores: NIF, NIE, Pasaporte) |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"tp-1",
"nombre": "NIF"
} |
DatosPersonales
...
Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO
...
Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO
...
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Bloque de código | ||||||||
| ||||||||
{ "fechaNacimientoid": "2000ent-02-10002", "paisNacimientonombre": { "Prueba", "idapellidos": "33Apellido1 Apellido2", "nombresexo":"España" { }, "comAuntonomaNacimientoid": { "sex-1", "idnombre":"ca-1Mujer", }, "nombrenumeroIdentificacion":"Andalucía" "11111111H", "tipoDocumento": { }, "ciudadNacimientoid": "Sevillatp-1", } |
DatosContacto
...
Se devuelve la entidad Pais con todos sus campos. Ver definición en SGI - ESB - SGO
...
Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO
...
Se devuelve la entidad Provincia con todos sus campos. Ver definición en SGI - ESB - SGO
...
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
"nombre": "NIF" }, "empresaRef: "ent-002", "personalPropio": true, "entidadPropiaRef" : "ent-UM-001", "emails":[{ "paisContacto": { email: "id":"33"prueba@prueba.es", "nombre":"España" principal: true }, "comAuntonomaContacto": { "id"email:"ca-3 "prueba2@prueba.es", "nombre":"Asturias" principal: false }, "provinciaContacto": {} ] "id":"pro-1", "nombre":"Asturias" }, "ciudadContacto": "Oviedo", "direccionContacto": "C/ Uria número 4, puerta A", "codigoPostalContacto": "33005" "emails":["prueba@prueba.es","activo": true } |
Sexo
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad Sexo |
nombre | String | Nombre (Posibles valores: Mujer, Hombre) |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"sex-1",
"nombre":"Mujer"
} |
TipoDocumento
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad TipoDocumento |
nombre | String | Nombre (Posibles valores: NIF, NIE, Pasaporte) |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ prueba2@prueba.es"], "telefonosid":["985112233tp-1","699445566"] "nombre": "NIF" } |
...
Nombre | Tipo | Descripción |
---|---|---|
categoriaProfesional | CategoriaProfesional | Se devuelve la entidad CategoriaProfesional con todos sus campos |
fechaObtencionCategoria | String | Fecha en la que se obtiene la categoría profesional |
subcategoriaProfesional | SubcategoriaProfesional | Se devuelve la entidad SubcategoriaProfesional con todos sus campos |
departamento | Departamento | Se devuelve la entidad Departamento con todos sus campos. Ver definición en 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. |
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ | ||||||||
Bloque de código | ||||||||
| ||||||||
{ "categoriaProfesionalemail":{"email@um.es", "principal": true "id":"catp-1", "nombre":"PDI Numerario" } |
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 SGI - ESB - SGO |
comAuntonomaNacimiento | ComunidadAutonoma | Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en SGI - ESB - SGO |
ciudadNacimiento | String | Ciudad de nacimiento de la persona |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "fechaNacimiento": "2000-02-10", "paisNacimiento": { "id":"33", "nombre":"España" }, "fechaObtencionCategoria":"2020-03-15", "subcategoriaProfesional": { "id":"cupro-1", "nombre":"Profesor" }, "departamentocomAuntonomaNacimiento": { "id":"dptca-1", "nombre":"Departamento Ciencias de la tecnología" }, "areaConocimiento": { "id":"ac-1", "nombre":"Área de conocimiento A" }, "empresaRef": "emp-1" } |
CategoriaProfesional
"Andalucía"
},
"ciudadNacimiento": "Sevilla"
} |
DatosContacto
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. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"paisContacto": {
"id":"33",
"nombre":"España"
},
"comAuntonomaContacto": {
"id":"ca-3",
"nombre":"Asturias"
},
"provinciaContacto": {
"id":"pro-1",
"nombre":"Asturias"
},
"ciudadContacto": "Oviedo",
"direccionContacto": "C/ Uria número 4, puerta A",
"codigoPostalContacto": "33005"
"emails":[{
email: "prueba@prueba.es",
principal: true
},
{
email: "prueba2@prueba.es",
principal: false
}
],
"telefonos":["985112233","984445566"],
"moviles":["666112233","699445566"]
} |
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. |
Nombre | Tipo | Descripción |
id | String | Identificador de la entidad CategoriaProfesional. |
nombre | String | Nombre de la categoría profesional de la persona dentro de la universidad. (RELACIONES VIGENTES UM.xlsx) |
Bloque de código | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
{ "vinculacionCategoriaProfesional":{ "categoriaProfesional":{ { "id":"catp-1", "nombre":"PDI Numerario" } |
SubcategoriaProfesional
...
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ }, "fechaObtencionCategoria":"2020-03-15" }, "departamento": { "id":"cuprodpt-1", "nombre":"Departamento Ciencias de la tecnología" }, "centro": { "id":"cen-1", "nombre":"Profesor" } |
DatosAcademicos
...
Se devuelve la entidad NivelAcademico con todos sus campos.
...
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "nivelAcademico "Centro 1 de la Universidad de Murcia" }, "areaConocimiento": { "id":"ac-1", "nombre":"Doctorado",Área de conocimiento A" "codigoFecyt}, "empresaRef": "940ent-002", "personalPropio" : }true, "fechaObtencion "entidadPropiaRef": "2000ent-02UM-10001" } |
...
VinculacionCategoriaProfesional
Nombre | Tipo | Descripción | |||||
---|---|---|---|---|---|---|---|
idcategoriaProfesional | StringCategoriaProfesional | Identificador Categoría profesional de la entidad NivelAcademicopersona. | |||||
fechaObtencionCategoria | String | Nombre del NivelAcademico (Posibles valores: Doctor, Ldo/Graduado, Diplomado, FP, etc). | Fecha | Fecha de obtención de categoría profesional de la persona | codigoFecyt | String | Código en la norma Fecyt que se corresponde con el nivel académico del SGI. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "categoriaProfesional": { "id":"catp-1", "nombre":"Doctorado", "codigoFecyt":"940" } |
...
PDI Numerario"
},
"fechaObtencionCategoria" : "2020-03-15"
} |
CategoriaProfesional
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad ColectivoCategoriaProfesional. |
nombre | String | Nombre del colectivo (Posibles valores: PAS, PSI, Alumnos, Becarios, Externo)Nombre de la categoría profesional de la persona dentro de la universidad. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "id":"catp-1", "nombre":"PDI Numerario" } |
...
DatosAcademicos
Nombre | Tipo | Descripción | ||||
---|---|---|---|---|---|---|
contenidonivelAcademico | StringNivelAcademico | Se devuelve la entidad NivelAcademico con todos sus campos. | ||||
fechaObtencion | Fecha | Fecha obtención del nivel académico. | Contenido de la fotografía digital de la persona (en bytes y en base 64) | mimeType | String | Mimetype de la fotografía |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "nivelAcademico": { "contenido"id":"1", "nombre":"DDfgdfgdfj46gd6f5gdfgdf="Doctorado" }, "mimeTypefechaObtencion":"image/jpeg"2000-02-10" } |
...
NivelAcademico
...
Método
...
URL
...
Parámetros
...
Respuesta
...
Permisos
...
Descripción
...
q+s (query + sort)
La query estará formada por:
- tipoColectivo
- colectivoId
- nombre
- apellidos
- numeroDocumento
- id
...
Lista[Persona]
...
Listado de Persona.
Ejemplo:
colectivoId=in=(refPAS,refPDI);(nombre=like=11111111H,apellidos=like=11111111H,numeroDocumento=like=11111111H)
Nota: tipoColetivo y colectivoId son mutuamente excluyentes. En el caso se recibir un tipoColectivo se traducirá a los colectivos que lo formen.
...
Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona, pestaña "Datos básicos". Ver IU-GEN-0061- Solicitar alta de persona
...
DatosPersonales
...
/datos-personales/formly/create
...
/datos-contacto/formly/create
...
/vinculaciones/formly/create
...
/datos-academicos/formly/create
...
Listado de colectivos ordenados alfabéticamente de forma ascendente.
...
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad NivelAcademico. |
nombre | String | Nombre del NivelAcademico (Posibles valores: Doctor, Ldo/Graduado, Diplomado, FP, etc). |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"1",
"nombre":"Doctorado"
} |
Colectivo
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad Colectivo. |
nombre | String | Nombre del colectivo (Posibles valores: PAS, PSI, Alumnos, Becarios, Externo). (RELACIONES VIGENTES UM.xlsx) |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"id":"1",
"nombre":"PDI"
} |
Fotografia
Nombre | Tipo | Descripción |
---|---|---|
contenido | String | Contenido de la fotografía digital de la persona (en bytes y en base 64). |
mimeType | String | Mimetype de la fotografía. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"contenido":"DDfgdfgdfj46gd6f5gdfgdf=",
"mimeType":"image/jpeg"
} |
Sexenio
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 | Título del trabajo |
fechaDefensa | Fecha | Fecha de obtención del título Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z"). |
alumno | String | Identificador en el SGP si existe el alumno y sino nombre y apellidos 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 | Fecha | Fecha de la mención del doctorado europeo. Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z"). |
mencionCalidad | Boolean | Indica si el dotorado ha recibido una mención de calidad |
fechaMencionCalidad | Fecha | Fecha de la homologación del doctorado extranjero. Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z"). |
mencionInternacional | Boolean | Indica si tiene mención internacional o no |
mencionIndustrial | Boolean | Indica si tiene mención industrial o no |
TipoTrabajoDirigido
Nombre | Tipo | Descripción |
id | String | Identificador del tipo de trabajo-proyecto dirigido (055, 067, 071, 066, OTHERS) |
nombre | String | Tipo de trabajo dirigido. Posibles valores:
|
Servicios
Info |
---|
Para componer la URL llamada completa, se debe anteponer a lo indicado en la columna URL lo siguiente: {HOST}/api/spg, donde {HOST} de deberá sustituir el dominio correspondiente al entorno al que se está accediendo y dicho acceso será por http o https según el caso. |
Incluir página | ||||
---|---|---|---|---|
|
Incluir página | ||||
---|---|---|---|---|
|
Incluir página | ||||
---|---|---|---|---|
|
...