Integración con G5/G6

1. Vaya al menú senior X Platform > senior X > BPM > Configuración > Fuentes de datos con un usuario administrador y haga clic enAgregar;
2. Selecciona elFormato deseado (JSON o Tabla);
3. Informale aNombre del DataSource, que se mostrará en BPM al crear un proceso;
4. Informale aURL del servicio web que devolverá los datos a la fuente de datos. Ejemplo: http://<servidorG5>:<Puerta>/SXI/Consulta genérica?consultar=wf_formacao_list. Los parámetros que pueden componer esta URL son:
   • ServidorG5: debe ser reemplazada por la dirección del servidor glassfish donde se instaló la API y están disponibles los webservices G5, es importante estar expuesto en internet para acceso externo;
   • servidor: debe ser reemplazada por la dirección del servidor glassfish donde están disponibles los servicios web G5, si es la misma que la API SXI, puede usar localhost;
   • módulo: nombre del módulo donde se encuentra el servicio web personalizado;
   • Servicio : nombre del servicio web personalizado;
   • Puerto: puerto de servicio web personalizado;
   • DEPURAR: cuando se establece en 'verdadero', ayuda a diagnosticar problemas de integración de servicios web, los mensajes de registro se agregarán al registro de glassfish.
5. EnServidorG5 yPuerta, debe ser reemplazada por la dirección del servidor GlassFish donde se instaló la API y están disponibles los servicios web de G5. Es importante estar expuesto en internet para acceso externo;
6. Enconsultar, ingrese el nombre de la consulta que desea devolver desde el G5.
7. Los campos son los retornos de la consulta. Ingrese el nombre, una descripción para el campo y el tipo. Ejemplo: Nombre codcuf, Descripción Código, Tipo Entero.
8. Para terminar, haga clic enAhorrar.

veaaquí la lista completa de consultas. También puede definir sus propias consultas cambiando el archivo consults.json en la carpeta API dentro de GlassFish (Ejemplo: “…\glassfish40\glassfish\domains\domain1\applications\SXI-API\consults.json”).

Vaya al menú senior X Platform > senior X > BPM > Configuración > Fuentes de datos con un usuario administrador y haga clic enAgregar. Seleccione el formato JSON para la llamada de servicios web. Informale aNombre de DataSource, que se mostrará en BPM al crear un proceso, e informar alURL del servicio web personalizado en el G5. Ejemplo: http://ServerG5/SXI/G5Rest?server=ServerG5&module=rubi&service=com.senior._wf_utilscust&port=getCollaboradorCust&DATASOURCEATTRNAME=collaborators.

Considere los siguientes campos:

• ServidorG5: debe reemplazarse por la dirección del servidor GlassFish donde se instaló la API y están disponibles los servicios web de G5. Es importante estar expuesto en internet para acceso externo;
• servidor: debe ser reemplazada por la dirección del servidor GlassFish donde están disponibles los servicios web G5, si es la misma que la API SXI, puede usar localhost;
• módulo: se informará el nombre del módulo donde se encuentra el webservice personalizado;
• Servicio: se informará el nombre del webservice personalizado;
• Puerto: se informará el puerto del servicio web personalizado;
• NOMBRE DE ORIGEN DE DATOS: se informará el objeto raíz que devolverá los elementos de la fuente de datos, será el mismo que se informó en el registro de la fuente de datos;
• DEPURAR: cuando se establece en verdadero, ayuda a diagnosticar problemas de integración de servicios web, los mensajes de registro se agregarán al registro de GlassFish;
• objeto raíz: se indicará el parámetro JSON que devolverá los elementos de la fuente de datos;
• Lista de campo: se muestran los resultados de la consulta. Es importante que los nombres de los campos tengan el mismo nombre que la declaración del servicio.

Para probar la devolución del servicio web personalizado, se recomienda utilizar Postman u otra herramienta similar. Por lo tanto, es posible diagnosticar problemas de integración, validar el nombre del campo y el formato de integración.

Con un DataSource correctamente configurado, cree un proceso que haga uso de él.

1. Acceda al menú senior X Platform > senior X > BPM > Editor de Procesos;
2. clickea enNuevo proceso;
3. seleccionar modeloEn blanco;
4. Informale aNombre yDescripción del procesoy haga clic enAgregue campo;
5. Introduce una etiqueta y accede a la pestañaavanzado;
6. Seleccionar opciónCampo Fuente de datos y el tipo Consulta;
7. introducir elNombre de la fuente de datos y lacampo de la misma;
8. clickea enAplicar;
9. clickea enCaudal y agregue 2 pasos de su elección;
10. clickea enAhorrar, luego enPublicar.

Para ver el resultado, vaya a senior X Platform > senior X > BPM > Nueva solicitud, seleccione el proceso creado anteriormente y realice una búsqueda en el campo creado. Los datos presentados se devuelven desde el servicio configurado en el DataSource.

Para aplicar filtros en la integración, primero tenemos que configurar DataSource para admitir el paso de filtros:

1. Acceda al menú senior X Platform > senior X > BPM > Fuentes de datos;
2. Seleccione el DataSource deseado, para este ejemplo use Cidades;
3. Marque la opción Soporte de filtro de implementos de servicio;
4. Haga clic en Guardar.

Ahora, cree un proceso usando DataSource y aplicando un filtro:

1. Acceda al menú senior X Platform > senior X > BPM > Editor de Procesos;
2. clickea enNuevo proceso y seleccione el modeloEn blanco;
3. selecciona elNombre yDescripción del proceso;
4. clickea enAgregue campo;
5. Ingrese la etiqueta del estado y la descripción del estado y haga clic enAplicar;

Y finalmente, agregue un nuevo campo usando el campo de estado:

1. clickea enAgregue campo;
2. Ingrese la etiqueta de la ciudad y la descripción de la ciudad;
3. acceder a la guíaavanzado y marque la opciónCampo Fuente de datos;
4. Seleccione la fuente de datos Ciudades, el campo nomcid y haga clic enAgregar;
5. En la línea creada, ingrese enFiltrar por campo estcid y elValor ${estado};
6. clickea enAplicar;
7. acceder a la guíaCaudal y definir cualquier flujo para probar el filtro en la ejecución de un proceso;
8. Clickea enAhorrar es enPublicar.

Para ver el funcionamiento del filtro, vaya a senior X Platform > BPM > Process editor, haga clic en el proceso Cities.