Introducción
Bizagi se puede integrar con SAP Cloud Platform mediante un conector listo para usar. Este artículo explica cómo puede configurar el conector de SAP Cloud Platform en un proyecto de Bizagi Studio.
Antes de empezar
Para configurar el conector debe tener configurados los servicios y conexiones en la SAP Cloud Platform. Para más información, consulte Cómo configurar SAP Cloud Platform para sistemas on-premises. A partir de esta configuración, debe obtener la Ruta de la Aplicación dentro del Cloud Foundry.
Bizagi tiene una opción de configuración de Proxy disponible para conectarse con servicios externos como el conector SAP Cloud Platform.
Configuración en Bizagi Studio
Para configurar el conector de SAP Cloud Platform siga estos pasos:
1. Abra la Vista de Experto y seleccione el módulo Sistemas externos. Luego abra el nodo principal de SAP, donde encuentra dos tipos de conectores SAP:
•Conector SAP: sistemas R/3 y ECC que utilizan BAPIs.
•SAP Cloud Platform: conector SAP Cloud que utiliza servicios OData.
Haga clic derecho en el nodo SAP Cloud Platform y seleccione Agregar nueva configuración.
Alternativamente, puede configurar el conector SAP Cloud Platform a través del botón Agregar nueva configuración ubicado en la cinta superior:
2. Al cargar una nueva configuración, se muestra la siguiente forma:
Los datos Xsuaa Url, Xsuaa Client Id y Xsuaa Client Secret son requeridos para la autenticación OAuth2 code grant. Estos pueden localizarse dentro de la Plataforma Tecnológica Empresarial (BTP) en la instancia del servicio xsuaa-dispatcher, como se muestra en las siguientes imágenes:
•El valor del Redirect URI es otra entrada requerida para la autenticación OAuth2 code grant. No se muestra en la forma y por defecto es siempre: https://build.bizagi.com/redirectOauth2.html
•Para poder obtener los destinos, el token debe estar vigente o se debe generar uno nuevo. El botón Obtener destinos se habilita después de la validación del token.
•El token de acceso obtenido tiene una expiración predeterminada de 12 horas. Bizagi valida el tiempo del token y si ha expirado, obtiene un token nuevo automáticamente a través del Refresh token (el cual no expira).
3. Debe llenar todos los datos requeridos y luego hacer clic en el botón de Autorizar:
4. Una vez se han ingresado las credenciales, aparece una ventana indicando que se han aceptado las credenciales de manera exitosa, y se habilita el botón Obtener Destinos.
5. Al hacer clic en el botón Obtener Destinos, se muestra la lista de destinos disponibles:
6. Al hacer clic en Guardar sin modificar ningún campo de entrada de datos (excepto los destinos), se cierra la ventana Configuración SAP Cloud Platform:
7. Para crear las acciones, se usa el token creado en la configuración:
Validaciones
•En la forma Configuración SAP Cloud Platform, todos los campos son requeridos y el contorno de la entrada se muestra en rojo si existe algún error:
•El botón Obtener Destinos es habilitado si se genera un token válido con el botón Autorizar:
•Cuando se edita un campo de entrada después de que se haya autorizado la Configuración SAP Cloud Platform, el botón Guardar se deshabilita. Para habilitarlo es necesario autorizar y obtener los destinos nuevamente.
•Si se edita una conexión de SAP Cloud Platform después de 12 horas, es posible que el token haya expirado. Aparece un mensaje de error como el siguiente:
Por lo tanto, debe autenticarse nuevamente.
Management Console on-premises
Es posible editar la configuración de SAP Cloud Platform desde la Management Console con los siguientes campos de entrada, para que el usuario pueda actualizar la información requerida para la autenticación OAuth2 code grant:
•Xsuaa Url.
•Xsuaa Client Id.
•Xsuaa Client Secret.
Casos de uso en Bizagi Studio
1.Ingrese a la configuración del conector SAP Cloud Platform que desea editar.
2.Defina la configuración correcta para habilitar el botón Guardar.
Definir las acciones de SAP disponibles para los procesos de Bizagi
Su sistema SAP puede exponer varios endpoints de OData. Cada endpoint puede contener múltiples acciones que puede definir en su conector y los procesos de Bizagi pueden invocar. Para hacerlo, haga clic derecho en el nombre de su configuración de SAP y seleccione Agregar nuevas acciones.
Bizagi muestra los endpoints disponibles a través de la capa OData de su sistema SAP. Cada endpoint contiene conjuntos de entidades, las cuales tienen acciones que puede usar en sus procesos de Bizagi. Puede buscar endpoints utilizando el cuadro de texto del filtro.
Abra el endpoint para ver los diferentes conjuntos de entidades. Puede seleccionar cada conjunto de entidades haciendo clic en la casilla de verificación USERSERVICE.
Si desea sacar un servicio de la lista, puede hacer clic en el icono X junto al nombre de cada servicio. Después de revisar todos los servicios, haga clic en Siguiente.
|
Si hay un error al mostrar los servicios después de seleccionarlos, es posible que el servicio esté expuesto como metadata pero el conjunto de entidades no esté disponible. |
Configurar acciones
SAP expone acciones dentro de conjuntos de entidades. Un conjunto de entidades puede tener diferentes acciones HTTP que puede habilitar. Cada conjunto de entidades es configurable en los siguientes aspectos:
•Cambiar el nombre del conjunto de entidades
•Duplicar un conjunto de entidades
•Eliminar conjuntos de entidades duplicados
•Definir el tipo de acción y los atributos
Cambiar el nombre del conjunto de entidades
Al hacer clic en el icono de lápiz, puede editar el nombre del conjunto de entidades. Este nombre se muestra cuando configura una acción en un proceso.
Luego de cambiar el nombre, haga clic en el icono de verificación para guardarlo.
Duplicar un conjunto de entidades
En la lista de conjunto de entidades ubicada a la izquierda, puede ver el icono de duplicado junto a cada conjunto de entidades. Cuando hace clic en este icono, todas las acciones configuradas en ese conjunto de entidades se duplican.
Eliminar conjuntos de entidades duplicados
Junto a un conjunto de entidades duplicadas, puede ver el icono de eliminación. Haga clic en este icono para eliminar el conjunto de entidades duplicadas.
Puede deshacer la eliminación en el cuadro de mensaje ubicado en la esquina inferior derecha.
Definir el tipo de acción y los atributos
De manera similar a las solicitudes HTTP, cada acción tiene un conjunto de posibles tipos de ejecución que permiten consultar, actualizar o eliminar registros asociados con el conjunto de entidades. Por ejemplo, puede consultar (GET) la información de los usuarios de SAP.
Bizagi permite usar los siguientes tipos de acciones:
•OBTENER (GET)
•OBTENER TODOS (GET ALL)
•CREAR (CREATE)
•ACTUALIZAR (UPDATE)
•ELIMINAR (DELETE)
Cuando hace clic en cada acción, Bizagi muestra todos los tipos de acción disponibles para ese conjunto de entidades. Puede seleccionar UNO de los tipos de acción disponibles. Si desea diferentes tipos de acciones relacionadas con el mismo conjunto de entidades, puede duplicarlo.
|
Un tipo de acción se puede deshabilitar debido a las restricciones de SAP Cloud Platform. Los tipos de acción deshabilitados se muestran en gris.
|
Cuando hace clic en cada tipo de acción (por ejemplo, OBTENER), Bizagi muestra dos listas de atributos. Estas listas son atributos que se pueden obtener en la invocación de una acción.
1. Atributos opcionales: Estos atributos pueden ser agregados por el usuario de Bizagi configurando la acción. Se pueden agregar o eliminar en la fase de configuración.
2. Atributos fijos: Bizagi muestra estos atributos como de solo lectura, mostrando el nombre y tipo de cada atributo.
Puede agregar atributos opcionales haciendo clic en el símbolo de adición + junto al nombre del atributo. Cuando se agregan, Bizagi los muestra al final de la lista de atributos. Puede eliminar el atributo con el icono de eliminar a la derecha.
|
Puede agregar o eliminar atributos opcionales. Otros atributos se muestran como de solo lectura. |
Los atributos opcionales suelen ser un objeto que contiene atributos individuales. Cuando hace clic en el hipervínculo de atributo opcional, Bizagi muestra la lista de atributos individuales contenidos.
Cuando termine de definir los atributos opcionales para cada tipo de acción, haga clic en Finalizar.
Siguientes pasos
Definir el proceso de Bizagi donde quiere ejecutar una acción SAP