Variáveis

Visão Geral

As variáveis no NueForm permitem criar experiências de formulário dinâmicas e personalizadas. Você pode referenciar respostas do respondente, parâmetros de URL e variáveis de formulário personalizadas em qualquer lugar dos títulos das perguntas, descrições, telas de boas-vindas e telas de agradecimento usando a sintaxe de substituição {variableName}.

Tipos de Variáveis

O NueForm suporta três tipos de variáveis:

1. Variáveis de Resposta

As variáveis de resposta capturam a resposta do respondente a uma pergunta específica e a disponibilizam para uso em perguntas posteriores.

Como configurar:

1. Selecione uma pergunta no construtor de formulários.
2. Nas configurações da pergunta, localize o campo Answer Variable.
3. Insira um nome de variável (por exemplo, name, company, rating).
4. A resposta do respondente a essa pergunta agora fica armazenada como {name}, {company} ou {rating}.

Exemplo:

• Pergunta 1: "Qual é o seu nome?" (Variável de resposta: name)
• Título da Pergunta 2: "Prazer em conhecer você, {name}! O que traz você aqui hoje?"

Quando o respondente digita "Sarah" na Pergunta 1, a Pergunta 2 exibirá: "Prazer em conhecer você, Sarah! O que traz você aqui hoje?"

Coerção de valores:

2. Variáveis de URL

As variáveis de URL são valores passados ao formulário por meio de parâmetros de consulta na URL. Elas ficam disponíveis imediatamente quando o formulário carrega, antes de qualquer pergunta ser respondida.

Como usar:

Anexe parâmetros de consulta à URL do seu formulário:

https://nueform.io/f/my-form?firstName=John&company=Acme&source=email

Esses parâmetros ficam automaticamente disponíveis como variáveis:

• {firstName} resolve para "John"
• {company} resolve para "Acme"
• {source} resolve para "email"

Casos de uso:

• Pré-preencher campos do formulário com dados conhecidos.
• Personalizar saudações: "Olá {firstName}, temos algumas perguntas para você."
• Rastrear fontes de indicação nos dados das suas respostas.
• Rotear respondentes usando saltos de lógica iniciais com base em parâmetros de URL.

3. Variáveis de Formulário

As variáveis de formulário são variáveis predefinidas com nome, tipo e valor padrão. Elas são definidas no nível do formulário e podem ser modificadas por ações de variável em saltos de lógica.

Como definir:

As variáveis de formulário são definidas nas definições de variáveis do formulário e têm as seguintes propriedades:

Como são modificadas:

As variáveis de formulário são modificadas por meio de ações de variável em saltos de lógica. Quando a condição de um salto de lógica corresponde, suas ações de variável associadas são executadas:

Exemplo: Construindo uma calculadora de pontuação

1. Defina uma variável de formulário: score (tipo: number, padrão: 0).
2. Em cada pergunta, adicione saltos de lógica com ações de variável:
   • Se Avaliação >= 4, somar 10 a score.
   • Se Avaliação >= 2, somar 5 a score.
3. Na tela de agradecimento: "Sua pontuação é {score} de 50."

Sintaxe de Substituição

A sintaxe {variableName} funciona nos seguintes locais:

Como a Substituição Funciona

1. O sistema varre o texto em busca de padrões {variableName} (chaves simples com caracteres de palavra dentro).
2. Ele procura o nome da variável no mapa de variáveis atual.
3. Se encontrado, o token é substituído pelo valor da variável.
4. Se não encontrado, o token é substituído por uma string vazia.

Detecção de Variáveis

O NueForm detecta automaticamente todas as variáveis referenciadas no seu formulário varrendo:

• Tokens {variableName} em todos os campos de texto (títulos, descrições, telas de boas-vindas/agradecimento).
• Campos com prefixo url: em condições de saltos de lógica.
• Nomes de variáveis em ações de saltos de lógica.
• Declarações de answerVariable nas perguntas.
• Definições de variáveis no nível do formulário.

Essa varredura abrangente produz uma lista ordenada e sem duplicatas de todos os nomes de variáveis usados no seu formulário.

Ordem de Resolução de Variáveis

Ao resolver um token {variableName}, o NueForm verifica as variáveis nesta ordem:

1. Variáveis de URL -- passadas pela URL do formulário.
2. Variáveis de resposta -- definidas pelas respostas do respondente a perguntas com answerVariable configurado.
3. Variáveis de formulário -- definidas no nível do formulário e modificadas por ações de saltos de lógica.

Se o mesmo nome de variável existir em várias fontes, as variáveis de URL têm precedência (já que elas são a fonte passada à função de substituição, com as variáveis de formulário/resposta mescladas em seguida).

Exemplos

Boas-vindas Personalizadas

URL: https://nueform.io/f/feedback?name=Sarah&product=Widget

Título de boas-vindas: "Olá {name}!" Descrição de boas-vindas: "Adoraríamos ouvir sua opinião sobre {product}."

Resultado: "Olá Sarah!" / "Adoraríamos ouvir sua opinião sobre Widget."

Perguntas de Acompanhamento Dinâmicas

Pergunta 1: "Qual é a sua função?" (Variável de resposta: role) Pergunta 2: "Como {role}, qual é o seu maior desafio?"

Exibição de Pontuação Calculada

Variável de formulário: score (number, padrão: 0) Ações de saltos de lógica: Somar pontos com base nas respostas Descrição da tela de agradecimento: "Você marcou {score} pontos! Obrigado por concluir o quiz."

Roteamento Condicional com Variáveis de URL

URL: https://nueform.io/f/survey?plan=enterprise

Salto de lógica inicial:

• Condição: url:plan igual a "enterprise"
• Destino: Saltar para perguntas específicas do Enterprise
• Ação: Definir plan_name como "Enterprise"

Boas Práticas

1. Use nomes descritivos: Escolha nomes de variáveis que indiquem claramente o que armazenam (por exemplo, customer_name em vez de n).
2. Defina padrões: Para variáveis de formulário, sempre forneça um valor padrão significativo para o caso de a variável nunca ser modificada.
3. Teste com parâmetros de URL: Ao usar variáveis de URL, teste seu formulário com várias combinações de parâmetros para garantir que todos os caminhos funcionem corretamente.
4. Trate variáveis ausentes com elegância: Se uma variável de URL pode não ser fornecida, redija seu texto de forma que continue natural mesmo quando a variável resolver para uma string vazia.