Tipo de pergunta - Data

Descrição breve

Este tipo de pergunta pode ser utilizado para pedir uma data, uma hora ou uma combinação de data e hora. Os participantes podem selecionar os valores a partir de um calendário popup ou de listas de seleção. O administrador do inquérito pode definir a validação, 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 inquiridos respondam a determinadas perguntas do inquérito. Se as perguntas obrigatórias não forem respondidas, os inquiridos não poderão avançar. Se tiver uma pergunta com várias subperguntas e pretender que apenas algumas delas sejam respondidas, utilize o atributo de resposta mínima localizado no separador Lógica.

Se utilizar qualquer um dos temas pré-instalados e o atributo de pergunta obrigatória estiver ativado, será apresentado um asterisco vermelho junto à pergunta. Se pretender ocultá-lo, consulte estas instruções.

Opções disponíveis

• Ativada - A pergunta tem de ser respondida antes de o participante poder avançar para a página seguinte - a opção de resposta 'Sem resposta' nunca é apresentada.
• Suave - Se a pergunta não for respondida, é apresentado um aviso ao tentar avançar para a página seguinte - no entanto, o participante pode optar por ignorar o aviso e continuar. Note que a opção 'Sem resposta' continua a ser apresentada (se estiver ativada nas definições de apresentação do inquérito)
• Desativada (predefiniçã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, é apresentada 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 funcionalidade é a sucessora das condições e suporta uma lógica condicional muito mais complexa.

Realce de sintaxe

Sempre que guardar a condição, esta é avaliada e a sintaxe é realçada. Quaisquer erros são assinalados com cores, para que possa detetá-los e corrigi-los rapidamente.

 Hint: Para verificar se todas as condições são utilizadas corretamente no seu inquérito, leia sobre a nossa funcionalidade mostrar ficheiro de lógica.

Valores válidos

• Qualquer condição que utilize a sintaxe do ExpressionScript, sem chavetas à volta.

Exemplos

Eis bons exemplos de realce de sintaxe.

Apresentação

Mostrar listas de seleção (dropdown_dates)

Descrição

Se ativada, a pergunta do tipo de pergunta data/hora mostrará aos participantes uma lista de seleção para escolher a data/hora, em vez do popup predefinido.

Opções disponíveis

• Ligado
• Desligado (predefinição)

Exemplo

Se estiver ativada, a pergunta será apresentada da seguinte forma:

Esconder sugestão (hide_tip)

Descrição

A maioria das perguntas inclui normalmente uma sugestão que diz "Por favor, selecione uma das seguintes opções" ou um texto de ajuda sobre como responder à pergunta. Este atributo permite ativar ou desativar estas sugestões.

Estas sugestões incluem mensagens de critérios de validação (como o número mínimo/máximo de respostas ou o valor mínimo/máximo/Igual ao valor da soma). Se hide_tip estiver ativado, estas mensagens ficarão escondidas. No entanto, se o utilizador introduzir dados inválidos, as sugestões serão apresentadas. Serão apresentadas a vermelho e mudarão para verde quando os critérios de validação forem cumpridos.

Opções disponíveis

• Ligado - as sugestões ficam escondidas;
• Desligado (predefinição).

Estilo de apresentação dos meses (month_display_style)

Descrição

Os meses podem ser apresentados aos participantes de três formas: através dos nomes curtos (Jan, Fev, etc.), dos nomes completos (janeiro, fevereiro, etc.) ou do número/posição do mês no calendário anual (01 para janeiro, 02 para fevereiro, e assim sucessivamente).

Opções disponíveis

• Nomes curtos
• Nomes completos
• Números

Ordem de respostas inversa (reverse)

Descrição

Se ativada, a ordem das respostas será invertida.

Opções disponíveis

• Ligado
• Desligado (por defeito)

Exemplo

Imagine que pretende utilizar o tipo de pergunta Matriz (Números). Se esta opção estiver desativada (valor por defeito), as respostas possíveis que um participante do inquérito pode selecionar são: "1, 2, 3, ... , 10". Se estiver ativada, a definição inverte a ordem das respostas disponíveis: "10, 9, 8, ... , 1".

Tema da pergunta (question_theme)

Descrição

Permite utilizar temas personalizados para a respetiva pergunta.

Opções disponíveis

• Os temas de pergunta que criou, localizados em Temas de perguntas no painel Temas.

Ver: Temas de perguntas

Nota: Esta funcionalidade encontra-se atualmente em desenvolvimento.

Ocultar sempre esta pergunta (hidden)

Descrição

Se esta opção estiver ativada, a pergunta será sempre ocultada e não será apresentada aos participantes no inquérito. Esta função pode ser utilizada nos seguintes cenários:

• Se pretender preencher previamente uma pergunta através de um URL e não quiser que a mesma seja apresentada no ecrã. Isto substitui quaisquer condições utilizadas no inquérito, uma vez que a respetiva pergunta nem sequer será incorporada na página.
• Se pretender guardar ou calcular um valor em tempo real através do ExpressionScript.

Nota: Um tipo de pergunta comum utilizado com esta função é o tipo Equação.

Opções disponíveis

• Ativado
• Desativado (predefinição)

Classe CSS (css_class)

Descrição

Se quiser adicionar classes CSS especiais a determinadas perguntas, pode introduzir o(s) nome(s) da classe CSS nesta caixa. Certifique-se de que deixa um espaço em branco entre os diferentes nomes de classes.

Valores válidos

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

 Hint: Também pode inserir uma expressão nesta caixa ^{(New in 3.0.0 )}. Lembre-se de que o resultado da expressão não será atualizado dinamicamente.

  Segundo o W3C, os nomes das classes CSS só podem conter 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 (_). Não podem começar por um dígito, nem por um hífen seguido de um dígito. O LimeSurvey codifica as classes CSS, mas não corrige totalmente este problema.

Data mínima (date_min)

Descrição

Este atributo da pergunta pode ser utilizado para definir o valor mínimo de uma pergunta de data (no formato a-m-d ou qualquer cadeia de caracteres válida em inglês - veja mais detalhes abaixo). Pode ser utilizado nas opções de visualização em popup e em lista pendente. Se não for definida uma data mínima, é utilizada por predefinição a data 1.1.1900.

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

Valores válidos

• Qualquer valor de data no formato AAAA-MM-DD (p. ex., 2017-08-24);
• Qualquer valor de ano;
• Qualquer cadeia de caracteres em inglês : "now", "-10 years", "tomorrow";
• Referência a outra pergunta de data/hora : AnotherDateQuestion (utilizando o código da pergunta);
• Expressões : Com expressões, é possível calcular dinamicamente uma data mínima. Por exemplo, pode utilizar uma data de uma resposta anterior + 3 dias como mínimo para a pergunta atual, introduzindo: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Data máxima (date_max)

Descrição

Este atributo da pergunta pode ser utilizado para definir o valor máximo da pergunta de data (no formato a-m-d ou em qualquer outra cadeia de caracteres válida em inglês - veja abaixo mais opções). Pode ser utilizado tanto nas opções de visualização em popup como em lista pendente.

  A opção de validação do Expression Manager também pode ser utilizada para definir uma "data máxima". No entanto, se utilizar o calendário em popup e a expressão depender de uma pergunta anterior localizada na mesma página, o ano não será apresentado 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 cadeia de caracteres em inglês: "now", "-10 years", "tomorrow";
• Referência a outra pergunta de data/hora: AnotherDateQuestion (utilizando o código da pergunta);
• Expressões: com expressões, uma data pode ser calculada dinamicamente. Por exemplo, pode utilizar a data de uma resposta anterior + 3 dias como data máxima para a pergunta atual, introduzindo: date("Y-m-d",strtotime(departuredate)+3*60*60*24).

Ajuda de relevância para a versão de impressão do inquérito (printable_survey_relevance_help)

Descrição

Se desejar imprimir um inquérito, também pode imprimir as equações de relevância de cada pergunta. No entanto, se preferir apresentar 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úmeros que deseje que sejam apresentados no formulário para impressão.

Entrada

Formato da data/hora

Descrição

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

Valores válidos

• Os formatos d/dd, m/mm, yy/yyyy, H/HH, M/MM podem ser utilizados para apresentar a data e/ou a hora, enquanto "-", ".", "/", ":" podem ser utilizados 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 (só é possível selecionar a hora);
• yyyy/mm - ano/mês.

Intervalo de minutos (minute_step_interval)

Descrição

 Hint: This feature changed with version 3.14.12

É utilizado apenas quando o formato de entrada utiliza minutos ("MM").

Valores válidos

• Qualquer valor numérico inferior a 60. Adicionar um valor superior a 60 é redundante -> apenas "0" ou "00" será apresentado na caixa pendente como resposta possível.

Exemplo

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

Lógica

Nome do grupo com aleatoriedade (random_group)

Descrição

Coloca as perguntas num grupo de randomização especificado. Todas as perguntas incluídas nesse grupo são apresentadas aos participantes do inquérito numa ordem aleatória.

Pode pesquisar um inquérito de exemplo que utiliza o nome do grupo de randomização em inquérito de exemplo de ExpressionScript.

Valores válidos

Introduza apenas qualquer cadeia de caracteres que pretenda (por exemplo: 'group1'). Todas as perguntas que tiverem a mesma cadeia de caracteres definida na caixa Nome do grupo com aleatoriedade terão a sua posição no inquérito aleatorizada (=trocada aleatoriamente entre si).

Pré-visualizar Para pré-visualizar as perguntas, utilize a função Pré-visualizar inquérito em vez da função Pré-visualizar o grupo de perguntas, pois foi reportado que esta última não apresenta as perguntas numa ordem aleatória.

Validação da equação da pergunta (em_validation_q)

Descrição

Esta é uma equação utilizada para validar a pergunta completa (por exemplo, todas as suas partes em conjunto, no caso de uma pergunta de resposta múltipla). Se a pergunta não cumprir os critérios de validação, será apresentada a mensagem em_validation_q_tip (que utiliza o estilo CSS .error). Esta dica utiliza o estilo CSS .em_q_fn_validation, que está oculto por predefinição em template.css.

A principal diferença entre esta funcionalidade e as equações de validação de perguntas secundárias (opção em_validation_sq) é que, nesta funcionalidade, se a pergunta (ou partes da pergunta) falhar a validação, pode ser apresentada uma mensagem de erro. Na validação de perguntas secundárias, cada célula de entrada de texto (por exemplo, num tipo de pergunta tabela, mas também pode ser aplicada a tipos de pergunta de entrada única) será estilizada de modo a que a cor de fundo seja vermelho (claro).

Valores válidos

• Qualquer equação que utilize a sintaxe do ExpressionScript, sem chavetas à volta.

Exemplo

• Pretende recolher informações demográficas dos utilizadores através de uma pergunta de textos curtos múltiplos e quer validar se o utilizador introduziu um endereço de email e um número de telefone válidos.

Este exemplo mostra o aspeto da pergunta com respostas inválidas:

E este é o aspeto com uma resposta inválida:

Eis como editar uma pergunta para introduzir essa informação:

E aqui está parte do resultado do Show Logic File, que permite verificar a exatidão da sua expressão e garantir que não existem erros de sintaxe:

Como pode ver, a equação de validação verifica se o endereço de email e o número de telefone estão vazios ou correspondem a um filtro de expressão regular.

A dica de validação só mostra a mensagem de aviso se o telefone ou o email parecerem inválidos.

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

Se desejar importar o exemplo acima para a sua instalação do LimeSurvey, transfira o seguinte ficheiro .lsq: Em_validation_q_example.zip.

 Hint: Lembre-se: o LimeSurvey utiliza a sintaxe Perl para expressões regulares, pelo que estas devem começar e terminar com / (caractere barra)!

Sugestão para a equação de validação da pergunta completa (em_validation_q_tip)

Descrição

Se estiver a utilizar a equação de validação da pergunta, pode utilizar esta caixa para apresentar uma mensagem opcional como dica da pergunta sobre como esta deve ser preenchida.

Valores válidos

• Qualquer cadeia de caracteres ou equação que utilize a sintaxe do ExpressionScript.

Exemplo

Consulte o exemplo da secção da wiki sobre a equação de validação da pergunta: mostra como a dica pode ser adaptada para indicar quais as partes de uma pergunta de Textos curtos múltiplos que não cumprem os critérios de validação.

Outros

Inserir uma quebra de página em vista de impressão (page_break)

Descrição

Este atributo só está ativo quando imprime efetivamente um inquérito a partir da Visualização para impressão. Força uma quebra de página antes da pergunta.

Opções disponíveis

• Ligado
• Desligado (predefinição)

Estatísticas

Mostrar gráfico (display_chart)

Descrição

Este atributo permite ao administrador do inquérito escolher se um gráfico com os resultados da pergunta deve ser apresentado aos participantes no inquérito depois de estes terem preenchido o inquérito.

Nota: Para que o gráfico seja apresentado na última página, tem de ativar as seguintes opções:

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

Opções disponíveis

• Ligado
• Desligado (predefinição)

Tipo de gráfico (chart_type)

Descrição

Este atributo permite ao administrador do inquérito escolher o tipo de gráfico que será apresentado ao participante depois de este concluir o preenchimento do inquérito.

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

Opções disponíveis

• Gráfico de barras
• Circular
• Radar
• Linha
• Área polar
• Rosca

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

O LimeSurvey (versões 2.05 e superiores) torna relativamente fácil validar datas através dos campos Data mínima e Data máxima (ver acima). Utilize-os sempre que possível. Se precisar de uma validação mais avançada, poderá trabalhar (e calcular) com datas utilizando o ExpressionScript e a função strtotime(). Esta função calcula o número de segundos desde 1 de janeiro de 1970 até uma determinada data.

Exemplo: se quiser apresentar no texto de uma pergunta o número de dias decorridos entre uma data de partida (indicada numa pergunta anterior) e hoje, pode utilizar a expressão {(strtotime("now")-strtotime(departure))/60/60/24}.

Tenha em atenção que a função strtotime() funciona com muitos formatos diferentes, mas não com todos! Por exemplo, o formato de data predefinido do LimeSurvey (MM-DD-YYYY) NÃO funciona com strtotime(). Configure o seu inquérito para utilizar 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 guardadas como cadeia de caracteres (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". Isto torna muito mais fácil comparar datas numa expressão (p. ex. "date1>date2"). Se precisar de uma cadeia de caracteres de data no formato em que foi pedida na pergunta, utilize o atributo ".shown" (p. ex.: Nasceu em {birthdate.shown}.)