Árbol de páginas

Versiones comparadas

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

...

EntidadDescripció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:

  • Solicitante ética: personal de investigación que crea las solicitudes de evaluación de proyectos en ética.
  • Evaluador ética: personal de investigación que puede realizar las evaluaciones de las memorias de investigación o bien personal técnico que puede realizar las tareas de evaluación de memorias.
  • Equipo trabajo ética: personal de investigación que puede formar parte del equipo de trabajo de una solicitud de evaluación de ética.
  • Solicitante csp: personal de investigación que puede figurar como solicitante de una ayuda/convocatoria (a pesar de que, por norma general,  los colectivos asociados a este tipo pudieran coincidir con los asociados a los roles de tipo "equipo investigación" de la tabla "rol proyecto", se crea este tipo de colectivo para simplificar la búsqueda en pantallas en las que no es necesario distinguir el rol a la vez que para independizar la configuración de colectivos por si fuera necesario llegado el caso).
  • Responsable económico csp: personal de la Universidad que puede ser el responsable económico de un proyecto y/o de un grupo.
  • Autor de invención: persona física que tiene un porcentaje de autoría de la invención. Puede ser un investigador de la Universidad o externo.
  • Responsable proyecto externo: persona que puede participar como responsable (IP) de un proyecto externo (autorización de participación en proyecto externo). 
  • Autor prc: personal de investigación que alimenta su CVN y que por lo tanto figura como autor de items de producción científica.
  • Destinatario comunicado: personal de la Universidad o de investigación (de la Universidad o externo) que puede ser destinatario de un comunicado enviado por el SGI.
  • Persona autorizada grupo: peronal personal de la Universidad que puede der la persona autorizada de un grupo para realizar la tarea de validar/rechazar items de producción científica y persona autorizadas para la creación de solicitudes de modificación del grupo

Modelo lógico

Image Removed

API

Características generales que todas las API REST deben de cumplir:

Definición de los objetos

Persona

  • .
  • Tutor csp: personal de investigación que puede ser tutor/a de un trabajo postdoctoral, predoctoral, etc, trabajos de solicitudes de RRHH.
  • Miembro Equipo Empresa de Explotación de Resultados: personal de la Universidad que puede participar en una empresa de explotación de resultados como solicitante, parte del equipo emprendedor, de la composición de la sociedad o de la administración de la misma.


Modelo lógico

Image Added

API

Características generales que todas las API REST deben de cumplir:

Definición de los objetos

Persona

NombreTipoDescripción
idStringIdentificador de la persona.
nombreStringNombre de la persona.
apellidosStringApellidos de la persona.
sexoSexoSe devuelve la entidad Sexo
NombreTipoDescripción
idStringIdentificador de la persona.
nombreStringNombre de la persona.
apellidosStringApellidos de la persona.
sexoSexoSe devuelve la entidad Sexo con todos sus campos.
numeroDocumentoStringNúmero de documento de identificación personal.
tipoDocumentoTipoDocumentoSe devuelve la entidad TipoDocumento con todos sus campos.
empresaRefnumeroDocumentoStringNúmero de documento de identificación personal.
tipoDocumentoTipoDocumentoSe devuelve la entidad TipoDocumento con todos sus campos.
empresaRefString

Se devuelve el identificador/referencia de la entidad Empresa.

personalPropioBooleanIndica si es personal de la Universidad o no (a día de hoy).
entidadPropiaRefStringSe 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.
emailsLista[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)
activoBooleanIndica si la persona esta activa o no (a día de hoy).

...

Vinculacion

NombreTipoDescripción
vinculacionCategoriaProfesionalVinculacionCategoriaProfesional

Se devuelve la entidad VinculacionCategoriaProfesional con todos sus campos.

departamentoDepartamento

Se devuelve la entidad Departamento con todos sus campos. Ver definición en SGI - ESB - SGO.

centroCentroSe devuelve la entidad Centro con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO).
areaConocimientoAreaConocimiento

Se devuelve la entidad AreaConocimiento con todos sus campos. Ver definición en SGI - ESB - SGO.

empresaRefString

Se devuelve el identificador/referencia de la entidad Empresa externa que es la relacionada en la actualidad con la persona, la vigente.

personalPropioBooleanIndica si es personal de la Universidad o no (a día de hoy).
entidadPropiaRefStringSe 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
languagejava
themeRDark
titleVinculacion
collapsetrue
{
    "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

NombreTipoDescripción
categoriaProfesionalCategoriaProfesionalCategoría profesional de la persona.
fechaObtencionCategoriaFechaFecha de obtención de categoría profesional de la persona.
Bloque de código
languagejava
themeRDark
titleVinculacionCategoriaProfesional
collapsetrue
{    
	"categoriaProfesional": {
		"id":"catp-1",
   		"nombre":"PDI Numerario"
	},
	"fechaObtencionCategoria" : "2020-03-15"
}

...

NombreTipoDescripción
numeroStringNúmero de sexenios reconocidos
paisRefStringPaís del reconocimiento
personaRefStringIdentificador de la persona que tiene el sexenio
Bloque de código
languagejava
themeRDark
titleSexenio
collapsetrue
{
    "numero":"2",
    "paisRef":"011",
    "personaRef":11111111
 }

...

DireccionTesis


Método
Nombre
URL
Tipo
Parámetros
Descripción
Respuesta
id
Permisos
String
Descripción
Identificador del doctorado
GET
personaRef
/personasFast
  • búsqueda (cadena a buscar en nombre / apellidos / email).
  • colectivoId (uno o varios colectivos sobre los que realizar la búsqueda).

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:

  • id
  • tipoColectivo
  • colectivoId
  • nombre
  • apellidos
  • email
  • nombreApellidos

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}idPersonaDetalle de los datos generales de una persona (este la persona activo o no)POST/personasJSON

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/personasJSONRecibe 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}JSONDevuelve 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/updateFormlyDevuelve el formulario (formly) a pintar para la pantalla de solicitar modificar persona.GET/personas/formly/viewFormlyDevuelve 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}idDatosContactoContiene 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:

  • fechaObtencion
  • fechaFin
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:

q=fechaObtencion<=FECHA;fechaFin>=FECHA,fechaFin=na=
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}idDatosContactoContiene el nivel académico de la persona (independientemente de que este activa o no la persona)GET/colectivosLista[Colectivo]

Listado de colectivos ordenados alfabéticamente de forma ascendente.

GET/tipos-documentoLista[TipoDocumento]Listado de tipos de documento de identificación personal ordenados alfabéticamente de forma ascendente.GET/sexosLista[Sexo]Listado de sexos ordenados alfabéticamente de forma ascendente.GET/categorias-profesionalesLista[CategoriaProfesional]Listado de categorías profesionales ordenadas alfabéticamente de forma ascendente.GET/categorias-profesionales/{id}CategoriaProfesionalDetalle de la categoría profesional cuyo identificador se indica por parámetro.GET/niveles-academicosLista[NivelAcademico]Listado de niveles académicos ordenados alfabéticamente de forma ascendente.GET/niveles-academicos/{id}NivelAcademicoDetalle del nivel académico cuyo identificador se indica por parámetro.GET/personas/{id}/fotografiaidFotografiaDetalle de la fotografía digital de la persona (independientemente de que este activa o no la persona)

Métodos para hacer la integración con Gnoss para el CVN

GET/personas/modificadas-ids

q+s

La query estará formada por:

  • fechaModificacion
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) 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}SexenioDevuelve el número de sexenios de la personaGET/formacion/modificados-ids

q+s

La query estará formada por:

  • fechaModificacion
  • tipoFormacion
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
  • tipoFormacion: se le pasa el tipo de formación que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • fechaModificacion=ge="2021-08-18T22:00:00Z"
  • tipoFormacion="020.010.020.000" (para Doctorados)
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 tipoGET/actividad-docente/modificados-ids

q+s

La query estará formada por:

  • fechaModificacion
  • tipoActividad
Lista[Long]

Listado de identificadores de Actividad docente que han sido modificadas (tanto la entidad Actividad docente 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
  • tipoActividad: se le pasa el tipo de actividad docente que se quiere recuperar, usando los códigos de CVN

Ejemplo:

  • fechaModificacion=ge="2021-08-18T22:00:00Z"
  • tipoFormacion="030.040.000.000" (para direcciones)
GET/actividad-docente/{id}

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 tipoMétodos los que se llama desde los sistemas de la Universidad al SGIPOST/vinculaciones/persona/{id}/vinculaciones-categorias-profesionalesLista[VinculacionCategoriaProfesional]

Comunicación de un cambio en los datos de vinculación de una persona, en concreto, de su categoría profesional bien como PAS bien como PDI o como ambas en los sistemas de la UM.

Ver UM - SGI - ESB - SGP - Adaptaciones integración para su implementación en el SGI.
StringIdentificador de la persona que es el Director de la tesis
tituloTrabajoStringTítulo del trabajo
fechaDefensaFecha

Fecha de obtención del título

Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").

alumnoStringIdentificador en el SGP si existe el alumno y sino nombre y apellidos del alumno.
tipoProyectoTipoTrabajoDirigidoTipo del trabajo dirigido: Otros, Proyecto de fin de carrera, Tesina, Tesis doctoral, Trabajo conducente a la obtención de DEA
calificacionObtenidaString P.e. "Cum laude"
coDirectorTesisRefStringIdentificador del co-director/a que ha intervenido
doctoradoEuropeoBoolIndica si se ha recibido una mención europea
fechaMencionDoctoradoEuropeoFecha

Fecha de la mención del doctorado europeo.

Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").

mencionCalidadBooleanIndica si el dotorado ha recibido una mención de calidad
fechaMencionCalidadFecha

Fecha de la homologación del doctorado extranjero.

Formato de fecha ISO 8601, ajustado a UTC (se debe utilizar el designador UTC especial "Z").

mencionInternacionalBooleanIndica si tiene mención internacional o no
mencionIndustrialBooleanIndica si tiene mención industrial o no

TipoTrabajoDirigido

NombreTipoDescripción
idStringIdentificador del tipo de trabajo-proyecto dirigido (055, 067, 071, 066, OTHERS)
nombreString

Tipo de trabajo dirigido.

Posibles valores:

  • Proyecto de fin de carrera (valor 055)
  • Tesis doctoral (valor 067)
  • Trabajo conducente a la obtención de DEA (valor 071)
  • Tesina (valor 066)
  • Otros (valor OTHERS)

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
SGI - ESB - SGP - Servicios Básicos
SGI - ESB - SGP - Servicios Básicos

Incluir página
SGI - ESB - SGP - Servicios Formly
SGI - ESB - SGP - Servicios Formly

Incluir página
SGI - ESB - SGP - Servicios Pasarela
SGI - ESB - SGP - Servicios Pasarela