Anteriormente describimos el módulo ‘Plataformas Externas’ el que permite integrar la plataforma con aplicaciones externas, para lo que se deben definir las APIs involucradas y como se agrupan en plataformas externas. Ahora explicaremos el módulo «Operaciones» dentro del cual están estos sub-módulos:
Operaciones: Define cuál de las capacidades de cada API serán utilizadas por los ‘Casos de Uso’ que se configurarán. El concepto ‘Operación’ también es una capa de adaptación permite homogenizar los recursos expuestos de tal manera que sean independientes del tipo de protocolo REST o SOAP de cada API.
Casos de Uso: Es una capa de abstracción entre los árboles y las APIs que se desean utilizar, permite que dichas capacidades lleguen más fáciles de utilizar en un árbol y con una orientación más cercana al negocio que a lo técnico. También define las variables que deberá entregar el árbol como entrada en el request del API y las variables de salida del árbol en los que se almacenará la respuesta del API.
En la siguiente figura se describe lo mencionado.
En la figura se puede apreciar que cada API configurada dentro de una plataforma externa puede tener configurados 1 o más operaciones, y que cada operación puede tener configurada 1 o más casos de uso.
Con las operaciones y casos de uso configurados, en cualquier árbol de la plataforma se puede aprovechar dichas capacidades. El siguiente diagrama muestra un árbol de ejemplo que utiliza 2 nodos de conexión externa que utilizan diferentes plataformas externas para implementar la lógica deseada.
Operaciones y Casos de Uso en Reevolute Builder
La administración de las Operaciones y los casos de uso se realiza accediendo a la opción «Operaciones» en el módulo «Conexiones externas» del panel de la izquierda de la WEB de la plataforma.
Con la intención de mostrar las diferentes secciones y cómo se configuran, a continuación se muestran como ejemplo el caso de una plataforma externa de prueba que viene configurado con cada nuevo tenant.
Ejemplo de Plataforma externa de prueba
Cada nueva suscripción en la plataforma Reevolute builder viene configurada para integrarse con un servicio de prueba externo.
En el siguiente link se detalla las funcionalidades de la plataforma de prueba y la especificación del API que las expone:
Ya vimos como en el módulo conexión externa del panel de la plataforma, se puede apreciar la «Plataforma Externa» de prueba que se creo con el nombre «Sanbox» y su API llamada «rest_sandbox». En la siguiente figura se muestra las operaciones que se configuraron para esa plataforma.
Cómo se puede apreciar, la plataforma «Sandbox» tiene configurada las siguientes operaciones:
| Operaciones | Descripción |
|---|---|
| list users | Lista todos los usuarios |
| get user | Muestra la información de un usuario |
| update user | Modifica parte de la información de un usuario |
| modify user | Modifica toda de la información de un usuario |
Al seleccionar cada operación se puede ver los casos de uso que tienen configurados cada una. En la siguiente tabla se muestra el resumen.
| Operaciones | Casos de Uso | Descripción |
|---|---|---|
| list users | all | Lista todos los usuarios |
| sleep | Lista todos los usuarios retrasando la respuesta en N-milisegundos | |
| filter by name | Lista todos los usuarios que poseen un cierto nombre | |
| get user | user content | Muestra la información de un usuario |
| update user | patch | Modifica parte de la información de un usuario |
| modify user | put | Modifica toda de la información de un usuario |
Si se selecciona la operación «list users» se muestran los 3 casos de uso que aprovechan sus capacidades.
Al seleccionar el caso de uso «filter by name» se muestra su configuración, lo que se aprecia en la siguiente imagen.
A diferencia del caso de uso «filter by name» que está configurado gráficamente, al seleccionar el caso de uso «all» se muestra un ejemplo de configuración mediante script, lo que se aprecia en la siguiente imagen.
