Cómo reutilizar la automatización de activación de API en todos sus proyectos

En mi última publicación de blog «Cómo desencadenar procesos a partir de una automatización», le mostré cómo crear la automatización que desencadenará el flujo de trabajo de SBPA. Ahora, le mostraré cómo convertir esta automatización en una solución genérica que puede reutilizarse en sus proyectos y compartirse con otros desarrolladores/constructores ciudadanos en su inquilino.

Creación de automatización reutilizable genérica

Cree un nuevo proyecto (o si siguió la última publicación del blog y creó un proyecto, puede duplicarlo y eliminar lo que no sea necesario). En nuestro proyecto con automatización genérica necesitaremos solo partes del proyecto anterior. Dejaremos de lado el tipo de datos de contexto (que es específico para cada flujo de trabajo) y crearemos nuevas entradas para nuestra automatización.

El tipo de datos «Activador de API de WF» es el mismo que se describe en la publicación de blog anterior.

FIGURA 1: Tipo de datos (haga clic en la imagen para ampliarla)

Dado que nuestro objetivo es crear una automatización genérica, declararemos todos los elementos que dependen del flujo de trabajo (URL de definición de flujo de trabajo y contexto) como entradas.

FIGURA 2: Declaración de entradas (haga clic para ampliar)

En lugar de declarar nuestro tipo de datos con valores codificados, usaremos variables de entorno para poder declarar valores durante la implementación. Tenga en cuenta que este enfoque funcionará en un escenario típico en el que tiene un inquilino SBPA para todos sus proyectos. Si necesita activar flujos de trabajo desde cualquier arrendatario, consulte la subsección «Modificación opcional» al final de esta publicación de blog.

FIGURA 3: Creación de variables de entorno (click para ampliar)

Asegúrese de que su tipo de datos no tenga valores codificados. Estamos utilizando 4 variables de entorno y el ID de definición (URL de flujo de trabajo) de la variable de entrada.

FIGURA 4: Declare el tipo de datos y establezca los valores (haga clic para ampliar)

El script personalizado y la actividad «Llamar al servicio web» son completamente iguales, por lo que puede dejarlos como están (consulte la publicación anterior del blog para obtener más detalles).

Ahora terminamos nuestro proyecto genérico. Guárdalo. Debemos publicar y desplegar nuestro proyecto para poder agregarlo a la biblioteca y reutilizarlo.

FIGURA 5: Implementación de un proyecto (haga clic para ampliar)

Asegúrese de ingresar los valores adecuados para las 4 variables de tiempo de ejecución (variables de entorno) en el paso de implementación #2.

Después de una implementación exitosa, cierre su proyecto y regrese a SAP Build Lobby. Verá que su proyecto está implementado y ahora verá la acción «Publicar en la biblioteca».

FIGURA 6: Publicar en la biblioteca (haga clic para ampliar)

Seleccione la versión que desea publicar y deje en blanco las etiquetas de línea de negocio y producto.
Su proyecto ahora está publicado y disponible para su reutilización en cada proyecto por parte de cualquier constructor/desarrollador en su arrendatario.

Usando nuestra automatización genérica

Ahora vamos a crear nuestro proyecto de automatización regular y cambiemos la vista a las dependencias. Puede ver que solo hay 2 dependencias estándar (core y excel).

FIGURA 7: Vista de dependencias (haga clic para ampliar)

Ahora añadiremos una nueva dependencia. Asegúrese de seleccionar «Agregar una dependencia de proyecto de Business Process».

FIGURA 8: Adición de nueva dependencia (haga clic para ampliar)

Seleccione el proyecto genérico (paquete) que acaba de publicar, seleccione la versión (si hay más versiones) y haga clic en agregar.

FIGURA 9: Seleccione su paquete genérico/reutilizable (haga clic para ampliar)

Ahora puede cambiar a la vista de artefactos y ver que todavía tiene la automatización de la prueba, pero en el panel lateral derecho también verá la automatización agregada como dependencia. Puede usarlo como cualquier otro elemento y agregarlo a su proyecto.

FIGURA 10: la automatización genérica está disponible (haga clic para ampliar)

Ahora puede agregar el tipo de datos de contexto para cada flujo de trabajo que necesitará llamar, declarar el tipo de datos y agregar valores y luego agregar su automatización de llamadas API. Rellene las entradas con el ID de contexto y definición y ejecútelo.

FIGURA 11: Automatización de la prueba final (haga clic para ampliar)

Modificación opcional (para escenarios de múltiples inquilinos)

Como vio, estamos definiendo valores de variables de entorno en el proceso de implementación y se codifican después de la implementación. Dado que proporcionó el secreto del cliente, el ID del cliente, la URL del token y el ID de definición para su arrendatario, solo puede llamar a los flujos de trabajo implementados en su arrendatario BTP.

Así es como probablemente lo usará en la mayoría de los casos. Además, este enfoque es mucho mejor si hay varios desarrolladores en su inquilino (especialmente si son desarrolladores ciudadanos) y no desea compartir el secreto del cliente y la identificación del cliente (o crear una clave separada para cada desarrollador).

Para hacerlo totalmente genérico, puede agregar esos valores en su automatización como entradas en lugar de usar variables de entorno. Una desventaja de este enfoque (y es por eso que no mostré esto como una solución principal) es que deberá ingresar esos valores CADA vez que llame a su automatización genérica. Si necesita llamarlo varias veces en su proyecto, esto puede ser molesto.

Si solo ocasionalmente necesita llamar a flujos de trabajo en algún otro inquilino, le sugiero que cree 2 automatizaciones en su proyecto genérico y las llame, por ejemplo, «API de flujo de trabajo de llamadas» y «API de flujo de trabajo de llamadas externo». Puede usar variables de entorno para la versión local y entradas para la versión externa. Esto facilitará su desarrollo diario.

En esta publicación de blog, aprendió cómo crear una automatización genérica, ponerla a disposición de todos en su arrendatario y reutilizarla en sus proyectos de automatización habituales. Aunque estaba cubriendo el caso específico de la automatización, este es un proceso genérico para cualquier automatización reutilizable.

Para mantenerse al día con todas las cosas nuevas y emocionantes relacionadas con SBPA, consulte regularmente:

Disfrute construyendo con SAP Build. 🙂