Migração de sintaxe v2 para v3

resumo neste guia, exploraremos as mudanças na sintaxe necessárias para migrar do padrão da versão v2 0 para a versão v3 0 ao acessar dados dentro de um fluxo de processamento tl;dr anteriormente, onde usávamos state para acessar o json do payload de entrada ou acessar o resultado de um passo, agora usamos input body para o json de entrada ou steps \<nome do passo> body para o resultado de um passo já para acessarmos os headers e query parameters , input headers e input query params respectivamente alterações na sintaxe exemplo de uso detalhado considere um exemplo prático onde um fluxo é disparado via gateway fluid docid\ tldeo0voi8xwt2iqj7oiv com a seguinte url e json de entrada ( payload ) https //gtw\ fluidapi io/tenant/v2/flows/insere produto?key=123\&cod cliente=2 https //gtw\ fluidapi io/tenant/v2/flows/insere produto?key=123\&cod cliente=2 { "payload campo 1" "valor do payload de entrada", "payload campo 2" { "msg" "valor do payload de entrada" } } considere que um passo chamado passo 1 tenha gerado o seguinte resultado { "campo 1" "resultado do campo 1", "campo 2" "resultado do campo 2" } acesso aos dados de entrada na versão 2 0 , os dados do json ( body ) de entrada eram acessados usando state na versão 3 0 , isso foi refinado para melhor refletir a origem dos dados, utilizando input body agora a forma para recuperar o campo payload campo 1 do body do webhook/evento de entrada/disparo do fluxo na versão 3 0 é {{ input body payload campo 1}} onde, anteriormente na versão 2 0 usávamos {{ state payload campo 1}} acesso a headers e query parameters do payload de entrada com a atualização para a v3 0 , é possível acessar os headers utilizando input headers e os query parameters utilizando input query params exemplo para acessar os headers {{ input headers | tojson}} ou para acessar diretamente um header específico {{ input headers authorization}} caso o header (ou nome do passo, query param , etc) contenha algum caractere especial como hífen , acesse com a seguinte sintaxe {{index input headers "content type"}} exemplo para acessar os query parameters {{ input query params}} ou acessar um parâmetro específico {{ input query params cod cliente}} acesso ao resultado de um passo do fluxo em relação ao resultado gerado pela execução de um passo específico no fluxo, a sintaxe também evoluiu na versão v2 0 , costumávamos usar state \<nome do passo> para acessar o body do resultado desse passo na versão v3 0 , adotamos uma abordagem mais estruturada com steps \<nome do passo> body {{ steps passo 1 body}} onde anteriormente usávamos {{ state passo 1}} para acessar um resultado específico ( campo x ) dentro do resultado do passo 1 , na versão 3 0, utilize o exemplo conforme abaixo {{ steps passo 1 body campo x}} onde a sintaxe antiga v2 0 era {{ state passo 1 campo x}} acesso a headers e query parameters do passo da mesma forma, é possível utilizar os dados para ter acesso aos headers utilizando steps \<nome do passo> headers e os query parameters utilizando steps \<nome do passo> query params em um passo exemplo para acessar os headers de um passo {{ steps passo 1 headers | tojson}} ou {{index input headers "content type"}} exemplo para acessar os query parameters {{ steps passo 1 query params}} ou {{ steps passo 1 query params cod cliente}} conclusão esta atualização na sintaxe é crucial para garantir a compatibilidade e eficácia na manipulação de dados em ambientes de processamento de fluxo certifique se de ajustar seus templates de acordo com essas novas orientações para aproveitar ao máximo os recursos da versão v3 0 ao adotar essa nova abordagem, você estará alinhado com as melhores práticas e garantirá uma transição suave para a versão mais recente do sistema de processamento de dados