Base de conhecimento

Sistema de variáveis

As variáveis são um mecanismo computacional do Pollsar que permite coletar, armazenar e utilizar valores durante a realização de uma pesquisa. Com variáveis você pode calcular pontuações, personalizar textos de perguntas, controlar a lógica de ramificação e criar cenários interativos.

Todas as variáveis são globais — estão disponíveis em todas as partes da pesquisa a qualquer momento durante a realização. Para inserir o valor de uma variável no texto de uma pergunta, título ou página, envolva seu nome em chaves: {variable_name}.

Variáveis do usuário

As variáveis do usuário são criadas manualmente pelo autor nas configurações da pesquisa (botão Configurações → aba Variáveis do usuário).

Criação e configuração

Digite o nome de uma nova variável no campo de entrada. O nome pode conter letras latinas, dígitos e underlines. Se você digitar um nome em outro idioma, o sistema o transliterará automaticamente para caracteres latinos.

O valor inicial padrão é 0. Pode ser alterado nas configurações da variável. As variáveis não têm tipo — aceitam valores numéricos e de texto dependendo do contexto.

Notice image
IMG: Captura de tela da aba Variáveis do usuário nas configurações da pesquisa — lista de variáveis com badges verdes e valores.

O que você pode fazer com variáveis

  • Atribuir valores — valores fixos ou da resposta de um respondente a uma pergunta específica.
  • Realizar aritmética — adição, subtração, multiplicação, divisão.
  • Comparar — usar em condições de lógica de ramificação.
  • Inserir em textos — exibir o valor da variável para o respondente diretamente em perguntas e páginas da pesquisa.

Mais sobre cálculos no artigo «Function — cálculos com variáveis». Sobre verificação de condições — no artigo «Rule — regras condicionais».

Variáveis do sistema

As variáveis do sistema são criadas automaticamente junto com a pesquisa. Seus valores são determinados durante a realização e não podem ser alterados pelo autor.

  • ps_answer_last — a resposta do respondente à pergunta anterior. Vazia no início da pesquisa. Também vazia se a pergunta anterior contém um sistema complexo de múltiplas respostas.
  • ps_duration_poll — tempo em minutos decorrido desde o início da pesquisa. Atualizado dinamicamente.
  • ps_duration_set — tempo em minutos alocado para a realização da pesquisa (se o autor definiu um limite). Se nenhum limite foi definido, o valor é 0.
  • ps_audience — o nome do público ao qual o respondente atual pertence. Os públicos são criados na etapa de publicação.

As variáveis do sistema podem ser usadas em textos e na lógica da mesma forma que as variáveis do usuário.

Como distinguir variáveis na interface

As variáveis do usuário e do sistema são visualmente distintas na interface. Nas configurações de lógica, as variáveis do usuário são destacadas com um badge verde, enquanto as do sistema têm um badge amarelo. As variáveis do sistema também são facilmente reconhecíveis pelo prefixo ps_ no nome.

Na lista suspensa de variáveis (painel de formatação de texto), as variáveis do usuário são exibidas em texto verde, as do sistema em texto escuro.