Variáveis globais

Crie variáveis globais em Workspace e acesse-as em diferentes ferramentas.

Introdução

O uso de Variáveis Globais permite armazenar e reutilizar informações de forma centralizada dentro do Workspace, facilitando a configuração e execução de fluxos. Elas podem ser acessadas por diferentes conectores e personalizações, garantindo flexibilidade e segurança na automação de processos.

Gerenciar variáveis

Para gerenciar as variáveis globais do Workspace, acesse o menu lateral, vá até Configurações e clique em Variáveis. Nesta tela, é possível visualizar a listagem de variáveis existentes, criar novas variáveis, editar ou remover variáveis conforme necessário.

Gerenciar variáveis

Crie variáveis

Para criar uma variável global no nível do Workspace, acesse a tela de listagem de variáveis e clique em Criar Variável, localizado no canto superior direito.

No formulário de criação, defina um nome para a variável, utilizado como identificador visual, e insira o código da variável, que servirá como chave de acesso ao recurso. Em seguida, informe o conteúdo da variável e finalize clicando em Salvar Variável.

Por motivos de segurança não é permitido inserir variáveis globais com mesmo nome ou código.

Criação de variáveis globais

Acesso a variáveis

As variáveis globais criadas no Workspace podem ser acessadas e utilizadas de diferentes formas, permitindo maior flexibilidade na reutilização de dados em fluxos e configurações. A seguir, são apresentadas as principais maneiras de acessar e utilizar essas variáveis dentro da plataforma.

Conectores

Durante a configuração de conectores, em geral, é possível obter acesso aos valores de variáveis globais utilizando a notação Mustache.

Mustache

Nos campos de configuração utilize var antes de instanciar a variável dentro da marcação Mustache {{ }}.

{{var minha_variavel}}

Com o conector Function Javascript, é possível acessar a variável global a partir de uma função reservada getVar().

Função reservada

Aplicada via conector Function Javascript.

let minhavariavel = await getVar("nome_variavel")

Conector Personalizado

As variáveis globais podem ser usadas na implementação de conectores personalizados, através de uma função reservada.

Função reservada

Aplicada via conectores personalizadas.

let minhavariavel = await getVar("nome_variavel")

Precedência entre variáveis globais e de fluxos

Quando uma variável local é criada dentro de um fluxo com a mesma chave de uma variável global, o ambiente adota uma ordem de precedência, priorizando a variável local. Isso garante que o fluxo utilize a variável definida em seu contexto imediato, sem impactar outras execuções ou dependências que utilizem a variável global.