Sistema de Gestión Personas
Entidades
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) | |
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, 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. |
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
Características generales que todas las API REST deben de cumplir:
Definición de los objetos
Persona
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 |
Sexo
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad Sexo |
nombre | String | Nombre (Posibles valores: Mujer, Hombre) |
TipoDocumento
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad TipoDocumento |
nombre | String | Nombre (Posibles valores: NIF, NIE, Pasaporte) |
DatosPersonales
Nombre | Tipo | Descripción |
---|---|---|
fechaNacimiento | String | Fecha de nacimiento de la persona |
paisNacimiento | String | 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 |
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[String] | Lista con los emails de la persona |
telefonos | Lista[String] | Lista con los teléfonos de la persona |
Vinculacion
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 |
empresa | Empresa | Se devuelve la entidad Empresa con los datos básicos. Ver definición en SGI - ESB - SGEMP |
CategoriaProfesional
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) |
SubcategoriaProfesional
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad SubcategoriaProfesional |
nombre | String | 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 |
DatosAcademicos
Nombre | Tipo | Descripción |
---|---|---|
nivelAcademico | NivelAcademico | Se devuelve la entidad NivelAcademico con todos sus campos. |
fechaObtencion | String | Fecha obtención del nivel académico. |
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) |
codigoFecyt | String | Código en la norma Fecyt que se corresponde con el nivel académico del SGI |
Colectivo
Nombre | Tipo | Descripción |
---|---|---|
id | String | Identificador de la entidad Colectivo |
nombre | String | Nombre del colectivo (Posibles valores: PAS, PSI, Alumnos, Becarios, Externo) |
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 |
Servicios
Método | URL | Parámetros | Respuesta | Permisos | Descripción |
---|---|---|---|---|---|
GET | /personas | q+s (query + sort) La query estará formada por:
| 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. | |
GET | /personas/{personaRef} | personaRef | Persona | Detalle de los datos generales de una persona | |
GET | /personas/formly/create | Formly | 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 | ||
POST | /personas | JSON | Recibe como parámetro la respuesta del usuario del formulario de datos básicos (formly) con los campos necesarios para crear una persona | ||
GET | /datos-personales/persona/{personaRef} | personaRef | DatosPersonales | Detalle de los datos personales de una persona (datos de dirección, nacimiento, etc) | |
GET | /datos-personales/formly/create | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona, pestaña "Datos personales". Ver IU-ESB-0010-003 - Solicitar alta de persona | ||
POST | /datos-personales | JSON | Recibe como parámetro la respuesta del usuario del formulario de datos personales (formly) con los campos necesarios para crear la entidad de datos personales de una persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto) | ||
GET | /datos-contacto/persona/{personaRef} | personaRef | DatosContacto | Contiene la lista de email y/o de teléfonos de una persona | |
GET | /datos-contacto/formly/create | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona, pestaña "Datos contacto". Ver IU-ESB-0010-003 - Solicitar alta de persona | ||
POST | /datos-contacto | JSON | Recibe como parámetro la respuesta del usuario del formulario de datos contacto (formly) con los campos necesarios para crear los datos de contacto de una persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto) | ||
GET | /vinculaciones/persona/{personaRef} | personaRef | Vinculacion | Detalle de los datos de vinculación de una persona | |
GET | /vinculaciones/formly/create | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona, pestaña "Datos vinculación". Ver IU-ESB-0010-003 - Solicitar alta de persona | ||
POST | /vinculaciones | JSON | Recibe como parámetro la respuesta del usuario del formulario de vinculación (formly) con los campos necesarios para crear la vinculación de la universidad de la persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto) | ||
GET | /datos-academicos/persona/{personaRef} | personaRef | DatosContacto | Contiene el nivel académico de la persona | |
GET | /datos-academicos/formly/create | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta persona, pestaña "Datos académicos". Ver IU-ESB-0010-003 - Solicitar alta de persona | ||
POST | /datos-academicos | JSON | Recibe como parámetro la respuesta del usuario del formulario de datos académicos (formly) con los campos necesarios para crear los datos académicos de una persona. En el formulario se deben de incluir el campo personaRef para saber de quien se trata (campo oculto) | ||
GET | /colectivos | Lista[Colectivo] | Listado de colectivos ordenados alfabéticamente de forma ascendente | ||
GET | /tipo-documentos | Lista[TipoDocumento] | Listado de tipos de documento de identificación personal ordenados alfabéticamente de forma ascendente | ||
GET | /categoria-profesionales | Lista[CategoriaProfesional] | Listado de categorías profesionales ordenados alfabéticamente de forma ascendente | ||
GET | /subcategoria-profesionales/{categoriaId} | categoriaId | Lista[SubcateroriaProfesional] | Listado de subcategorías profesionales vinculadas a la categoría pasado por parámetro ordenados alfabéticamente de forma ascendente | |
GET | /nivel-academicos | Lista[NivelAcademico] | Listado de niveles académicos ordenados alfabéticamente de forma ascendente | ||
GET | /personas/{personaRef}/fotografia | Fotografia | Detalle de la fotografía digital de la persona |