Introducción

Se describe en esta página la integración entre el SGI Hercules y Dialnet.

Personas (personas.csv)

La documentación completa se encuentra en el siguiente enlace:

Sistema de gestión de personas

Servicios

Método

URL

Parámetros

Respuesta

Permisos

Descripción

GET

/personas/{id}

id

Persona

Detalle de los datos generales de una persona (este la persona activo o no)

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

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

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

Persona

{
    "id": "ent-002",
    "nombre": "Prueba",
    "apellidos": "Apellido1 Apellido2",
    "sexo": {
          "id":"sex-1",
          "nombre":"Mujer"
     },
    "numeroIdentificacion": "11111111H",
    "tipoDocumento": {
            "id":"tp-1",
            "nombre": "NIF"
     },
     "empresaRef: "ent-002",
     "personalPropio": true,
     "entidadPropiaRef" : "ent-UM-001",
  	 "emails":[{
         email: "prueba@prueba.es",
         principal: true
        },
        {
         email: "prueba2@prueba.es",
         principal: false
        }
     ]
     "activo": 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

DatosPersonales

{
    "fechaNacimiento": "2000-02-10",
    "paisNacimiento": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaNacimiento": {
       "id":"ca-1",
       "nombre":"Andalucía"
     }, 
    "ciudadNacimiento": "Sevilla"
    
}

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.

Vinculacion

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

Correspondencias

personas.csv	Objetos SGI
persona_id	Persona.id
nif	Persona.numeroIdentificacion
email	Persona.emails.email donde principal = true
nombre	Persona.nombre
apellido1	Persona.apellidos
apellido2	Persona.apellidos
area_id	DatosVinculacion.areaConocimiento.id
genero	Persona.sexo.nombre
fecha_nacimiento	DatosPersonales.fechaNacimiento
rol	Si Persona.activo = true entonces INVESTIGADOR_ACTUAL en otro caso INVESTIGADOR_EXTERNO

Unidades (unidades.csv)

La documentación completa se encuentra en el siguiente enlace:

Sistema de la gestión de la estructura orgánica - Hércules - Confluence (um.es)

Servicios

Método	URL	Parámetros	Respuesta	Permisos	Descripción
GET	/centros		Lista[Centro]		Listado de centros.
GET	/departamentos		Lista[Departamento]		Listado de departamentos.

Definición de los objetos

Centro

Nombre	Tipo	Descripción
id	String	Identificador de la entidad Centro.
nombre	String	Nombre del centro.

Centro

{
    "id":"cen-1",
    "nombre":"Centro 1 de la Universidad de Murcia"
}

Departamento

Nombre	Tipo	Descripción
id	String	Identificador del departamento.
nombre	String	Nombre del departamento.

Departamento

{
    "id":"dpt-1",
    "nombre":"Departamento Ciencias de la teconología"
}

Correspondencias

unidades.csv	Objetos SGI
id	Centro.id o Departamento.id
nombre	Centro.nombre o Departamento.nombre
tipo_id	CENTROS_ACADEMICOS o DEPARTAMENTO

Grupos de investigación (grupos.csv)

La documentación completa se encuentra en el siguiente enlace:

SGI - Grupos de investigación - Hércules - Confluence (um.es)

Servicios

Método

URL

Parámetros

Respuesta

Descripción

GET

/grupos

q+s

La query estará formada por:

fechaModificacion

Lista[Long]

Listado de Identificadores de Grupo que han sido modificados en los datos generales (tabla Grupo), en el equipo (tabla GrupoEquipo) o en las palabras claves (tabla GrupoPalabraClave)

Se utilizarán los siguiente parámetros en la llamada al servicio

fechaModificacion: se le pasará la fecha a partir de la cual se quieren ver los cambios

Ejemplo:

fechaModificacion=ge="2021-08-18T22:00:00Z"

GET

/grupos/{id}

Grupo

Datos generales de un Grupo

GET

/grupos/{id}/palabrasclave

Lista[GrupoPalabraClave]

Listado de palabras clave de un Grupo

Definición de los objetos

Grupo

Nombre	Tipo	Descripción
id	Long	Identificador del grupo.
nombre	String	Nombre del grupo.
fechaInicio	String	Fecha de inicio del grupo.
fechaFin	String	Fecha de finalización del grupo.
proyectoSgeRef	String	Identificador del proyecto económico asociado en el sistema de gestión económico.
solicitudId	Long	Identificador de la solicitud de convocatoria que originó el grupo.
codigo	String	Código del grupo.
tipo	String	Tipo del grupo. Posibles valores: EMERGENTE CONSOLIDADO PRECOMPETITIVO ALTO_RENDIMIENTO
especialInvestigación	Boolean	Indica si el grupo es un grupo especial de investigación o no.
activo	Boolean	Indica si esta activo o no. En caso de no estar activo se considera como un grupo eliminado del sistema. Se realizan borrados lógicos por si el gestor o administrador desean recuperar un grupo eliminado.

Grupo

{
    "id": 1,
    "nombre": "ZOOLOGIA BASICA Y APLICADA",
    "fechaInicio": "2002-01-01T00:00:00Z",
    "fechaFin": "2009-12-31T00:00:00Z",
    "proyectoSgeRef": null,
    "solicitudId": null,
    "codigo": "E0A0-01",
    "tipo": null,
    "especialInvestigacion": false,
    "activo": true
}

GrupoPalabraClave

Nombre	Tipo	Descripción
id	Long	Identificador de la entidad grupo palabra clave.
palabraClaveRef	String	Palabra o conjunto de palabras clave definido en el grupo

GrupoPalabraClave

[
    {
        "id": 1,
        "palabraClaveRef": "AGROECOSISTEMAS"
    },
    {
        "id": 2,
        "palabraClaveRef": "BIOLOGÍA ANIMAL"
    }
]

Servicios

select * from grupo
where activo = 1
and nombre not like 'FP00%'
and codigo not like 'FP00%'
and (sysdate between fecha_inicio and fecha_fin or fecha_fin is null)

Correspondencias

grupos.csv	Objetos SGI
id	Grupo.id
nombre	Grupo.nombre
nombre_en
constitucion	Grupo.fechaInicio
direccion_postal
palabras_clave	GrupoPalabraClave.palabraClaveRef
lineas_investigacion

Miembros del Grupo de investigación (grupos-personas.csv)

La documentación completa se encuentra en el siguiente enlace:

SGI - Grupos de investigación - Hércules - Confluence (um.es)

Servicios

Método	URL	Parámetros	Respuesta	Descripción
GET	/grupos/{id}/miembrosequipo		Lista[GrupoEquipo]	Listado de miembros del equipo de un Grupo

Definición de los objetos

GrupoEquipo

Nombre	Tipo	Descripción
id	Long	Identificador de la entidad grupo equipo.
grupoId	Long	Identificador del grupo.
personaRef	String	Identificador o Referencia de la persona miembro del equipo de grupo. Es el identificador de la persona en el sistema de personas de la Universidad.
rol	RolProyecto	Entidad que representa el rol. Son los roles que puede tener el equipo de grupo. Ejemplos: Investigador/a principal Co-Investigador/a PrincipalColaborador Asesor científico Colaborador E.I.
fechaInicio	String	Fecha de inicio para la participación del miembro del equipo de grupo con el rol seleccionado.
fechaFin	String	Fecha de inicio para la participación del miembro del equipo de grupo con el rol seleccionado.
dedicacion	String	Dedicación del miembro del equipo de grupo. Posibles valores: PARCIAL COMPLETA
participacion	Numérico	Porcentaje de dedicación al grupo.

GrupoEquipo

[
    {
        "id": 1,
        "personaRef": "12345678",
        "fechaInicio": "2009-12-02T00:00:00Z",
        "fechaFin": "2009-12-31T00:00:00Z",
        "rol": {
            "id": 8,
            "abreviatura": "COLEI",
            "nombre": "Colaborador E.I.",
            "rolPrincipal": false,
            "orden": null,
            "equipo": "INVESTIGACION",
            "activo": true
        },
        "dedicacion": "COMPLETA",
        "participacion": 100,
        "grupoId": 1
    }
}

Correspondencias

GRUPO_ID,PERSONA_ID,ROL,FECHA_INICIO,FECHA_FIN

grupos-personas.csv	Objetos SGI
grupo_id	GrupoEquipo.grupoId
persona_id	GrupoEquipo.personaRef
rol	GrupoEquipo.rol.xx 'RESPONSABLE','RESPONSABLE','COL','COLABORADOR', 'MIEMBRO') ROL,
fecha_inicio	GrupoEquipo.fechaInicio
fecha_fin	GrupoEquipo.fechaFin

Árbol de páginas

Integración SGI-DIALNET

Introducción

Personas (personas.csv)

Servicios

Definición de los objetos

Persona

DatosPersonales

Vinculacion

Correspondencias

Unidades (unidades.csv)

Servicios

Definición de los objetos

Centro

Departamento

Correspondencias

Grupos de investigación (grupos.csv)

Servicios

Definición de los objetos

Grupo

GrupoPalabraClave

Servicios

Correspondencias

Miembros del Grupo de investigación (grupos-personas.csv)

Servicios

Definición de los objetos

GrupoEquipo

Correspondencias