Variáveis de Workflow

Variáveis no ZippyVendas atuam como um armazenamento global de dados que podem ser acessados e modificados por qualquer bloco no seu workflow, permitindo que você armazene e compartilhe dados através de seu workflow com variáveis globais. Elas fornecem um jeito poderoso de compartilhar informações entre diferentes partes de seu workflow, manter estado e criar aplicações mais dinâmicas.

Variáveis permitem que você armazene e compartilhe dados através de todo seu workflow, facilitando manter estado e criar sistemas complexos e interconectados.

Visão Geral

O recurso Variables serve como um armazenamento de dados central para seu workflow, permitindo que você:

Armazene dados globais: Crie variáveis que persistem ao longo da execução do workflow

Compartilhe informações entre blocos: Acesse os mesmos dados de qualquer bloco em seu workflow

Mantenha estado de workflow: Acompanhe valores importantes conforme seu workflow roda

Crie workflows dinâmicos: Construa sistemas mais flexíveis que podem se adaptar baseado em valores armazenados

Criando Variáveis

Você pode criar e gerenciar variáveis a partir do painel Variables na barra lateral. Cada variável tem:

Nome: Um identificador único usado para referenciar a variável
Valor: Os dados armazenados na variável (suporta vários tipos de dados)
Descrição (opcional): Uma nota explicando o propósito da variável

Acessando Variáveis

Variáveis podem ser acessadas de qualquer bloco em seu workflow usando o dropdown de variáveis. Simplesmente:

Digite < em qualquer campo de texto dentro de um bloco
Navegue o menu de dropdown para selecionar de variáveis disponíveis
Selecione a variável que você quer usar

Você também pode arrastar a tag de conexão para um campo para abrir o dropdown de variáveis e acessar variáveis disponíveis.

Tipos de Variáveis

Variáveis no ZippyVendas podem armazenar vários tipos de dados:

"Hello, World!"

Variáveis de texto armazenam strings de caracteres. Elas são úteis para armazenar mensagens, nomes e outros dados de texto.

Variáveis de número armazenam valores numéricos que podem ser usados em cálculos ou comparações.

true

Variáveis booleanas armazenam valores true/false, perfeitas para flags e verificações de condição.

{
  "name": "John",
  "age": 30,
  "city": "New York"
}

Variáveis de objeto armazenam dados estruturados com propriedades e valores.

[1, 2, 3, "four", "five"]

Variáveis de array armazenam coleções ordenadas de itens.

Usando Variáveis em Blocos

Quando você acessa uma variável de um bloco, você pode:

Ler seu valor: Use o valor atual da variável na lógica do seu bloco
Modificá-la: Atualize o valor da variável baseado no processamento do seu bloco
Usar em expressões: Inclua variáveis em expressões e cálculos

Escopo de Variável

Variáveis no ZippyVendas têm escopo global, significando:

Elas são acessíveis de qualquer bloco em seu workflow
Mudanças em variáveis persistem ao longo da execução do workflow
Variáveis mantêm seus valores entre execuções, a menos que explicitamente resetadas

Melhores Práticas

Use Nomes Descritivos: Escolha nomes de variáveis que claramente indicam o que a variável representa. Por exemplo, use userPreferences em vez de up.
Documente Suas Variáveis: Adicione descrições às suas variáveis para ajudar outros membros do time a entender seu propósito e uso.
Considere Escopo de Variável: Lembre-se que variáveis são globais e podem ser modificadas por qualquer bloco. Projete seu workflow com isso em mente para prevenir comportamento inesperado.
Inicialize Variáveis Cedo: Configure e inicialize suas variáveis no início do seu workflow para garantir que estejam disponíveis quando necessárias.
Manipule Variáveis Faltantes: Sempre considere o caso onde uma variável pode não existir ainda ou pode ter um valor inesperado. Adicione validação apropriada em seus blocos.
Limite Contagem de Variáveis: Mantenha o número de variáveis gerenciável. Muitas variáveis podem tornar seu workflow difícil de entender e manter.