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:

codigo
nombre
activo
fechaInicio
fechaFin

Lista[Grupo]

Listado de los Grupo según los parámetros de consulta

Por ejemplo, para obtener los grupos activos, excluyendo los "FP00", se utilizarán los siguiente parámetros en la llamada al servicio

Ejemplo:

nombre=nk="FP00-";activo==1;codigo=nk="FP00-";fechaInicio=le="2023-11-16T00:00:00Z";(fechaFin=gt="2023-11-16T00:00:00Z",fechaFin=na='')

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

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

grupos-personas.csv	Objetos SGI
grupo_id	GrupoEquipo.grupoId
persona_id	GrupoEquipo.personaRef
rol	Según GrupoEquipo.rol. RESPONSABLE,COLABORADOR,MIEMBRO Preguntar a JUANA y PEPE PALMA
fecha_inicio	GrupoEquipo.fechaInicio
fecha_fin	GrupoEquipo.fechaFin

Entidades (entidades.csv)

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

Sistema de gestión de empresas - Hércules - Confluence (um.es)

Servicios

Método	URL	Parámetros	Respuesta	Descripción
GET	/empresas/{id}	id	Empresa	Detalle de los datos generales de una empresa.
GET	/datos-contacto/empresa/{id}	id	DatosContacto	Contiene los datos de contacto de una empresa.

Definición de los objetos

DatosContacto

Nombre	Tipo	Descripción
paisContacto	Pais	Se devuelve la entidad Pais con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO).
comAutonomaContacto	ComunidadAutonoma	Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO).
provinciaContacto	Provincia	Se devuelve la entidad Provincia con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO).
ciudadContacto	String	Ciudad de contacto de la empresa.
codigoPostal	String	Código postal de la empresa.
tipoVia	TipoVia	Tipo de vía de la dirección de contacto de la empersa. Se devuelve la entidad TipoVia con todos sus campos. Ver definición en Sistema Gestión de Organizaciones (UM - SGI - ESB - SGO).
nombreVia	String	Nombre de la vía de la dirección de contacto de la empresa.
numero	String	Número de la vía de la dirección de contacto de la empresa.
ampliacion	String	Campo para ampliar la informaicón de la dirección de contacto de la empresa.
email	String	Email de contacto de la empresa.
fax	String	Fax de contacto de la empresa.
telefono	String	Teléfono de contacto de la empresa.
direccionWeb	String	Dirección web de la empresa.

DatosContacto

{
    "paisContacto": {
       "id":"33",
       "nombre":"España"
     },
    "comAutonomaContacto": {
       "id":"ca-3",
       "nombre":"Asturias"
     },
    "provinciaContacto": {
       "id":"pro-1",
       "nombre":"Asturias"
     },
    "ciudadContacto": "Oviedo",
    "codigoPostal": "33002",
    "tipoVia": {
       "id":"tv-1",
       "nombre":"Calle"
     },
    "nombreVia": "Uría",
    "numero": "4",
    "ampliacion": "puerta A",
    "email": "email@empresadeprueba.es",
    "fax": "985798765",
    "telefono": "985798766",
    "direccionWeb": "www.empresadeprueba.es"
}

Empresa

Nombre	Tipo	Descripción
id	String	Identificador de la empresa.
nombre	String	Nombre de la empresa. Se devolverá lo mismo que en el campo "razonSocial".
razonSocial	String	Razón social de la empresa. Se devolverá lo mismo que en el campo "nombre".
tipoIdentificador	TipoIdentificador	Tipo de identificador fiscal de la empresa. Se devuelve la entidad TipoIdentificador con todos sus campos.
numeroIdentificacion	String	Número de identificación fiscal de la empresa del tipo indicado en "tipoIdentificador".
datosEconomicos	Boolean	Indicador de si se trata de una empresa con datos económicos (está dada de alta en GENTE y en JUSTO) o sin datos económicos (está dada de alta solo en GENTE).
padreId	String	Identificador de la empresa padre o entidad principal. Estará informado en el caso de empresas que son subentidad de otra.

Empresa

{
    "id": "000555",
    "nombre": "EMPRESA MIXTA DE AGUAS DE STA. CRUZ DE TENERIFE, S.A. [EMMASA]",
    "razonSocial": "EMPRESA MIXTA DE AGUAS DE STA. CRUZ DE TENERIFE, S.A. [EMMASA]",
    "tipoIdentificador": {
        "id": "1",
        "nombre": "CIF PERSONAS JURIDICAS: ESPAÑOLAS"
    },
    "numeroIdentificacion": "A38000055",
    "datosEconomicos": true,
    "padreId": null
}

Correspondencias

entidades.csv	Objetos SGI
id	Empresa.id
nombre	Empresa.nombre
nif	Empresa.numeroIdentificacion
url	DatosContacto.direccionWeb
region	DatosContacto.provinciaContacto.nombre
ciudad	DatosContacto.ciudadContacto
codigo_postal	DatosContacto.codigoPostal
ambito
pais	DatosContacto.paisContacto.nombre
caracter

Á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

Correspondencias

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

Servicios

Definición de los objetos

GrupoEquipo

Correspondencias

Entidades (entidades.csv)

Servicios

Definición de los objetos

DatosContacto

Empresa

Correspondencias