Tipo de pergunta - Matriz (Textos)
From LimeSurvey Manual
Descrição breve
O tipo de pergunta Matriz (Textos) permite uma matriz de caixas de texto com um conjunto de perguntas secundárias como "eixo y" e outro conjunto de perguntas secundárias como "eixo x".
Exemplo: Array_Texts_Example_text.zip
Você também pode limitar este tipo de pergunta para permitir apenas respostas numéricas (consulte o atributo de pergunta "Entrada deve ser numérica apenas") e usar "Mostrar totais" para habilitar a exibição de totais de linhas, colunas ou ambos:
Exemplo: Array Texts Example text numbers.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.
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.
Exibição
Largura da (sub)pergunta (subquestion_width)
Descrição
Este valor define a largura da coluna da pergunta secundária usando um sistema de porcentagem. Por exemplo, se você definir o valor como 60, 60% da largura da pergunta será usado para o texto da pergunta secundária (a coluna mais à esquerda). A largura restante será dividida igualmente entre as opções de resposta.
Valores válidos
- Qualquer número inteiro de 1 a 100.
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).
Ordem aleatória das respostas (random_order)
Descrição
Obsoleto para Opções de resposta : A partir da versão 5.5.0, este atributo não é mais usado para ordenar as opções de resposta. Consulte Ordem das respostas
Este atributo faz com que o LimeSurvey ignore a ordem existente das opções de resposta/subperguntas e as ordene aleatoriamente. Esta opção permite que o criador do inquérito diminua o viés do inquérito. Observe que, se uma pergunta tiver subperguntas, a ordem das subperguntas será aleatória, e não a ordem das opções de resposta.
Opções disponíveis
- Sim - Aleatorizar quando o participante entrar no inquérito
- Não (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
Repetir cabeçalhos (repeat_headers)
Descrição
Esta opção pode ser usada se você adicionar um grande número de subperguntas a uma pergunta. Nesse caso, use esta opção para informar ao LimeSurvey após quantas subperguntas os cabeçalhos devem ser repetidos.
Valores válidos
- Qualquer número inteiro;
- O valor padrão é 0 - a função repetir cabeçalhos fica desativada.
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.
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.
Entrada
Máximo de caracteres de entrada (input_max_characters)
Descrição
A opção a seguir permite digitar um valor numérico que representará o número máximo de caracteres que os respondentes do inquérito podem inserir na(s) caixa(s) de texto de resposta da respectiva pergunta.
Valores válidos
- Qualquer valor numérico
Exemplo
- Se você deseja que os participantes do questionário digitem uma resposta curta e concisa, informe no campo Máximo de caracteres um número pequeno (por exemplo, 10-15).
Lógica
Mínimo de respostas (min_answers)
Descrição
Esta função pode ser usada para garantir que o usuário selecione pelo menos um determinado número de respostas em uma pergunta de múltipla escolha.
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 as chaves ao redor.
Exemplo
Se definido como X (um número qualquer), os usuários podem enviar o formulário do inquérito se selecionarem pelo menos X caixas de seleção. Se esta opção for utilizada em perguntas de classificação, isso garante que pelo menos três itens sejam classificados antes de permitir que o participante envie as respostas/o inquérito.
Observe que, se você usar este atributo com perguntas de classificação, é necessário definir a pergunta como não obrigatória. Caso contrário, todos os itens precisarão ser classificados, o que é contraintuitivo se você decidir usar também a função min_answers.
Máximo de respostas (max_answers)
Descrição
Pode ser usado para limitar o número total de respostas que um usuário pode selecionar em uma pergunta de múltipla escolha.
Valores válidos
- Qualquer valor numérico
- 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.
Exemplo
Se definido como 2, o usuário poderá marcar no máximo duas caixas de seleção ou uma caixa de seleção + preencher o campo "Outros" (se houver). Para o tipo de pergunta Ranking, o participante poderá selecionar no máximo dois itens.
Filtro da matriz (array_filter)
Descrição
A configuração Filtro da matriz permite usar qualquer pergunta de múltipla escolha para selecionar ou definir quais respostas serão exibidas em uma pergunta subsequente do tipo lista, matriz ou múltipla escolha.
- Múltipla escolha
- Múltipla escolha com comentário
- Texto curto múltiplo
- Numérico múltiplo
- Matriz (5 pontos, 10 pontos, Sim/Não/Não sei, Aumentar/Igual/Diminuir, Coluna)
- Matriz (Dois níveis, Texto, Números)
- Classificação
Além disso, cada um desses tipos de pergunta pode ser filtrado.
A única exceção é Matriz (Coluna), que pode filtrar outras perguntas, mas não a si mesma.Como definir um filtro
Para definir um filtro, insira o código da pergunta de múltiplas opções no campo do filtro da matriz da pergunta que você está editando. A pergunta indicada será usada como fonte de informação para a pergunta atual: as respostas selecionadas na pergunta anterior são recuperadas e usadas como opções de resposta da pergunta atual. Por exemplo, se o código da sua pergunta de múltiplas opções de origem for "Q1", insira "Q1" no campo 'Filtro da matriz' para iniciar o processo de filtragem das respostas. Somente as opções de resposta selecionadas na pergunta Q1 ficarão visíveis na pergunta filtrada com array_filter.
Os códigos das perguntas secundárias usados na primeira pergunta devem coincidir com os códigos das perguntas secundárias da segunda. Caso contrário, a função Filtro da matriz não filtrará as respostas da primeira pergunta. Observação: quando quiser filtrar a opção de resposta "other" da primeira pergunta, você precisa incluir uma pergunta secundária para essa resposta na segunda pergunta, e o código dessa pergunta secundária deve ser "other". Veja o exemplo abaixo para entender melhor como todo o sistema funciona.
Cascata
As opções selecionadas podem ser exibidas em cascata. Isso significa que você pode selecionar uma pergunta que filtra outra pergunta, que por sua vez filtra outra pergunta, e assim por diante.
Exemplo de filtro da matriz
Vejamos o exemplo a seguir para entender melhor o poder dessa configuração:
Na captura de tela acima, temos duas perguntas. A primeira é do tipo texto curto múltiplo, enquanto a segunda é do tipo matriz de dois níveis. As respostas fornecidas na primeira pergunta serão listadas na segunda. Tecnicamente, as respostas dadas às perguntas secundárias da primeira pergunta são filtradas e exibidas na segunda pergunta.
Este exemplo pode ser baixado a partir da seguinte hiperligação: limesurvey_group_32.lsg. Importe este grupo de questões para a sua instalação do LimeSurvey.
Exclusão do filtro de array (array_filter_exclude)
Descrição
A configuração Exclusão do filtro de array permite usar qualquer pergunta de múltipla escolha para selecionar ou definir quais respostas NÃO serão exibidas em uma pergunta subsequente do tipo lista, matriz ou múltipla escolha.
- Múltipla escolha
- Múltipla escolha com comentário
- Texto curto múltiplo
- Numérico múltiplo
- Matriz (5 pontos, 10 pontos, Sim/Não/Não sei, Aumentar/Igual/Diminuir, Por coluna)
- Matriz (Escala dupla, Texto, Números)
- Classificação
Além disso, cada um desses tipos de pergunta pode ser filtrado.
A única exceção é Matriz por coluna, que pode filtrar outras perguntas, mas não pode ser filtrada.Como configurar
Insira o código da pergunta de uma pergunta de múltiplas opções na caixa Exclusão do filtro de array da pergunta que você está editando. Essa pergunta será usada como fonte de informação para a pergunta atual: as respostas não selecionadas na pergunta anterior serão recuperadas e usadas como opções de resposta da pergunta atual. Por exemplo, se o código da sua pergunta de múltiplas opções de origem for "Q1", insira "Q1" na caixa 'Exclusão do filtro de array' para iniciar o processo de filtragem das respostas. Somente as opções de resposta que NÃO forem selecionadas na pergunta Q1 ficarão visíveis na sua pergunta.
Os códigos das perguntas secundárias usados na primeira pergunta devem coincidir com os códigos das perguntas secundárias da segunda. Caso contrário, a função de exclusão do filtro de array não filtrará as respostas da primeira pergunta. Confira o exemplo abaixo para entender melhor como todo o sistema funciona.
Cascata
As opções selecionadas podem ser exibidas em cascata. Isso significa que você pode selecionar uma pergunta que filtra outra pergunta, que por sua vez filtra outra pergunta, e assim por diante.
Exemplo
Vejamos juntos o exemplo abaixo:
Na captura de tela acima, temos duas perguntas. A primeira é do tipo múltipla escolha, enquanto a segunda é do tipo múltipla escolha com comentário. As respostas fornecidas na primeira pergunta serão excluídas da segunda. Por exemplo, se você selecionar a opção ComfortUpdate (que tem o código de pergunta secundária 'SQ1') e a opção Plugin ('SQ4'), as perguntas secundárias correspondentes 'SQ1' e 'SQ4' da segunda pergunta serão excluídas. Em nossa captura de tela, podemos observar que somente as opções não selecionadas na primeira pergunta são exibidas na segunda.
Este exemplo pode ser baixado no seguinte link: Limesurvey_group_array_filter_exclude.zip. Importe este grupo de questões para a sua instalação do LimeSurvey.
Estilo de filtro da matriz (array_filter_style)
Descrição
Esta função permite escolher como as subperguntas filtradas da matriz são exibidas. Elas podem ser "ocultadas" ou "desabilitadas".
Para aprender como filtrar subperguntas, leia a seguinte seção da wiki.Opções disponíveis
- Ocultar (padrão) - se esta opção for selecionada, as subperguntas selecionadas anteriormente não serão exibidas na segunda pergunta.
- Desabilitado - se esta opção for selecionada, as subperguntas selecionadas anteriormente ficarão acinzentadas e não poderão ser selecionadas.
Exemplo
Se você quiser usar a opção "Desabilitado", as subperguntas selecionadas anteriormente serão exibidas assim:
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)
Entrada deve ser numérica apenas (numbers_only)
Descrição
Se você ativar esta opção, o participante poderá inserir apenas números na(s) caixa(s) de texto.
Para os tipos de pergunta Fórmula, esta configuração indica que o resultado só pode ser um número, e não uma string. Isso garante cálculos/conversões corretos em fórmulas subsequentes no que diz respeito à marca decimal.
Comportamento por tipo de pergunta
- Padrão: Se o participante inserir um valor que não seja um número, esse valor será imediatamente apagado da caixa de texto para que o participante possa inserir um valor apropriado.
- Matriz (Textos): Se a opção Entrada deve ser numérica apenas estiver desativada, as opções "Mostrar totais para" e "Mostrar o total de grand" serão ignoradas e as caixas de texto de total não serão exibidas.
- Fórmula: Ativar esta opção forçará a conversão dos resultados da fórmula em um valor numérico. Se o resultado da fórmula não for um número (e não estiver em branco), a fórmula retornará NaN, sendo salvo como uma string vazia na tabela de respostas.
Opções disponíveis
- Ligado
- Desligado (padrão)
Mostrar totais para (show_totals)
Descrição
Se ativada, serão exibidos os totais das linhas, das colunas ou de ambas.
Os totais são exibidos somente se a opção Entrada deve ser numérica apenas estiver ativada.Opções disponíveis
- Desligado (padrão)
- Linhas
- Colunas
- Linhas & colunas
Exemplo
Mostrar o total de grand (show_grand_total)
Descrição
Se ativado, o total geral das colunas (ou linhas) será exibido na parte inferior direita do array.
O total geral é exibido somente se a opção Entrada deve ser numérica apenas estiver ativada.Opções disponíveis
- Ligado
- Desligado (padrão)
Exemplo
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