Tipo de pergunta - Data

Descrição breve

Este tipo de pergunta pode ser usado para solicitar uma data, uma hora ou uma combinação de data e hora. Os participantes podem selecionar os valores em um calendário popup ou em caixas de lista suspensa. O administrador do inquérito pode definir a validação e as datas mínima e/ou máxima. Vários formatos de data e hora são suportados.

Exemplo: Example_Date_Time.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

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

Exibir caixas de lista suspensa (dropdown_dates)

Descrição

Se ativada, a pergunta do tipo data/hora exibirá aos participantes uma caixa de lista suspensa para escolher a data/hora, em vez do popup padrão.

Opções disponíveis

• Ligado
• Desligado (padrão)

Exemplo

Se a opção estiver ativada, a pergunta será exibida da seguinte maneira:

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).

Estilo de exibição do mês (month_display_style)

Descrição

Os meses podem ser exibidos aos participantes de três maneiras: usando seus nomes curtos (Jan, Fev, etc.), nomes completos (Janeiro, Fevereiro, etc.) ou o número/posição do mês no calendário anual (01 para janeiro, 02 para fevereiro e assim por diante).

Opções disponíveis

• Nomes curtos
• Nomes completos
• Números

Inverter a ordem das respostas (reverse)

Descrição

Se ativada, a ordem das respostas será invertida.

Opções disponíveis

• Ligado
• Desligado (padrão)

Exemplo

Suponha que você queira usar o tipo de pergunta Matriz (Números). Se esta opção estiver desativada (valor padrão), as respostas possíveis que um participante do inquérito pode selecionar são: "1, 2, 3, ... , 10". Se estiver ativada, a configuração inverterá a ordem das respostas disponíveis: "10, 9, 8, ... , 1".

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.

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.

Data mínima (date_min)

Descrição

Este atributo de pergunta pode ser usado para definir o valor mínimo de uma pergunta de data (no formato y-m-d ou em qualquer string válida em inglês - veja mais detalhes abaixo). Ele pode ser usado tanto nas opções de exibição em popup quanto em lista suspensa. Se uma data mínima não for definida, será usada como padrão 1.1.1900.

  A opção de validação do Gerenciador de Expressões também pode ser usada para definir uma "data mínima". No entanto, se você usar o calendário em popup e a expressão depender de uma pergunta anterior localizada na mesma página, o ano não será exibido corretamente no calendário em popup.

Valores válidos

• Qualquer valor de data no formato AAAA-MM-DD (por exemplo, 2017-08-24);
• Qualquer valor de ano;
• Qualquer string em inglês : "now", "-10 years", "tomorrow";
• Referência a outra pergunta de data/hora : AnotherDateQuestion (usando o código da pergunta);
• Expressões : Com expressões, uma data mínima pode ser calculada dinamicamente. Por exemplo, você pode usar a data de uma resposta anterior + 3 dias como mínimo para a pergunta atual, inserindo: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Data máxima (date_max)

Descrição

Este atributo de pergunta pode ser usado para definir o valor máximo da pergunta de data (no formato a-m-d ou em qualquer outra string válida em inglês - veja abaixo mais opções). Ele pode ser usado tanto nas opções de exibição em popup quanto em lista suspensa.

  A opção de validação do Expression Manager também pode ser usada para definir uma "data máxima". No entanto, se você usar o calendário em popup e a expressão depender de uma pergunta anterior localizada na mesma página, o ano não será exibido corretamente no calendário em popup.

Valores válidos

• Qualquer valor de data no formato AAAA-MM-DD (por exemplo, 2018-08-24);
• Qualquer valor de ano;
• Qualquer string em inglês: "now", "-10 years", "tomorrow";
• Referência a outra pergunta de data/hora: AnotherDateQuestion (usando o código da pergunta);
• Expressões: com expressões, uma data pode ser calculada dinamicamente. Por exemplo, você pode usar a data de uma resposta anterior + 3 dias como data máxima para a pergunta atual, inserindo: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

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

Formato de Data/Hora

Descrição

Esta opção da pergunta pode ser usada para especificar um formato de data personalizado. Se estiver vazia, será usado o formato de data do inquérito.

Valores válidos

• Os formatos d/dd, m/mm, yy/yyyy, H/HH, M/MM podem ser usados para exibir a data e/ou a hora, enquanto "-", ".", "/", ":" podem ser usados como separadores.

Exemplos

• yyyy-mm-dd - ano-mês-dia;
• dd.mm.yyyy HH:MM - dia.mês.ano Hora:Minuto;
• HH:MM - Hora:Minuto (somente a hora pode ser selecionada);
• yyyy/mm - ano/mês.

Incremento de intervalo em minutos (minute_step_interval)

Descrição

 Hint: This feature changed with version 3.14.12

É usado somente quando o formato de entrada utiliza minutos ("MM").

Valores válidos

• Qualquer valor numérico menor que 60. Adicionar um valor maior que 60 é redundante -> somente "0" ou "00" serão exibidos como respostas possíveis na caixa suspensa.

Exemplo

No exemplo abaixo, a opção Incremento de intervalo em minutos foi definida como 7:

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.

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

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

Datas e ExpressionScript: validação e cálculo avançados

O LimeSurvey (versões 2.05 e superiores) facilita bastante a validação de datas usando os campos date_min e date_max (veja acima). Use-os sempre que possível. Se precisar de uma validação mais avançada, você poderá trabalhar (e calcular) com datas usando o ExpressionScript e a função strtotime(). Ela calcula o número de segundos desde 1º de janeiro de 1970 até uma determinada data.

Exemplo: se você quiser exibir no texto de uma pergunta o número de dias que se passaram entre uma data de partida (informada em uma pergunta anterior) e hoje, pode usar a expressão {(strtotime("now")-strtotime(departure))/60/60/24}.

Lembre-se de que strtotime() funciona com muitos formatos diferentes, mas não com todos! Por exemplo, o formato de data padrão do LimeSurvey (MM-DD-YYYY) NÃO funciona com strtotime(). Configure seu inquérito para usar um dos seguintes formatos de data para evitar problemas: YYYY-MM-DD, YYYY/MM/DD, DD.MM.YYYY, MM/DD/YYYY ou DD-MM-YYYY.

  As datas no LimeSurvey são salvas como string (formato de texto). O ExpressionScript converte todas as datas que fazem parte de uma expressão para o formato padrão "yyyy-mm-dd HH:MM:SS". Isso facilita muito a comparação de datas em uma expressão (por exemplo, "date1>date2"). Se precisar de uma string de data no formato em que foi solicitada na pergunta, use o atributo ".shown" (por exemplo: Você nasceu em {birthdate.shown}.)