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, emil, 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).
Email	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.
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. (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

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.

Persona

{
    "id": "ent-002",
    "nombre": "Prueba",
    "apellidos": "Apellido1 Apellido2",
    "sexo": {
          "id":"sex-1",
          "nombre":"Mujer"
     },
    "numeroIdentificacion": "11111111H",
    "tipoDocumento": {
            "id":"tp-1",
            "nombre": "NIF"
       }
}

Sexo

Nombre	Tipo	Descripción
id	String	Identificador de la entidad Sexo.
nombre	String	Nombre (Posibles valores: Mujer, Hombre).

Sexo

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

TipoDocumento

{ 
    "id":"tp-1",
    "nombre": "NIF"   
}

DatosPersonales

Nombre	Tipo	Descripción
fechaNacimiento	String	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.

DatosPersonales

{
    "fechaNacimiento": "2000-02-10",
    "paisNacimiento": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaNacimiento": {
       "id":"ca-1",
       "nombre":"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.
comAuntonomaContacto	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 email de la persona.
telefonos	Lista[String]	Lista con los teléfonos de la persona.

DatosContacto

{
    "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":["prueba@prueba.es","prueba2@prueba.es"],
    "telefonos":["985112233","699445566"]  		
}

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.
empresaRef	String	Se devuelve el identificador/referencia de la entidad Empresa.

Vinculacion

{
    "categoriaProfesional":{
       "id":"catp-1",
       "nombre":"PDI Numerario"
     },
    "fechaObtencionCategoria":"2020-03-15",
    "subcategoriaProfesional": {
       "id":"cupro-1",
       "nombre":"Profesor"
     },
    "departamento": {
       "id":"dpt-1",
       "nombre":"Departamento Ciencias de la tecnología"
     },
    "areaConocimiento": {
       "id":"ac-1",
       "nombre":"Área de conocimiento A"
     },
    "empresaRef": "emp-1"
}

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.

CategoriaProfesional

{
   "id":"catp-1",
   "nombre":"PDI Numerario"
}

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

SubcategoriaProfesional

{ 
   "id":"cupro-1",
   "nombre":"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.

DatosAcademicos

{
    "nivelAcademico": {
       "id":"1",
       "nombre":"Doctorado"
     },
     "fechaObtencion":"2000-02-10"
}

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

NivelAcademico

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

Colectivo

{
    "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.

Fotografia

{
    "contenido":"DDfgdfgdfj46gd6f5gdfgdf=",
    "mimeType":"image/jpeg"
}

Servicios

Método	URL	Parámetros	Respuesta	Descripción
GET	/personas	q+s (query + sort) La query estará formada por: id colectivoId nombre apellidos numeroDocumento fechaModificacion	Lista[Persona]	Listado de Persona. Ejemplo: colectivoId=in=(refPAS,refPDI);(nombre=like=11111111H,apellidos=like=11111111H,numeroDocumento=like=11111111H) NOTA: Este método tendrá que ser capaz de responder con una lista de las personas modificadas con posterioridad a la fecha/hora proporcionada en el parámetro fechaModificacion. La modificación debe incluir altas, actualizaciones y borrados lógicos.
GET	/personas/{id}	id	Persona	Detalle de los datos generales de una 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/{id}	id	DatosPersonales	Detalle de los datos personales de una persona (datos de dirección, nacimiento, etc).
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 id de Persona para saber de quién se trata (campo oculto).

GET	/datos-contacto/persona/{id}	id	DatosContacto	Contiene la lista de emails y/o de teléfonos de una 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 id de Persona para saber de quién se trata (campo oculto).

GET	/vinculaciones/persona/{id}	id	Vinculacion	Detalle de los datos de vinculación de una 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 id de Persona para saber de quién se trata (campo oculto).

GET	/datos-academicos/persona/{id}	id	DatosContacto	Contiene el nivel académico de la 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 id de Persona para saber de quién se trata (campo oculto).

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}/subcategorias-profesionales	id	Lista[SubcateroriaProfesional]	Listado de subcategorías profesionales vinculadas a la categoría pasada por parámetro ordenadas alfabéticamente de forma ascendente.

GET	/niveles-academicos		Lista[NivelAcademico]	Listado de niveles académicos ordenados alfabéticamente de forma ascendente.

GET	/personas/{id}/fotografia	id	Fotografia	Detalle de la fotografía digital de la persona.

Árbol de páginas

UM - SGI - ESB - SGP