Release Notes

v3.0.0

7min

🌟 Explore as Novidades do Painel Fluid v3.0!

Com a chegada da versão 3.0 do painel Fluid, introduzimos uma mudança significativa na sintaxe da Fluid, ampliando as funcionalidades e melhorando a acessibilidade dos dados entre os passos de um Fluxo. Essas mudanças permitem uma maior precisão e flexibilidade na manipulação de dados.

Novas Formas de Acesso a Dados

Dados de entrada e resultados de passos

Anteriormente, utilizávamos o objeto .state para acessar tanto o JSON do payload de entrada quanto o resultado de um passo. Agora, introduzimos comandos específicos para cada tipo de dado:

  • Payload de Entrada:
    • .input.body
      é usado para acessar o JSON do payload de entrada.
    • .input.headers
      é usado para acessar os cabeçalhos enviados no disparo ao Gateway Fluid.
    • .input.query_params
      usado para acessar os parametros de query enviados no disparo ao Gateway Fluid.
  • Resultado de Passo:
    • Para acessar o resultado de um passo específico, utilize .steps.<nome_do_passo>.body
    • Para headers resultantes de um passo, use .steps.<nome_do_passo>.headers
    • Para o código (ex: HTTP Status Code) resultantes de um passo, use .steps.<nome_do_passo>.code

Exemplos práticos

  • Acessando Dados de Entrada:
    • Antes:
      {{ .state.payload_campo_1 }}
    • Agora:
      {{ .input.body.payload_campo_1 }}
  • Acessando Resultados de um Passo:
    • Antes:
      {{ .state.passo_x }}
    • Agora:
      {{ .steps.passo_x.body }}
  • Acessando um Campo Específico de um Resultado de Passo:
    • Antes:
      {{ .state.passo_x.campo_y }}
    • Agora:
      {{ .steps.passo_x.body.campo_y }}

Mudança na sintaxe

Estas alterações foram projetadas para tornar o processo de desenvolvimento mais intuitivo e alinhado com práticas padrão de programação, facilitando o rastreamento de dados ao longo dos fluxos. Consulte a Migração de sintaxe v2 para v3 para mais detalhes.

Como preparar-se para a mudança

  • Revisão de Fluxos Existentes: Recomendamos que todos os templates existentes sejam revisados e ajustados conforme a nova sintaxe para garantir a funcionalidade adequada
  • Documentação e Suporte: Navegue pelo nosso portal de documentação para obter guias detalhados e suporte adicional para facilitar a transição.

Otimização de fluxos

Com a implementação da nova funcionalidade em nossa plataforma, agora você tem ainda mais controle sobre como seus Fluxos manipulam e retêm dados. Introduzimos um recurso que permite manter os dados de resposta de um passo específico na memória, o que é ideal para quando você precisa que outro passo no Fluxo utilize essas informações posteriormente.

Como funciona:

Em cada passo do seu Fluxo, você encontrará um toggle chamado "Manter resultado do passo em memória ". Quando ativado, este toggle habilita o recurso save_output para aquele passo específico, fazendo com que a resposta seja mantida em memória. Assim, qualquer passo subsequente pode acessar e utilizar esses dados.

  • Padrão Desativado: Por padrão, essa opção vem desativada, o que significa que os dados de resposta não serão retidos após a conclusão do passo.
  • Ativação Simples: Se você decidir que precisa manter os dados de resposta, basta ativar o toggle, e o atributo save_output será definido como verdadeiro.

Essa pequena alteração significa que você tem um controle mais granular sobre a gestão de dados e como eles fluem através do seu pipeline de integração. Com a opção "Salvar Saída", seus Fluxos podem ser mais eficientes e menos propensos a redundâncias de chamadas, especialmente útil em cenários complexos de processamento de dados.

Conclusão

A implementação destas mudanças na versão 3.0 é um passo importante para melhorar a experiência do usuário e a eficácia operacional na plataforma Fluid. Encorajamos todos os usuários a explorarem as novas funcionalidades e a atualizarem seus Fluxos para aproveitar as melhorias.

Para mais informações e suporte, explore nosso Portal de Documentação.

Updated 17 Sep 2024
Doc contributor
Doc contributor
Did this page help you?