Cómo usar configuraciones en el FlowEngine

En la Onesait Platform, tienes la posibilidad de crear tus propias configuraciones. En este ejemplo, vamos a ver cómo crear una configuración personalizada y cómo usarla en el FlowEngine. Esto te permite tener todo lo relacionado con configuración centralizado en un solo punto.

Instructions

1. Crea una configuración personalizada

   1. En el menú, ve a “Herr. Desarrollo” → “Configuración Centralizada”.

      Open

      

       

   2. Crea una configuración a medida:

      Open

      

      
      Y rellénala con los valores que se necesiten, siguiendo un formato yaml:

       

2. Lee la configuración desde el FlowEngine: Para leer la configuración, usa la API de Gestión de Onesait Platform. El FlowEngine ya dispone de un nodo que te facilitará las llamadas a dicha API, simplemente tienes que seleccionar la operación que quieres ejecutar. Ahora vas a crear un subflow que se encargará de recargar la configuración a variables globales dentro de tus flujos.

   1. Crear un subflujo:

      Esto nos abrirá una nueva pestaña. Si haces doble click en ella, puedes cambiarle el nombre a “Load Config”.
      
      Tras esto, vas a definir una entrada y una salida:

      Esto representan las patillas de entrada y salida de tu nodo subflow.
      
      

   2. Obtener un token OAuth válido: Vas a usar una llamada “http request” a nuestro IM para obtenerlo. Para más información relacionada con el Identity Manager, échale un ojo a cómo usar tokens Oauth2 en Plataforma
      
      Primero, necesitas establecer las cabeceras y cuerpo de la petición, usando un nodo “function” como el siguiente:

      
      A continuación, crea un nodo “http request” con la llamada al IM:

      
      En este caso concreto, estarás usando KeyCloak como IM. El usuario y password en la autenticación son “onesaitplatform” en ambos casos.
      Tras esto, puedes parsear la respuesta en un nodo “function” y obtener tu token OAuth listo para usar en la siguiente llamada:

       

   3. Obtener la configuración:
      
      Una vez tenemos el token Oauth, podemos recuperar la configuración usando yu nodo “onesaitplatform-management-Rest-API-invoker“. Añade este nodo desde la paleta al subflow y haz doble click para editarlo:
      
      

      1. Selecciona “Configuration management service“ como API.

          

      2. Selecciona “getByIdentificationUsingGET“ como operación.

          

      3. Rellena los campos obligatorios de la petición. Estos parámetros corresponden con los valores definidos en la configuración que creaste en el paso 1:

          

   4. El nodo “onesaitplatform-management-Rest-API-invoker“ tiene varias salidas. Si pasas el cursor por encima de cada una, verás un tooltip con la descripción de cada una. Por simplificar, la salida superior es la que contendrá la respuesta correcta y el resto son distintos tipos de error.

      
      Añade un nodo “function” en el cual puedas procesar los errores si fuera necesario.
      
      

3. Carga la configuración en variables globales.

   
   Ahora vas a procesar la respuesta de la API para convertirla en un objeto que sea más fácil de usar. El nodo de invocación de APIs de gestión devolverá la configuración en el mensaje, en concreto en el campo “msg.payload.yml“. El siguiente paso es parsear el yaml en un objeto JSON.
   Para ello, añadimos un nodo “yaml” al subflujo y le indicamos el campo a parsear:

   
   La configuración parseada debería quedar así:

   
   Por último, en un nodo “function”, lee el objeto configuración y crea las variables globales que necesites:

    

4. Despliega los cambios haciendo click en el botón “deploy”:

    

    

5. Usa el subflow y prueba los resultados.

   Simplemente crea un sencillo flujo que ejecute el subflow “Load Config“ y un nodo “function” que lea todas las variables globales para mostrarlas:

Artículos Relacionados