...
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, emilemail, 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 | 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". |
Modelo lógico
API
Definición de los objetos
Persona
...
Fotografia | Foto digital de la 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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"personaRef": "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"
} |
...
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" }, "comAuntonomaNacimiento": { { "id":"casex-1", "nombre":"AndalucíaMujer" }, "ciudadNacimientonumeroIdentificacion": "Sevilla11111111H", "tipoDocumento": } |
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "paisContacto": { { "id":"tp-1", "nombre": "NIF" }, "empresaRef: "ent-002", "personalPropio": true, "entidadPropiaRef" : "ent-UM-001", "emails":[{ email: "prueba@prueba.es", principal: true "id":"33"}, "nombre":"España"{ }, "comAuntonomaContacto": {email: "prueba2@prueba.es", "id":"ca-3", principal: false "nombre":"Asturias" }, "provinciaContacto": {] "idactivo":"pro-1", "nombre":"Asturias" }, "ciudadContacto": "Oviedo", "direccionContacto": "C/ Uria número 4, puerta A", "codigoPostalContacto": "33005" 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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "emailsid":["prueba@prueba.es","prueba2@prueba.es"]"tp-1", "telefonosnombre":[ "985112233","699445566"]NIF" } |
...
Nombre | Tipo | Descripción |
---|---|---|
categoriaProfesionalemail | CategoriaProfesional | Se devuelve la entidad CategoriaProfesional con todos sus campos |
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 |
empresa | Empresa | Se devuelve la entidad Empresa con los datos básicos. Ver definición en SGI - ESB - SGEMP |
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
} |
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" | ||||||||
Bloque de código | ||||||||
| ||||||||
{ "categoriaProfesional":{ "id":"catp-1", "nombre":"PDI Numerario" }, "subcategoriaProfesional": { "id":"cupro-1", "nombre":"Profesor" }, "departamentopaisNacimiento": { "id":"dpt-133", "nombre":"España"Departamento Ciencias de la tecnología" }, "areaConocimientocomAuntonomaNacimiento": { "id":"acca-1", "nombre":"Área de conocimiento AAndalucía" }, "empresa": { "idciudadNacimiento":"emp-1", "nombre":"Universidad de Murcia"Sevilla" } } |
...
DatosContacto
Nombre | Tipo | Descripción | id
---|---|---|
paisContacto | StringPais | Identificador de la entidad CategoriaProfesional |
nombre | String | Nombre de la categoría profesional de la persona dentro de la universidad.(RELACIONES VIGENTES UM.xlsx) |
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. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{
"vinculacionCategoriaProfesional":{
"categoriaProfesional":{
"id":"catp-1",
"nombre":"PDI Numerario"
},
"fechaObtencionCategoria":"2020-03-15"
},
"departamento": {
| ||||||||
Bloque de código | ||||||||
| ||||||||
{ "id":"catpdpt-1", "nombre":"PDI Numerario" } |
SubcategoriaProfesional
...
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "nombre":"Departamento Ciencias de la tecnología" }, "centro": { "id":"cuprocen-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, "entidadPropiaRef": "ent-UM-001" } |
...
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 | Codigo 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)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 | |||
---|---|---|---|---|---|
contenido | String | Contenido de la fotografía digital de la persona (en bytes y en base 64) | |||
nivelAcademico | NivelAcademico | Se devuelve la entidad NivelAcademico con todos sus campos. | |||
fechaObtencion | Fecha | Fecha obtención del nivel académico. | mimeType | String | Mimetype de la fotogracía |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "nivelAcademico": { "contenido"id":"1", "nombre":"DDfgdfgdfj46gd6f5gdfgdf="Doctorado" }, "mimeTypefechaObtencion":"image/jpeg2000-02-10" } |
Métodos
...
Método
...
URL
...
Parámetros
...
Respuesta
...
Permisos
...
Descripción
...
q+s (query + sort)
La query estará formada por:
- TipoColectivo o un listado de colectivos
- Cadena de texto que podrá contener indistintamente:
- Nombre
- Apellidos
- Nº de documento de identificación personal
...
Listado de Persona.
Sort: Nombre del campo por el que se ordena seguido de +/- para ordenar ascendente o descendentemente. Ejemplo : nombre-
Query: Criterios de búsqueda. Lista de criterios de búsqueda separada por comas, donde un criterio de búsqueda es el nombre de uno de los campos de la entidad buscada seguido de la operación y el valor con el que se hace la comparación. Las operaciones soportadas son:
- : equals
- !: not equals
- ~ like
- !~ not like
- > greather
- >: greather or equal
- < lower
- <: lower or equal
Ejemplo: colectivo:PAS,cadena~11111111H
...
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
...
NivelAcademico
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 | ||||
---|---|---|---|---|
|
...
/datos-contacto/formly/create
...
/vinculaciones/formly/create
...
/datos-academicos/formly/create
...