Definición y objetivos
El ESB proporcionará el interface de integración para que desde el SGI se solicite a los sistemas de gestión de empresas universitarios el alta de aquellas empresas que se quieran vincular con la Universidad a través de una vía por la que actualmente no lo estén o que directamente no estaban previamente vinculadas con la Universidad. A través del formulario correspondiente el SGI recogerá los campos necesarios y/o de interés para la creación de la empresa en el sistema o los sistemas de gestión de empresas de la universidad en la que se esté haciendo la implantación.
Descripción integración
El SGI no dispondrá de un formulario propio para recoger los datos de creación de una empresa sino uno específico por implantación/universidad tal y como se describe en IU-GEN-0081 - Solicitar alta de empresa.
Los parámetros de entrada y salida a la hora de integrarse con los sistemas universitarios para el alta de empresas serán definidos en cada implantación/universidad en particular, puesto que dependen de las necesidades y restricciones tanto de sus usuarios finales como de sus sistemas de gestión de la información de empresas.
Los parámetros de entrada de la integración vendrán determinados por el contenido del formulario de alta específico para una implantación, más las información adicional no visible por pantalla que se pudiese necesitar enviar.
Como salida se tratará de tender a tener una respuesta más estandarizada o común, como un mensaje con el resultado de la operación, por ejemplo, en caso de que se haya podido crear la empresa, que se devuelva un mensaje "Empresa creada correctamente" (o similar) y en caso de fallo en la creación "No se ha podido dar de alta la Empresa en este momento" (o similar).
Diseño técnico
En el siguiente enlace se muestra el diseño del modelo lógico y el diseño de la API del Sistema de Gestión de Empresas y, en concreto, de la relativa a servicios Formly: SGI - ESB - SGEMP - Servicios Formly.
Los servicios concretos del API que cubren este requisito son:
- SGI - ESB - SGEMP - Empresas - Consultar campos alta
- Se ha de llamar en primer lugar para poder pintar por pantalla el formulario de introducción de datos de alta.
- SGI - ESB - SGEMP - Empresas - Dar de alta
- Se llamará una vez el usuario completa los datos del formulario de alta.
Para cada implantación en particular se implementará un API específico o a medida, pero tendiendo a que sea igual o compatible en la medida de lo posible al propio del SGI, para así poder agilizar las integraciones.
El dinamismo o adaptación de los formularios dinámicos de solicitud de alta para las empresas se logrará mediante una definición del interface de comunicación entre el ESB del SGI y las APIs universitarias donde se intercambien mensajes en formato JSON, manteniendo así la firma de los servicios constante aunque el contenido del mensaje pudiese variar.
En el siguiente enlace se muestra el diseño del modelo lógico y el diseño de la API del Sistema de Gestión de Empresas para la implantación específica en la Universidad de Murcia: IU-GEN-0081-UM - Formulario Solicitar alta de empresa.