Transformação com Go Template
Nesta documentação, vamos abordar como aproveitar o Playground do Go Template para simplificar o desenvolvimento e teste de templates em nossos fluxos, dentro dos conectores Fluid. O Playground do Go Template é uma plataforma online que possibilita aos desenvolvedores criar, testar e depurar templates Go de forma interativa, facilitando a configuração e a transformação de dados no seu conector, dentro do console da Fluid.
O Playground do Go Template oferece uma gama de funcionalidades para facilitar o desenvolvimento e teste de templates, incluindo:
- Edição de Templates: Permite aos usuários escrever e editar templates Go de maneira intuitiva e fácil.
- Visualização de Resultados: Após a execução do template, o Playground exibe o resultado gerado com base nos dados de entrada fornecidos.
- Depuração Interativa: Facilita a identificação e correção de erros no template, fornecendo mensagens de erro detalhadas e sugestões de correção.
- Suporte a Bibliotecas Externas: Permite a utilização de bibliotecas externas, como a biblioteca Spring Functions (sprig), expandindo as funcionalidades disponíveis nos templates.
Para utilizar o Playground do Go Template, siga estas etapas:
- Na interface do Playground, você encontrará um editor de texto onde poderá escrever seu template Go.
- Caso deseje utilizar funções da biblioteca Spring Functions (sprig), consulte a documentação oficial da biblioteca para conhecer as funções disponíveis e sua sintaxe correta: Documentação do Spring Functions (sprig).
- Após escrever o template, clique no botão "Run" para executá-lo.
- O Playground exibirá o resultado gerado com base nos dados de entrada fornecidos.
- Se houver erros durante a execução do template, o Playground fornecerá mensagens de erro detalhadas para auxiliá-lo na depuração.
- Faça os ajustes necessários no template e repita o processo até alcançar o resultado desejado.
Em nosso conector, quando precisamos acessar dados do passo anterior, utilizamos a notação . Veja um exemplo prático de utilização do Playground do Go Template, aplicado à plataforma Fluid:
Suponha que tenhamos um payload de entrada como mostrado abaixo:
E desejamos criar um template que utilize as informações contidas no passo anterior (). O template pode ser escrito da seguinte forma:
Após executar o template no Playground, o resultado será:
Utilize este exemplo como guia para desenvolver e testar seus próprios templates dentro do Playground do Go Template, utilize este link com o exemplo já formatado. Para utilizar, substitua o nome do passo do seu fluxo e o payload do passo.
Caso seja necessário testar com dados de dois ou mais passos, é só duplicar o payload do nome do passo, conforme exemplo abaixo:
O Playground do Go Template é uma ferramenta valiosa para simplificar o desenvolvimento e teste de templates em nossos conectores Fluid. Ao utilizar este recurso, os desenvolvedores podem iterar rapidamente na criação e depuração de templates, garantindo uma configuração precisa e eficiente dos dados nos fluxos de trabalho da Fluid. Não hesite em explorar todas as funcionalidades oferecidas pelo Playground do Go Template para melhorar sua produtividade e eficácia na criação de templates.
