Buildship

Dominando Variáveis no BuildShip: Guia Completo para Otimizar Seus Fluxos de Trabalho

Xavier

27 Mai 2025 • 5 min read

No universo do desenvolvimento low-code e no-code, a capacidade de gerenciar dados de forma eficiente é crucial para construir automações robustas e flexíveis. A plataforma BuildShip oferece um sistema poderoso de variáveis que permite aos usuários armazenar, acessar e modificar informações dinamicamente em seus fluxos de trabalho. Compreender e utilizar corretamente as variáveis pode transformar a maneira como você projeta e implementa suas automações, tornando-as mais eficientes, escaláveis e fáceis de manter.

Entendendo as Variáveis no BuildShip

Antes de mergulharmos nos tipos específicos de variáveis e como usá-las, é fundamental entender o conceito e os benefícios que elas trazem para seus projetos no BuildShip.

O que são Variáveis?

No BuildShip, as variáveis são essencialmente pares de chave-valor. Isso significa que cada variável possui um nome (a chave) que a identifica unicamente e um valor associado a esse nome. Esses valores podem ser de diversos tipos, como texto (string), números, booleanos (verdadeiro/falso), arrays ou objetos.

Elas são projetadas para armazenar informações não sensíveis, como configurações, valores padrão, constantes ou dados temporários que precisam ser referenciados e/ou modificados ao longo da execução de um fluxo de trabalho ou mesmo entre diferentes fluxos.

Benefícios de Utilizar Variáveis

A utilização de variáveis no BuildShip oferece diversas vantagens significativas:

Otimização da Execução: Centralizar dados em variáveis evita a repetição de valores em múltiplos nós, simplificando o fluxo e, potencialmente, melhorando o desempenho.
Redução de Redundância: Em vez de inserir o mesmo valor em vários lugares, você o define uma vez em uma variável e a referencia onde for necessário.
Facilidade de Manutenção: Se um valor precisa ser alterado, você o modifica em um único local (na definição da variável), e essa alteração se reflete em todos os lugares onde a variável é usada. Isso é muito mais prático do que ter que encontrar e alterar o valor em cada nó individualmente.
Dinamismo e Flexibilidade: As variáveis permitem que seus fluxos de trabalho sejam mais dinâmicos, adaptando-se a diferentes entradas ou condições em tempo de execução.

Tipos de Variáveis no BuildShip e Como Utilizá-las

O BuildShip distingue principalmente dois tipos de variáveis: Locais e de Ambiente. Cada uma tem seu propósito e escopo específicos.

Variáveis Locais: Dinamismo Dentro do Fluxo de Trabalho

As variáveis locais são específicas para o fluxo de trabalho em que são criadas. Elas permitem armazenar e modificar valores que serão utilizados nas diversas etapas desse fluxo específico.

Criando e Utilizando Variáveis Locais no BuildShip

Para criar e gerenciar variáveis locais, você utiliza o nó "Set Variable":

Adicionar o Nó: Clique em "+ Add node" e selecione o nó "Set Variable".
Definir a Variável: No painel do nó, clique em "+ Add variable" na seção "Name".
Nomear e Tipar: Dê um nome para sua variável (ex: nome) e escolha o tipo de dado (ex: String, Number, Boolean). Salve a definição.
Atribuir um Valor Inicial: No campo "Value" correspondente à variável criada, você pode definir um valor inicial. Por exemplo, para a variável nome, você poderia inserir "Jon Doe".

Uma vez definida, essa variável local pode ser acessada em outros nós do mesmo fluxo. Por exemplo, para exibir o valor da variável nome no console, você pode adicionar um nó "Log Message to Console" e, no campo "Message", selecionar a variável local nome através do seletor de variáveis (ícone de chaves {x} Variables > Local Variables > nome).

Modificando Variáveis Locais no BuildShip

A beleza das variáveis locais reside na sua capacidade de serem modificadas durante a execução do fluxo. Para alterar o valor de uma variável local existente:

Adicione outro nó "Set Variable" em uma etapa posterior do fluxo.
Na seção "Name" do novo nó, selecione a variável local que você deseja modificar (ex: nome) na lista de variáveis já existentes.
No campo "Value", insira o novo valor (ex: "Jane Smith").

Se você adicionar outro nó "Log Message to Console" após essa modificação, verá que o valor da variável nome foi atualizado para "Jane Smith".

É possível também gerenciar todas as variáveis locais de um fluxo clicando no ícone de configurações (engrenagem) do nó "Set Variable" ou de qualquer nó que permita acesso a variáveis locais. Isso abre um painel onde você pode adicionar, editar ou excluir variáveis locais.

Variáveis de Ambiente: Flexibilidade Entre Fluxos de Trabalho

As variáveis de ambiente oferecem maior flexibilidade, pois podem ser configuradas para serem acessíveis em todos os fluxos de trabalho de um projeto BuildShip (escopo de projeto) ou apenas em um fluxo específico (escopo de fluxo).

Configurando Variáveis de Ambiente no BuildShip

A configuração de variáveis de ambiente é feita através da interface do BuildShip:

Em qualquer nó, clique no seletor de variáveis (ícone de chaves {x}).
Selecione "Env Variables".
Clique em "Manage Env Variables".
Uma janela pop-up aparecerá. Aqui você pode:
- Adicionar uma nova variável: Clique em "Add variable".
- Definir a Chave (Key): Insira o nome da sua variável de ambiente (ex: WEBSITE_URL).
- Definir o Valor (Value): Insira o valor correspondente (ex: "example.com").
- Definir o Escopo (Scope): Escolha se a variável será válida para "All workflows on this project" (todos os fluxos neste projeto) ou "This workflow only" (apenas este fluxo).
- Salve a variável.

Importante: Conforme destacado no vídeo e como boa prática de segurança, não armazene dados sensíveis como chaves de API ou senhas em variáveis de ambiente. Para isso, o BuildShip oferece o recurso de "Secrets", que é a forma segura de gerenciar credenciais.

Acessando e Modificando Variáveis de Ambiente Programaticamente no BuildShip

Variáveis de ambiente podem ser acessadas em qualquer nó que permita a inserção de valores dinâmicos, da mesma forma que as variáveis locais (via seletor de variáveis > Env Variables).

Além disso, é possível modificar variáveis de ambiente programaticamente dentro da lógica de um nó (Node Logic), utilizando JavaScript. O BuildShip disponibiliza um objeto env para essa finalidade:

Para definir ou atualizar uma variável de ambiente:

await env.set([{ name: 'NOME_DA_VARIAVEL', value: 'NOVO_VALOR' }], 'project');

Ou, para escopo de fluxo:

await env.set([{ name: 'NOME_DA_VARIAVEL', value: 'NOVO_VALOR' }], 'workflow');

Note que a função env.set espera um array de objetos, onde cada objeto representa uma variável a ser definida/atualizada. O segundo parâmetro especifica o escopo ('project' ou 'workflow'). Se você tentar modificar uma variável de escopo de projeto sem especificar o escopo 'project', poderá encontrar um erro, como "Couldn't save project environment variables".

Para ler uma variável de ambiente programaticamente:

const minhaVariavel = await env.get('NOME_DA_VARIAVEL');

Aplicando Variáveis no BuildShip na Prática: Otimizando o "Weekly News Tracker"

No exemplo do fluxo de trabalho "Weekly News Tracker" apresentado no vídeo, uma variável local pode ser usada para tornar a instrução enviada ao nó da Perplexity AI mais dinâmica. Em vez de ter o número de notícias fixo na string do prompt (ex: "Give me top 5 news..."), podemos usar uma variável local.

Adicione um nó "Set Variable" no início do fluxo.
Crie uma variável local chamada MAX_NEWS, do tipo "Number", e defina seu valor como 5.
No nó da Perplexity AI, modifique o campo "Instructions" para: "Give me top {localVariables.MAX_NEWS} news for the specified topics."

Agora, se você quiser alterar o número de notícias a serem buscadas, basta modificar o valor da variável MAX_NEWS em um único lugar, e o prompt será atualizado automaticamente.

Boas Práticas ao Trabalhar com Variáveis no BuildShip

Nomes Descritivos: Use nomes claros e descritivos para suas variáveis, facilitando o entendimento do seu propósito.
Escopo Correto: Utilize variáveis locais para dados específicos de um fluxo e variáveis de ambiente para configurações que podem ser compartilhadas ou precisam de um gerenciamento mais centralizado.
Segurança em Primeiro Lugar: Nunca armazene informações sensíveis (chaves de API, senhas, etc.) em variáveis locais ou de ambiente. Utilize o sistema de "Secrets" do BuildShip para esses casos.
Mantenha a Simplicidade: Embora as variáveis ofereçam poder, evite complexidade desnecessária. Use-as para tornar seus fluxos mais claros e gerenciáveis.

Conclusão

As variáveis são um componente fundamental para a criação de fluxos de trabalho avançados e eficientes no BuildShip. Ao dominar o uso de variáveis locais e de ambiente, você ganha a capacidade de construir automações mais dinâmicas, fáceis de manter e adaptáveis às suas necessidades. Lembre-se de aplicar as boas práticas, especialmente em relação à segurança de dados, para aproveitar ao máximo o potencial que essa ferramenta oferece.