Tipo de pergunta - Entrada numérica

Descrição breve

Este tipo de pergunta solicita ao participante do inquérito que insira um único número.

Exemplo: Question_example_numerical_input.zip.

Opções gerais

Obrigatória

Descrição

Esta opção permite que os administradores do inquérito exijam que os respondentes respondam a determinadas perguntas do inquérito. Se as perguntas obrigatórias não forem respondidas, os respondentes não poderão prosseguir. Se você tiver uma pergunta com várias subperguntas e precisar que apenas algumas delas sejam respondidas, use o atributo número mínimo de respostas localizado na aba Lógica.

Se você usar qualquer um dos temas pré-instalados e o atributo de pergunta obrigatória estiver ativado, um asterisco vermelho será exibido ao lado da pergunta. Se quiser ocultá-lo, consulte estas instruções.

Opções disponíveis

• Ativada (On) - A pergunta deve ser respondida antes que o participante possa prosseguir para a página seguinte - a opção de resposta 'Sem resposta' nunca é exibida.
• Suave (Soft) - Se a pergunta não for respondida, um aviso é exibido ao tentar prosseguir para a página seguinte - no entanto, o participante pode optar por ignorar o aviso e continuar. Observe que a opção 'Sem resposta' ainda é exibida (se ativada nas configurações de apresentação do questionário)
• Desativada (Off, padrão) - A pergunta pode ficar sem resposta

Validação (usando expressões regulares) (preg_validation)

Descrição

Esta opção permite especificar uma expressão regular com a qual você pode validar todas as partes de uma pergunta.

Se qualquer valor de pergunta ou de pergunta secundária não atender aos requisitos de validação, a cor de fundo do campo de entrada de texto será alterada para vermelho, para que os participantes vejam facilmente quais partes da pergunta precisam ser corrigidas. Assim, você pode fazer a validação na própria página. Dessa forma, você não precisará esperar que o participante clique no botão de envio para validar a respectiva pergunta.

Valores válidos

• Qualquer expressão regular válida

Exemplo

• Clique aqui para ver vários exemplos.

Condição

Descrição

Se o valor do resultado da condição for "1" ou "true", a pergunta é "relevante" no contexto do inquérito, ou seja, é exibida ao participante do inquérito. Caso contrário, a pergunta fica oculta. Qualquer pergunta do inquérito permite especificar uma equação de relevância. Esta função é a sucessora das condições e oferece suporte a uma lógica condicional muito mais complexa.

Realce de sintaxe

Sempre que você salva a condição, ela é avaliada e tem a sintaxe realçada. Os erros são codificados por cores para que você possa detectá-los e corrigi-los rapidamente.

 Hint: Para verificar se todas as condições estão sendo usadas corretamente no seu inquérito, leia sobre o recurso exibir arquivo de lógica.

Valores válidos

• Qualquer condição que use a sintaxe do ExpressionScript, sem chaves ao redor.

Exemplos

Aqui estão bons exemplos de realce de sintaxe.

Exibição

Prefixo (prefix)

Descrição

Um valor de texto a ser exibido como prefixo antes da(s) caixa(s) de entrada de texto. O prefixo é exibido logo à esquerda do campo de entrada.

Se a tela for pequena, o prefixo será exibido acima do campo de entrada. Se quiser mantê-lo à esquerda ^{(New in 3.0.0 )}: adicione a classe suffix-prefix-force à pergunta.

Valores válidos

• Qualquer caractere ou conjunto de caracteres que você deseje exibir antes do campo de entrada

Exemplo

Inserir o valor "$" neste atributo faz com que um cifrão seja exibido imediatamente antes da caixa de entrada de texto.

Sufixo (suffix)

Descrição

Um valor de texto a ser adicionado como sufixo a uma caixa de entrada de texto. O sufixo é exibido logo à direita do campo de entrada.

Em telas pequenas: o sufixo é exibido abaixo do campo de entrada. Se quiser mantê-lo à direita ^{(New in 3.0.0 )}: adicione a classe suffix-prefix-force à pergunta.

Valores válidos

• Qualquer caractere ou conjunto de caracteres que você deseja exibir após o campo de entrada

Exemplo

Inserir o valor "%" neste atributo faria com que um sinal de porcentagem fosse exibido imediatamente após a caixa de entrada de texto.

Tema da questão (question_theme)

Descrição

Permite usar temas personalizados para a respectiva pergunta.

Opções disponíveis

• Os temas de perguntas criados por você, que estão localizados em Temas de perguntas no painel Temas.

Veja: Temas de perguntas

Nota: Este recurso está em desenvolvimento no momento.

Largura da caixa de entrada (text_input_width)

Descrição

Este atributo define a largura das caixas de entrada de texto (do "wrapper" das caixas de entrada de texto). A caixa de entrada é usada para inserir uma resposta à pergunta (ou pergunta secundária). Se o valor da largura for suficientemente alto, a caixa de entrada de texto será exibida na linha seguinte. Observe que esta opção não define o tamanho da entrada nem a largura da coluna inteira!

Opções disponíveis

• Padrão: se selecionado, um valor padrão será atribuído a este atributo de modo que tanto o rótulo quanto a caixa de entrada de texto correspondente fiquem na mesma linha. Por exemplo, se a largura da caixa de entrada de texto for 41%, o valor da largura da caixa de entrada de texto será um valor que permita o rótulo e a caixa de entrada na mesma linha (58% neste caso). Se a largura da caixa de entrada de texto fosse maior que 58%, a caixa de entrada de texto seria exibida na linha seguinte.
• 8%; 17%...92%, 100%: quanto maior o valor selecionado, maior a largura da caixa de entrada de texto.

Exemplo

• Se você deseja que a parte de entrada seja exibida abaixo da pergunta secundária/rótulo, selecione a opção 100% na lista suspensa.

Ocultar dica (hide_tip)

Descrição

A maioria das perguntas geralmente inclui uma dica que diz "Selecione uma das opções a seguir" ou um texto de ajuda sobre como responder à pergunta. Este atributo permite ativar ou desativar essas dicas.

Essas dicas incluem mensagens de critérios de validação (como número mínimo/máximo de respostas ou valor mínimo/máximo/Igual à soma). Se hide_tip estiver ativado, essas mensagens ficarão ocultas. No entanto, se o usuário inserir dados inválidos, as dicas serão exibidas. Elas aparecerão em vermelho e mudarão para verde assim que os critérios de validação forem atendidos.

Opções disponíveis

• Ativado - as dicas ficam ocultas;
• Desativado (padrão).

Tamanho da caixa de entrada de texto (input_box_size)

 Hint: This feature is available starting in version 3.0.0

Descrição

Esta função permite definir o tamanho da área de texto (a caixa de entrada de texto). Por padrão, o LimeSurvey força a exibição da caixa de entrada com um tamanho padrão. Isso pode ser substituído com o uso desta função.

Para mover a caixa para a próxima linha, você precisa aumentar o tamanho do contêiner. Para isso, aumente o valor do atributo de largura da entrada de texto.

Valores válidos

• Qualquer valor numérico

Sempre ocultar esta questão (hidden)

Descrição

Se ativada, a pergunta sempre ficará oculta - ela não será exibida aos participantes do questionário. Esta função pode ser usada nos seguintes cenários:

• Se você deseja preencher previamente uma pergunta por meio de uma URL e não quer que ela seja exibida na tela. Isso substitui quaisquer condições usadas no inquérito, pois a respectiva pergunta nem sequer será incorporada à página.
• Se você deseja armazenar ou calcular um valor dinamicamente por meio do ExpressionScript.

Nota: Um tipo de pergunta comumente usado com esta função é o de Fórmula.

Opções disponíveis

• Ligado
• Desligado (padrão)

Classe CSS (css_class)

Descrição

Se você quiser adicionar classes CSS especiais a determinadas perguntas, insira o(s) nome(s) da classe CSS neste campo. Certifique-se de deixar um espaço em branco entre os diferentes nomes de classe.

Valores válidos

• Qualquer cadeia de texto com um espaço entre os diferentes nomes de classes CSS.

 Hint: Você também pode inserir uma expressão neste campo ^{(New in 3.0.0 )}. Lembre-se de que o resultado da expressão não será atualizado dinamicamente.

  De acordo com o W3C, os nomes de classes CSS podem conter apenas os caracteres [a-zA-Z e 0-9] e os caracteres ISO 10646 U+00A1 e superiores, além do hífen (-) e do subtraço (_). Eles não podem começar com um dígito, nem com um hífen seguido de um dígito. O LimeSurvey codifica as classes CSS, mas não corrige o problema totalmente.

Ajuda de relevância para pesquisa imprimível (printable_survey_relevance_help)

Descrição

Se você deseja imprimir um inquérito, também é possível imprimir as equações de relevância de cada pergunta. No entanto, se preferir oferecer uma explicação em vez da expressão no formulário impresso, preencha esta caixa com a explicação em texto da equação de relevância.

Valores válidos

• Qualquer texto e/ou número que você deseje exibir no formulário imprimível.

Entrada

Máximo de caracteres (maximum_chars)

Descrição

Permite definir o número máximo de caracteres que podem ser inseridos em uma pergunta baseada em texto. Inserir um valor de, por exemplo, 20 significa que o participante não poderá digitar mais de 20 caracteres.

Valores válidos

• Qualquer valor inteiro acima de 0

Valor mínimo da entrada numérica (min_num_value_n)

Descrição

Valor mínimo da entrada numérica que pode ser inserido pelo respondente na caixa de entrada.

Valores válidos

• Qualquer valor inteiro acima de 0
• Qualquer número
• Qualquer código SGQA
• Qualquer código da pergunta (nome da variável)
• Qualquer equação, usando a sintaxe do ExpressionScript, sem chaves ao redor.

Somente números inteiros (num_value_int_only)

Descrição

Se ativada, os participantes poderão inserir na caixa apenas valores inteiros.

Opções disponíveis

• Sim
• Não (padrão)

Valor máximo da entrada numérica (max_num_value_n)

Descrição

Valor máximo da entrada numérica que pode ser informado pelo participante na caixa de entrada.

Valores válidos

• Qualquer valor inteiro acima de 0
• Qualquer número
• Qualquer código SGQA
• Qualquer código de pergunta (nome da variável)
• Qualquer equação, usando a sintaxe do ExpressionScript, sem chaves ao redor.

Lógica

Nome do grupo de randomização (random_group)

Descrição

Coloca as perguntas em um grupo de randomização específico. Todas as perguntas incluídas no grupo especificado são exibidas em ordem aleatória para os respondentes do inquérito.

Você pode encontrar um inquérito de exemplo que usa o nome do grupo de randomização em inquérito de exemplo do ExpressionScript.

Valores válidos

Basta inserir qualquer texto de sua preferência (por exemplo: 'group1'). Todas as perguntas que tiverem o mesmo texto definido na caixa Nome do grupo de randomização terão sua posição no inquérito randomizada (=trocada aleatoriamente entre si).

Pre-visualização Para pré-visualizar as perguntas, use a função Visualizar questionário em vez de Pré-visualizar o grupo de perguntas, pois há relatos de que esta última não exibe as perguntas em ordem randomizada.

Fórmula de validação da pergunta (em_validation_q)

Descrição

Esta é uma fórmula usada para validar a pergunta inteira (por exemplo, todas as suas partes em conjunto, no caso de uma pergunta de múltiplas respostas). Se a pergunta não atender aos critérios de validação, a mensagem em_validation_q_tip será exibida (ela usa o estilo CSS .error). Esta dica usa o estilo CSS .em_q_fn_validation, que fica oculto por padrão em template.css.

A principal diferença entre este recurso e as fórmulas de validação de pergunta secundária (opção em_validation_sq) é que, neste recurso, se a pergunta (ou partes dela) falhar na validação, uma mensagem de erro pode ser exibida. Na validação de pergunta secundária, cada célula de entrada de texto (por exemplo, em um tipo de pergunta de array, mas também pode ser aplicada a tipos de pergunta de entrada única) receberá um estilo em que a cor de fundo fica vermelha (clara).

Valores válidos

• Qualquer fórmula que use a sintaxe do ExpressionScript, sem chaves ao redor.

Exemplo

• Você deseja coletar informações demográficas dos usuários por meio de uma pergunta de Texto curto múltiplo e deseja validar se o usuário informou um e-mail e um número de telefone válidos.

Este exemplo mostra como a pergunta aparece com respostas inválidas:

E aqui está como ela aparece com uma resposta inválida:

Veja como editar uma pergunta para inserir essas informações:

E aqui está parte da saída do arquivo Show Logic, que permite verificar a precisão da sua expressão e garantir que não haja erros de sintaxe:

Como você pode ver, a fórmula de validação testa se o e-mail e o número de telefone estão vazios ou correspondem a um filtro de expressão regular.

A dica de validação só exibe a mensagem de aviso se o telefone ou o e-mail parecer inválido.

 Hint: Para criar mensagens de validação complexas, leia sobre o uso do ExpressionScript.

Se quiser importar o exemplo acima para a sua instalação do LimeSurvey, baixe o seguinte arquivo .lsq: Em_validation_q_example.zip.

 Hint: Lembre-se: o LimeSurvey usa a sintaxe Perl para expressões regulares, portanto elas devem começar e terminar com / (caractere de barra)!

Dica para a fórmula de validação da pergunta inteira (em_validation_q_tip)

Descrição

Se você estiver usando a fórmula de validação da pergunta, pode usar esta caixa para exibir uma mensagem opcional como dica da pergunta sobre como ela deve ser preenchida.

Valores válidos

• Qualquer texto ou fórmula que use a sintaxe do ExpressionScript.

Exemplo

Veja o exemplo na seção da wiki sobre a fórmula de validação da pergunta. Ele mostra como a dica pode ser adaptada para indicar quais partes de uma pergunta do tipo Texto curto múltiplo não atendem aos critérios de validação.

Fórmula de validação da pergunta secundária (em_validation_sq)

Descrição

Esta é uma fórmula usada para validar cada pergunta secundária (campo de texto) individualmente. Qualquer campo de texto que não atenda a essas condições de validação terá a cor de fundo alterada para rosa (usando o estilo CSS .em_sq_fn_validation) para destacar o erro. Observe que essa opção está disponível além da opção de validação baseada em expressão regular.

Valores válidos

Qualquer fórmula que use a sintaxe do ExpressionScript, sem chaves ao redor.

Exemplos

Por exemplo, se você quiser permitir como respostas apenas números que sejam múltiplos de 3, a fórmula seria:

(this / 3) == floor(this/3)

A variável reservada this é substituída automaticamente por uma referência à célula de entrada de texto ativa.

Dica para a fórmula de validação de subpergunta (em_validation_sq_tip)

Descrição

Se você estiver usando em_validation_sq, esta é uma mensagem/dica opcional que será exibida se a resposta informada estiver incorreta.

Valores válidos

• Qualquer texto

Exemplo

• Continuando o exemplo de validação de e-mails, a dica pode ser "Insira endereços de e-mail válidos."

Outros

Inserir quebra de página na visualização para impressão (page_break)

Descrição

Este atributo só fica ativo quando você realmente imprime um inquérito a partir da Visualização para impressão. Ele força uma quebra de página antes da pergunta.

Opções disponíveis

• Ligado
• Desligado (padrão)

Estatísticas

Apresentar nas estatística públicas (public_statistics)

Descrição

Este atributo permite que o administrador do inquérito escolha se os resultados de uma determinada pergunta devem ser exibidos aos participantes do questionário depois que eles enviarem o inquérito.

Nota: Para que as estatísticas sejam exibidas na última página, não se esqueça de ativar essa funcionalidade nas configurações de apresentação e navegação. Caso contrário, nenhuma hiperligação para as estatísticas será exibida no final do seu inquérito.

A configuração padrão de cada pergunta é 'Desligado' (=Não mostrar as estatísticas da pergunta aos respondentes). Você precisa ativar essa opção para cada pergunta individualmente, caso queira exibir as estatísticas do inquérito dessa(s) pergunta(s) específica(s) aos Participantes do questionário após o envio do inquérito.

Opções disponíveis

• Ligado
• Desligado (padrão)

Exibir gráfico (display_chart)

Descrição

Este atributo permite que o administrador do inquérito escolha se um gráfico com os resultados da pergunta deve ser exibido aos participantes do questionário após eles preencherem o inquérito.

Nota: Para que o gráfico seja exibido na última página, você deve ativar as seguintes opções:

• Configuração de inquérito Estatísticas públicas em Configurações de apresentação e navegação
• Configuração de inquérito Mostrar gráficos em Configurações de apresentação e navegação
• Atributo de pergunta Estatísticas públicas e
• atributo de pergunta Exibir gráfico.

Opções disponíveis

• Ativado
• Desativado (padrão)

Tipo de gráfico (chart_type)

Descrição

Este atributo permite que o administrador do inquérito escolha qual tipo de gráfico será exibido ao respondente após ele concluir o preenchimento do inquérito.

Nota: Não se esqueça de alterar as configurações da pergunta e as configurações do questionário para que os gráficos sejam exibidos no final do inquérito. Para mais detalhes, consulte a seção da wiki sobre o atributo de pergunta Exibir gráfico.

Opções disponíveis

• Gráfico de barra
• Gráfico de pizza
• Radar
• Linha
• Área polar
• Rosca