======== MANUAL LimeSurvey - Complemento ======== ===== 1. Barra de ferramentas administrativas ===== \\ ===== 2. Estrutura do questionário ===== \\ ===== 3. Criando um questionário ===== ==== 3.1. Geral ==== **Idioma base:** Define o idioma base do questionário. É possível desenvolver pesquisas em diversos idiomas. Uma vez escolhido e salvo, não é possível mais alterar o idioma base. Além disso, existe a possibilidade de se definir os idiomas adicionais para possíveis traduções do questionário, mas isso tal opção não é mostrada no momento de sua criação. Idiomas adicionais só podem ser adicionados ou removidos posteriormente, através da edição das configurações gerais. É importante lembrar que, quando um idioma é removido de um questionário, todo o conteúdo referente a ele também é apagado permanentemente. **Título:** Nome do questionário que dê uma ideia do que se trata. Ex.: “1ª Pesquisa de Satisfação dos Colaboradores da SEAD”. Esse título será exibido em cada página do questionário. **Descrição:** Breve descritivo do questionário. Ex.: “Pesquisa para identificar pontos fortes e fracos da SEAD, enquanto ambiente de trabalho dos seus funcionários, com o objetivo de reforçar o lado positivo e melhorar o negativo.” Pode-se utilizar HTML nesta seção. **Mensagem de boas-vindas:** Permite entrar com uma mensagem que será exibida quando o participante acessar o questionário pela primeira vez. Ex.: "Obrigado por reservar um pouco do seu tempo para participar desse questionário.” Pode-se utilizar HTML nesta seção. **Mensagem final:** Permite entrar com uma mensagem que será exibida quando o participante concluir a pesquisa. Ex.: "Obrigado por responder a este questionário. os resultados serão liberados em breve.” Pode-se utilizar HTML nesta seção. **URL Final:** Essa URL será apresentada ao final do questionário e permite direcionar os participantes de volta à página inicial ou outra URL definida. Deverá vir com "http:" no início. Ex.:http://http://www.ifrj.edu.br/. **Descrição da URL:** Descrição para o link usando a URL final. **Administrador:** Nome da pessoa/contato responsável pela administração do questionário em questão. Será incluído em todos os e-mails enviados, convidando para o questionário. **E-mail do Administrador:** Correio eletrônico (e-mail) do administrador acima. **E-mail para casos de erro:** Correio eletrônico (e-mail) que recebe as notificações de erro no envio do questionário. **Fax Para:** Campo usado para informar o número do fax que aparece no texto da ''**“Versão do questionário para impressão”**''. A impressão do questionário é uma facilidade útil que permite imprimi-lo em situações onde o participante não pode/consegue acessá-lo on-line. O botão aparece disponível na barra de botões do questionário. ==== 3.2. Apresentação e Navegação ==== **Formato:** Forma de apresentação das perguntas. É possível selecionar entre ''**"Pergunta por pergunta"**'', ''**"Grupo por grupo"**'' ou ''**"Todas em uma página"**''. * a) **Pergunta por pergunta:** O questionário apresentará uma questão por página. * b) **Grupo por grupo:** O questionário apresentará todas as questões de um grupo em uma mesma página. Esta opção também separa a página de Boas Vindas e a de Envio, da mesma forma que o formato de apresentação “Pergunta por pergunta”. * c) **Todas em uma página:** O questionário apresentará todas as perguntas numa só página – inclusive as páginas de Boas Vindas e a de Envio. **Modelo:** Permite selecionar um modelo dentre aqueles existentes. É possível criar seu próprio modelo na opção ''**"Editor de Modelos"**'' da interface de administração. **Mostrar o botão [<> E-mail do Administrador]]) como destinatário de notificações (básicas e/ou detalhadas). Entretanto, é possível incluir múltiplos destinatários, separados por ponto e vírgula. Ex.: "yourname@test.com; myname@test.com;hisname@test.com". OBS.: Informações sobre como customizar os modelos (templates) dos e-mails de notificação podem ser encontradas na seção [[dgti:servicos:limesurvey:manual#editando_modelos_de_e-mail|Editando modelos de e-mail]]. **Colocar data de envio?:** Esse campo indica se o questionário deve guardar data e hora para as respostas enviadas. Quando escolher 'Sim', um campo indicando data e hora será incluído para cada resposta enviada. **Salvar Endereço IP?:** Esse campo permite que seja indicado se o questionário armazenará ou não o endereço IP para as respostas. Quando escolher 'Sim', um campo indicando o endereço IP do participante será incluído para cada resposta enviada. **Salvar URL de referência?:** Esse campo permite que você indique se o questionário irá salvar a URL das respostas. Quando escolher 'Sim', para cada resposta enviada, um campo será incluído contendo o URL de referência. Uma URL de referência é a URL a partir da qual o usuário foi direcionado para seu questionário. **Habilitar o modo de avaliação?:** Marcar este campo como 'Sim' permite habilitar a criação de [[dgti:servicos:limesurvey:manual#avaliacao|Avaliações]] para as respostas dadas ao questionário. **Salvar tempos?:** Quando ativada, esta opção cronometra quanto tempo cada usuário gasta para responder cada questão do formulário. Ela também gera uma tabela à parte, onde tais dados são armazenados. **Participante pode salvar e continuar mais tarde?:** Quando essa opção é habilitada, um botão ''**"Continuar mais tarde"**'' é exibido ao final da(s) página(s) do questionário. Clicando nele, os usuários têm a possibilidade de salvar as respostas já preenchidas e voltar depois para completá-las e/ou enviá-las. ==== 3.5. Código de acesso (Tokens) ==== * **Respostas anônimas?:** A opção default é 'Não', indicando que as respostas submetidas serão associadas aos códigos de acesso utilizados para acessar o questionário. Caso este campo seja marcado como 'Sim', as respostas serão mantidas anônimas e não haverá nenhuma forma de relacioná-las com os participantes. * **Permitir editar respostas após completar questionário?:** Quando ativada, esta opção permite que os usuários acessem o questionário mais de uma vez, mesmo após terem submetido suas respostas. O acesso deve ser feito através do link enviado no e-mail de convite para participação. * **IMPORTANTE:** Caso você deseje permitir a edição das respostas submetidas garantindo que cada usuário tenha apenas um registro na tabela de respostas, é necessário que seu questionário ''**NÃO seja anônimo**'' e que as opções ''**"Habilitar a persistência das respostas baseadas em códigos de acesso?"**'' e ''**"Permitir editar respostas após completar questionário?"**'' estejam marcadas como 'SIM'. Além disso, é necessário [[DGTI:Serviços:Limesurvey:manual#gerenciamento_de_codigos_de_acesso_tokens|habilitar o uso de códigos de acesso]]. Por outro lado, se o questionário for anônimo ou se a opção ''**“Habilitar a persistência das respostas baseadas em códigos de acesso?”**'' estiver desabilitada, marcar esta opção como 'Sim' fará com que acessos repetidos com o mesmo código de acesso gerem novas entradas na tabela de respostas. Em outras palavras, a unicidade das respostas por usuário não será garantida. * **Habilitar a persistência das respostas baseadas em códigos de acesso?:** Se seu questionário utilizar códigos de acesso e não for anônimo, este recurso pode ser interessante. Ao marcar essa opção como 'Sim', uma função de auto-salvamento é executada a cada resposta preenchida pelo usuário. Desta forma, caso ele não conclua o envio ou haja alguma interrupção em sua conexão, o usuário pode retornar ao questionário e continuar o preenchimento do ponto onde parou. O acesso deve ser feito através do link enviado no e-mail de convite para participação. Essa funcionalidade também pode ser útil durante o preenchimento de questionários através da entrada de dados ou importação VV (Verificação Vertical). * **Permitir inscrição pública?:** Quando um questionário possui códigos de acesso, as únicas pessoas que podem acessá-lo são aquelas que aparecem na tabela de códigos de acesso. Se você deseja usar os códigos de acesso, mas também deseja permitir inscrição aberta ou pública, você deve habilitar esse campo. Marcar 'Sim' permite que um visitante acesse a URL do questionário e inscreva-se, colocando seu nome e endereço eletrônico (e-mail). * **Usar formato HTML para os e-mails?:** A opção default é 'Sim'. Neste caso, todos os e-mails enviados com o gerenciamento de códigos de acesso ativado (convite, lembrete, confirmação) serão formatados com a codificação HTML. Caso este campo seja marcado como 'Não', é necessário ter atenção: você deverá verificar se os modelos de seus e-mails ainda estão sendo exibidos da forma desejada. Para mais informações sobre a habilitação dos códigos de acesso, as vantagens de utilizá-los e outras configurações a este respeito, acesse [[DGTI:Serviços:Limesurvey:manual#gerenciamento_de_codigos_de_acesso_tokens|Gerenciamento de códigos de acesso (tokens)]]. ==== 3.6. Importar ==== * **Importar usando linha de comando:** * Para usar essa função, deve-se ter acesso ao DOS, e o interpretador do PHP precisa estar configurado para permitir execução de scripts. Esse recurso é útil quando você tem problemas de timeout com a versão web, ao importar questionários muito grandes. Para usá-lo, vá à pasta limesurvey/admin e execute: php cmdline_importsurvey [ ] • '''': deve ser o arquivo LSS/CSV que se deseja importar. • '''': tem que ser um usuário com permissão para criar questionários. • '''': senha para o usuário. OBS: '''' e '''' só são necessários se o controle de acesso estiver ativo. Se precisar ver os parâmetros, você pode executar: php cmdline_importsurvey –h ==== 3.7. Copiar ==== \\ ---- ===== 4. Tela de status do questionário ===== * **Título:** Título do questionário seguido pela sua identificação (ID). * **URL do questionário:** URL usada para acessar o questionário pela Internet. Exemplo: ''http://www.yourdomain.com/limesurvey/index.php?sid=xxx&lang=yyy'', onde __xxx__ é a identificação do questionário e __yyy__ é o código do idioma do questionário. Se o questionário usar códigos de acesso, é adicionado ''&token=zzz'' ao final da URL, onde __zzz__ é o código de acesso. * **Descrição:** Descrição dada para o questionário. * **Bem-vindo(a):** O texto apresentado na página inicial. * **Administrador:** Nome do administrador, seguido do seu e-mail. * **Data de início:** Se tiver sido definida uma data inicial de acesso ao questionário, será mostrada aqui. * **Data de expiração:** Se tiver sido definida uma data para expiração do questionário, será mostrada aqui. * **Modelo:** O modelo do formulário (template) usado para o questionário. * **Idioma base:** Idioma principal do questionário. * **Idiomas adicionais:** Outros idiomas definidos para o questionário. * **URL final:** Link apresentado / carregado quando um questionário é enviado com sucesso. * **Número de perguntas/grupos:** Mostra a quantidade de perguntas e de grupos que existem no questionário. * **Questionário ativo no momento:** Mostra o status do questionário – ativo ou não ativo. * **Nome da tabela do questionário:** Se o questionário estiver ativo, o nome da tabela no banco de dados será mostrado. * **Dicas:** Informações adicionais, como as listadas a seguir. * Eventuais motivos pelos quais o questionário ainda não pode ser ativado. Isso acontece, por exemplo, se nenhum grupo e/ou pergunta tiver sido criado. * Se o questionário é anônimo ou não. * Formato do questionário: "Pergunta por pergunta", "Grupo por grupo" ou "Todas em uma página". * Se a data de envio das respostas é gravada ou não. * Se endereços IP são registrados ou não. * Se a URL de referência é gravada ou não. * Se são utilizados cookies. * Se é permitido ou não salvar o questionário. * Se serão enviadas notificações por e-mail. * Dados sobre o uso de códigos de acesso. * Possibilidade de serem gerados novos códigos para as perguntas. * __Direto__: Modo mais comum, em que os códigos são atribuídos a cada pergunta de forma sequencial e a ordem do grupo é ignorada. Ex.: a primeira é 001; a segunda, 002; a terceira, 003, etc.. * __Por grupo__: Neste modo, a primeira pergunta de cada grupo recebe o código 001; a segunda de cada grupo, 002; a terceira, 003, etc.. ---- ===== 5. Criando um grupo de perguntas ===== {{ :dgti:servicos:limesurvey:ls12.png?800 |}} O campo ''**"Descrição"**'' permite fazer uma explanação sobre o conjunto de perguntas a que o grupo se refere. Quando a descrição for incluída, ela será apresentada ao usuário no início daquele grupo de questões. Se nenhum texto for colocado, os participantes simplesmente passarão diretamente para a primeira pergunta. É permitido usar código HTML para a descrição do grupo ou para inclusão de imagens, como no exemplo abaixo: A importação de grupos segue um procedimento parecido com aquele adotado na [[DGTI:Serviços:Limesurvey:manual#criando_um_questionario|importação de questionários]], mas com o uso de um arquivo com extensão .lsg ou .csv. ---- ===== 6. Adicionando uma pergunta ===== **Código:** É a identificação da questão, através de um código alfanumérico. Esse campo serve para uma identificação mais rápida da pergunta durante exportação ou avaliação, e também pode ser utilizado na definição de ''**"Relevance equations"**'' e em questões do tipo ''**"Equação"**''. Procure ser consistente na codificação, pois um bom planejamento facilita bastante o uso dessas ferramentas. **Pergunta:** Esse é o texto da pergunta, de fato. Não há limite para o seu tamanho. Caso seja necessário, é possível dar explicações sobre a pergunta, utilizando o campo ''**“Ajuda”**''. Código HTML pode ser ser usado para incluir imagens, como por exemplo: **Ajuda:** Campo opcional. É útil se a pergunta precisar de alguma explicação para ser respondida. Ao colocar um texto nesse campo, um ícone na forma de um sinal de interrogação aparece nas telas de entrada do questionário com o texto de ajuda ao lado. **Tipo da pergunta:** Determina o tipo de resposta que o questionário permite. Veja a seção [[DGTI:Serviços:Limesurvey:manual#tipos_de_perguntas_do_limesurvey|Tipos de Pergunta]] para uma descrição das várias opções disponíveis. **Grupo de questões:** Aqui é possível alterar o grupo ao qual pertence a pergunta que está sendo criada. **Opção 'Outro':** A depender do tipo de pergunta escolhida, pode aparecer essa opção. Ela permite que o participante dê uma outra resposta, acrescentada por ele, diferente das alternativas apresentadas pela pergunta. **Obrigatória:** Disponível para todos os tipos de perguntas. Definir uma pergunta como obrigatória requer do participante do questionário uma resposta antes de passar à próxima questão. Além disso, ele terá de responder todas as perguntas obrigatórias antes de executar o envio do questionário. **Conjunto de legendas:** Para alguns tipos de perguntas, é possível escolher um conjunto de legendas. Para exibir legendas de um determinado idioma, é preciso que ele esteja disponível no questionário. **Validação:** Funcionalidade disponível em todos os tipos de perguntas que compreendam texto livre (curto, longo, muito longo ou curtos múltiplos) e entrada numérica (simples ou múltipla). É possível usar um padrão de expressões regulares (vide item "Expressões Regulares" na seção [[DGTI:Serviços:Limesurvey:manual#glossario|Glossário]]) nesse campo para validar as respostas à pergunta. Caso uma resposta não seja aprovada, será apresentada uma mensagem ao usuário, que deverá modificá-la antes de prosseguir. **Relevance equation:** Existem duas formas de se controlar a exibição de questões numa pesquisa. A mais simples delas se dá através da [[DGTI:Serviços:Limesurvey:manual#definindo_condicoes_para_uma_pergunta|definição de condições]]. A outra é feita através deste campo, que provê lógica condicional mais complexa. Se o valor dele for '1' ou 'true', a questão é considerada "relevante" no contexto da pesquisa. Assim, ela sempre é exibida aos participantes (desde que não haja uma condição definida sobre ela). Todos os tipos de questão permitem especificar uma equação de relevância, cujas regras são definidas pelo [[DGTI:Serviços:Limesurvey:manual#expression_manager_em_e_syntax_highlighting|Expression Manager (EM)]], porém sem o uso de colchetes ao redor da expressão. Quando uma equação de relevância é salva, a expressão utilizada é avaliada e exibida conforme o [[DGTI:Serviços:Limesurvey:manual#expression_manager_em_e_syntax_highlighting|Syntax Highlighting do EM]]. Desta forma, qualquer erro encontrado ficará colorido de forma diferenciada, facilitando sua detecção. **Posição:** Esta opção surge a partir da segunda pergunta a ser adicionada, possibilitando determinar em que local se deseja colocá-la: no fim do grupo, no começo do grupo, ou após uma questão específica daquele grupo. **Mostrar configurações avançadas:** Permite fazer ajustes adicionais. As configurações avançadas variam de acordo com o tipo de pergunta escolhido. {{ :dgti:servicos:limesurvey:ls16.png?700 |}} **Importar pergunta:** Na parte inferior do formulário para inclusão de perguntas, há uma caixa para importar um arquivo de perguntas. É possível importar qualquer arquivo de perguntas (extensão *.lsq ou *.csv) que tenha sido exportado anteriormente. Isso é útil, por exemplo, se você deseja utilizar uma questão de outro questionário. Para copiar uma pergunta que já faça parte do mesmo questionário, é mais prático usar a função [[DGTI:Serviços:Limesurvey:manual#copiando_uma_pergunta|Copiar Pergunta]]. ---- ===== 7. Copiando uma pergunta ===== \\ ---- ===== 8. Tipos de perguntas do LimeSurvey ===== Abaixo são mostradas ilustrações de cada tipo de questão. No campo ''**"Tipo da pergunta"**'' da tela de criação ou edição de pergunta, as mesmas ilustrações são exibidas ao se pousar o ponteiro do mouse sobre cada opção. Foi criado um [[dgti:servicos:limesurvey:mais_informacoes#apendicetipo_equacao|apêndice]] nesta seção para o tipo ''**"Equação"**'', com um exemplo ilustrativo. ==== 8.1. Matrizes ==== * **Matriz de escala dupla (//Array dual scale//)** {{:dgti:servicos:limesurvey:lsq9.png?400|}} * **Conjunto (Aumentar, Manter, Reduzir)** {{:dgti:servicos:limesurvey:lsq8.png?400|}} * **Conjunto (Números)** {{:dgti:servicos:limesurvey:lsq24.png?400|}} * **Conjunto (Textos)** {{:dgti:servicos:limesurvey:lsq25.png?400|}} * **Conjunto por coluna** {{:dgti:servicos:limesurvey:lsq10.png?400|}} * **Matriz (Seleção de 10 Pontos)** {{:dgti:servicos:limesurvey:lsq12.png?400|}} * **Matriz (Seleção de 5 Pontos)**. Ex.: Em que grau você concorda com a seguinte declaração? (1=Concorda totalmente, 5=Discorda totalmente) {{:dgti:servicos:limesurvey:lsq11.png?400|}} * **Matriz (Sim/Não/Não sei)**. Ex.: Você concorda com as seguintes proposições? {{:dgti:servicos:limesurvey:lsq13.png?400|}} * **Ordem** {{:dgti:servicos:limesurvey:lsq26.png?400|}} \\ ==== 8.2. Questões com respostas pré-definidas (Mask questions) ==== * **Classificação**. Ex.: Ordene as cores, começando pelas suas preferidas. {{:dgti:servicos:limesurvey:lsq1.png?400|}} * **Data**. Ex.: Quando você nasceu? {{:dgti:servicos:limesurvey:lsq2.png?400|}} * **Entrada numérica**. Ex.: Quantos anos você tem? {{:dgti:servicos:limesurvey:lsq3.png?400|}} * **Entrada numérica múltipla** {{:dgti:servicos:limesurvey:lsq4.png?400|}} * **Envio de arquivo** {{:dgti:servicos:limesurvey:lsq27.png?400|}} * **Equação** ([[dgti:servicos:limesurvey:mais_informacoes#apendicetipo_equacao|mais informações]]) {{:dgti:servicos:limesurvey:lsq29.png?400|}} * **Exposição do texto** {{:dgti:servicos:limesurvey:lsq28.png?400|}} * **Mudança de idioma** {{:dgti:servicos:limesurvey:lsq14.png?400|}} * **Sexo** {{:dgti:servicos:limesurvey:lsq17.png?400|}} * **Sim/Não** {{:dgti:servicos:limesurvey:lsq18.png?400|}} \\ ==== 8.3. Questões de resposta única ==== * **Lista (Dropdown)** {{:dgti:servicos:limesurvey:lsq5.png?400|}} * **Lista (Radio)** {{:dgti:servicos:limesurvey:lsq6.png?400|}} * **Lista com comentário** {{:dgti:servicos:limesurvey:lsq7.png?400|}} * **Seleção de 5 pontos** {{:dgti:servicos:limesurvey:lsq19.png?400|}} \\ ==== 8.4. Questões de múltipla escolha ==== * **Múltipla escolha** {{:dgti:servicos:limesurvey:lsq15.png?400|}} * **Múltipla escolha com comentário** {{:dgti:servicos:limesurvey:lsq16.png?400|}} \\ ==== 8.5. Texto ==== * **Texto livre curto** {{:dgti:servicos:limesurvey:lsq20.png?400|}} * **Texto livre longo** {{:dgti:servicos:limesurvey:lsq21.png?400|}} * **Texto livre muito longo** {{:dgti:servicos:limesurvey:lsq22.png?400|}} * **Textos curtos múltiplos** {{:dgti:servicos:limesurvey:lsq23.png?400|}} \\ ==== Apêndice: tipo "Equação" ==== Uma questão do tipo ''**"Equação"**'' é usada em conjunto com outros tipos de questão (em geral, numéricas) para exibir a resposta de uma equação previamente definida pelo administrador do questionário com base nesses outros valores informados pelo usuário. A sintaxe das equações segue as regras do [[DGTI:Serviços:Limesurvey:manual#expression_manager_em_e_syntax_highlighting|Expression Manager (EM)]]. A seguir, acompanhe um exemplo ilustrativo para compreender o uso desse tipo de questão. Nesse exemplo, queremos calcular e mostrar ao usuário o seu [[https://pt.wikipedia.org/wiki/%C3%8Dndice_de_massa_corporal|Índice de Massa Corporal, ou IMC (link externo)]]. Para tal, precisamos que o usuário informe sua idade, peso e altura. Escolhemos obter tais dados das respostas a perguntas do tipo ''**"Entrada numérica"**''. Mostramos nas figuras abaixo a configuração da pergunta sobre a idade do usuário. O campo ''**"Código"**'' aceita qualquer padrão alfanumérico, mas observe que ele foi definido de forma a facilitar a identificação da questão, já que ela será usada numa equação. {{ :dgti:servicos:ls55.png?500 }} Para acessar outras configurações, basta clicar na opção ''**"Mostrar configurações avançadas"**''. Nesta questão, optamos por restringir as entradas a valores inteiros apenas, e definimos uma quantidade máxima de caracteres. A necessidade de alterar as configurações avançadas varia conforme cada caso. Quando a questão é usada por uma equação, pode ser interessante alterá-las para evitar erros no resultado calculado. {{ :dgti:servicos:ls56.png?500 }} Procedemos de forma semelhante na criação das questões sobre peso e altura, cujos códigos são, respectivamente, 'peso' e 'altura'. Em seguida, prosseguimos para a criação da questão do tipo ''**"Equação"**''. {{ :dgti:servicos:ls57.png?550 }} Na verdade, questões do tipo ''**"Equação"**'' não são exatamente perguntas, pois não recebem respostas. Sua função é exibir uma informação obtida do resultado de uma equação pré-definida. Perceba os itens destacados no texto da pergunta, na figura acima. Gostaríamos de mostrar ao usuário as informações que ele mesmo forneceu anteriormente e que foram utilizadas no cálculo do IMC. Para isso, utilizamos expressões no formato ''{código da questão}'': ''{peso}'', ''{altura}'' e ''{idade}''. A equação que calcula o IMC é obtida pela expressão ''{peso / (altura * altura)}''. Às vezes pode ser interessante adicionar algum tipo de controle aos dados que são admitidos pela equação definida. Isso é feito através de expressões lógicas inseridas no campo ''**"Relevance equation"**''. No nosso exemplo, queremos garantir que o IMC será calculado somente se o usuário informar seu peso e sua altura e, além disso, se tiver 18 anos ou mais. Caso sua equação deva utilizar apenas valores numéricos, é recomendável habilitar a opção ''**"Entrada deve ser numérica apenas"**'' nas configurações avançadas, conforme mostra a figura abaixo. {{ :dgti:servicos:ls58.png?500 }} Todas as expressões usadas devem seguir as regras do [[DGTI:Serviços:Limesurvey:manual#expression_manager_em_e_syntax_highlighting|Expression Manager (EM)]]. A única diferença é que, conforme foi dito na seção [[DGTI:Serviços:Limesurvey:mais_informacoes#adicionando_uma_pergunta|Adicionando uma pergunta]], as expressões lógicas do campo ''**"Relevance equation"**'' não devem ter colchetes ao seu redor. Uma vez salva a questão, será exibida sua tela de status. No nosso exemplo, a tela ficou conforme mostra a figura a seguir. {{ :dgti:servicos:ls59.png?800 }} Perceba que todas as expressões usadas são coloridas conforme os padrões do [[DGTI:Serviços:Limesurvey:manual#expression_manager_em_e_syntax_highlighting|Syntax Highlighting do EM]]. Tal informação visual ajuda na detecção de erros nas expressões, que ficam coloridas de vermelho nesse caso. Além disso, uma dica é exibida ao se passar o ponteiro do mouse sobre a expressão errônea (figura abaixo). {{ :dgti:servicos:ls60.png?800 }} Veja, agora, alguns testes ilustrativos do funcionamento desse conjunto de questões. Pode-se observar que, na primeira figura, a idade informada é menor que 18 e, portanto, o resultado do IMC não é exibido. Já na segunda imagem, o peso não foi informado e, novamente, o resultado do IMC não é exibido. Por fim, na terceira imagem todos os campos foram preenchidos com valores válidos para a equação que calcula o IMC, cujo resultado é mostrado ao final da página. \\ {{ :dgti:servicos:ls61.png?800 }} \\ \\ {{ :dgti:servicos:ls62.png?800 }} \\ \\ {{ :dgti:servicos:ls63.png?800 }} ---- ===== 9. Adicionando as possíveis respostas para uma pergunta ===== * **Código:** Esse é o dado usualmente exportado para a planilha ao compilar os resultados. Em geral, é gerado automaticamente, mas pode ser alterado. Pode ser qualquer código, desde que tenha, no máximo, 5 caracteres alfanuméricos. * **Opção de resposta:** É a resposta que será exibida. Em perguntas do tipo matriz com legendas personalizadas, para criar uma resposta que será apresentada em linha, à esquerda e à direita, deve-se usar o caractere '|' para separar as opções. Por exemplo: para colocar 'Bom' e 'Ruim' respectivamente à direita e à esquerda da linha, digite ''Bom|Ruim'' nesse campo. Isso é bastante útil para criar perguntas com diferenças de semântica. * O ícone no formato de um lápis, à direita deste campo, inicia um editor de HTML numa janela pop-up, para o caso de se desejar alterar a aparência do texto exibido. * **Ações:** Exibe ícones que possibilitam a inclusão de uma nova linha de resposta ou a exclusão de uma linha. {{ :dgti:servicos:ls38.png?800 |}} * **Alterando a ordem de exibição das respostas:** Para tanto, basta clicar sobre o quadradinho cinza à esquerda de cada linha de resposta e arrastá-la para a posição desejada. Isso também pode ser feito depois; vide seção [[DGTI:Serviços:Limesurvey:manual#mudando_a_ordem_das_perguntas|Mudando a ordem das perguntas]]. * **Botão "Adicionar rapidamente":** Permite a inclusão de um conjunto de rótulos/opções de resposta de uma só vez. É possível substituir os rótulos já incluídos pelo novo conjunto ou simplesmente adicioná-lo ao que já existe. Vide figura abaixo. {{ :dgti:servicos:ls39.png?800 |}} ---- ===== 10. Alterando a resposta padrão para uma pergunta ===== \\ ---- ===== 11. Definindo condições para uma pergunta ===== Veja o exemplo a seguir, que resume um cenário onde se deseja que a exibição de certas questões seja condicionada à resposta de outra. Nele, deseja-se saber se o usuário está empregado ou não. Em caso afirmativo, deseja-se saber detalhes sobre seu trabalho - por exemplo, qual é o tipo da empresa. Por outro lado, não é coerente que tais perguntas sejam mostradas a alguém que não esteja trabalhando. Neste caso, deseja-se saber se a pessoa está em busca de um emprego ou não e, se for pertinente, permitir-lhe enviar seu currículo. Para fins ilustrativos, fizemos apenas 5 questões, destacadas na figura a seguir. {{ :dgti:servicos:ls43.png?1000 |}} * Caso o usuário esteja empregado, deseja-se saber qual é o tipo da empresa. Para tal, selecione a pergunta que será condicionada a uma resposta (no caso, a pergunta 004) e clique em ''**"Definir condições para esta pergunta"**'': {{ :dgti:servicos:ls44.png?1000 |}} * Na tela apresentada será possível definir as condições para exibição da pergunta. Observe que, inicialmente, abaixo da primeira linha destacada ("A pergunta ... só deve ser exibida SE"), é informado que tal questão é sempre mostrada. Para adicionar uma condição, selecione a questão apropriada e a respectiva resposta. Além disso, defina qual operador de comparação deve ser usado. O exemplo requer o operador **Igual a**, mas existem outros: * **Menor que**; * **Menor ou igual a**; * **Diferente de**; * **Maior ou igual a**; * **Maior que**; * **Expressão regular**. {{ :dgti:servicos:ls45.png?1000 |}} * A condição criada será gravada após clicar no botão ''**"Adicionar condição"**''. Perceba que, na tela exibida em seguida (figura abaixo), passa a constar a informação da nova condição. Os botões à direita da tela, destacados na figura abaixo, permitem apagar todas as condições para aquela questão (acima); apagar uma condição específica (abaixo, botão à esquerda); ou editar uma condição específica (abaixo, botão à direita). {{ :dgti:servicos:ls46.png?1000 |}} * Para visualizar todas as condições existentes para uma pergunta, pode-se clicar no botão ''**"Mostrar condições para essa pergunta"**'', destacado na figura abaixo. Perceba que uma pergunta pode ter mais de condição de exibição, desde que sejam coerentes entre si. {{ :dgti:servicos:ls47.png?1000 |}} * Também é possível copiar as condições de uma pergunta para outra. Vamos usar esse método para a questão 007, pois ela cai no mesmo caso da questão 004. Para tanto, clique no botão ''**"Copiar condições"**'' e selecione quais deseja copiar. Selecione para quais questões as condições selecionadas devem ser copiadas e confirme, clicando no botão ao fundo da tela. {{ :dgti:servicos:ls48.png?1000 |}} * Voltando à pergunta 003, caso o usuário não esteja empregado, deseja-se saber se ele está em busca de emprego. Podemos alternar para a questão 005 na mesma janela, selecionando-a no menu à direita. {{ :dgti:servicos:ls49.png?1000 |}} * Por fim, queremos que a questão 006 seja exibida se a resposta à questão 005 for 'Sim'. Observe que, na prática, pode-se dizer que foram encadeadas duas condições para a questão 006, pois ela depende da resposta da questão 005 que, por sua vez, depende da resposta dada à 003. É importante lembrar que tal cadeia de condições precisa ser coerente. * Terminadas as alterações, pode-se clicar no botão ''**"Voltar à administração do questionário"**'' (ícone com desenho de uma casa) para sair da área de definição de condições. Observe agora que, na tela de status da questão 004 por exemplo, o campo ''**"Relevance"**'' possui um valor, refletindo sua condição de exibição. {{ :dgti:servicos:ls50.png?1000 |}} ---- ===== 12. Mudando a ordem dos grupos de perguntas ===== \\ ---- ===== 13. Mudando a ordem das perguntas ===== \\ ---- ===== 14. Visualizando uma questão ou um grupo de questões ===== {{ :dgti:servicos:ls52.png?800 |}} \\ {{ :dgti:servicos:ls53.png?800 |}} \\ {{ :dgti:servicos:ls54.png?800 |}} ---- ===== 15. Definindo quotas para o questionário ===== ==== Adicionando uma quota ==== {{ :dgti:servicos:ls28.png?400 }} Na barra de menu, clique em ''**"Propriedades do questionário" >> "Quotas"**'' (figura acima). Em seguida será mostrada a tela de status das quotas. Na figura abaixo, nenhuma quota foi definida ainda. Clique no botão ''**"Adicionar quota"**''. {{ :dgti:servicos:ls64.png?900 }} A tela "Nova parcela" é exibida. Os campos a ser preenchidos são os que seguem. {{ :dgti:servicos:ls65.png?900 }} * **Nome da parcela:** Nome da quota. Recomenda-se que identifique o que ela representa. * **Limite da parcela:** Número máximo de questionários que podem ser completados para aquela quota. * **Ação da parcela:** Define o que acontece após se atingir o valor limite da quota, havendo duas opções. * **Finalizar o questionário**: Termina o questionário imediatamente. * **Concluir o questionário com alerta:** Avisa ao participante da restrição de quota e permite que ele volte para alterar as respostas. * **URL de carga automática:** Quando habilitado, redireciona o participante automaticamente para a URL definida a seguir quando a ''**"Ação da Parcela"**'' é executada. * **Mensagem de cota:** Texto exibido ao participante quando a cota atinge seu limite. * **URL:** URL para onde o usuário é direcionado após a mensagem ou após a execução da ''**"Ação da Parcela"**'', caso ''**"URL de carga automática"**'' esteja habilitado. * **Descrição da URL:** Texto exibido para a URL. Depois da quota incluída, é possível adicionar respostas para compô-la. \\ ==== Adicionando respostas ==== {{ :dgti:servicos:ls66.png?850 }} Como exemplo, adicionamos uma quota chamada "Busca emprego", cujas informações são exibidas na tela de status das quotas. Clique no botão ''**"Adicionar resposta"**'' para prosseguir. {{ :dgti:servicos:ls67.png?550 }} **Selecione uma pergunta:** Ao adicionar uma resposta, será apresentada uma relação das perguntas já criadas no questionário e disponíveis para definição de quota. Se uma pergunta não aparecer nessa lista é porque não está disponível para ser usada com quotas. No nosso exemplo, selecionaremos a pergunta 005. Depois de escolher, clique em ''**“Próximo”**'' para continuar. {{ :dgti:servicos:ls68.png?500 }} **Selecione uma resposta:** Depois de selecionar a pergunta, será apresentada uma lista com as possíveis respostas, onde você deverá escolher a que se adeque à sua necessidade. No nosso exemplo, será a resposta 'Sim'. **Salvar este e criar um outro:** Esta opção salva a resposta atual e retorna para a tela de inclusão de uma nova resposta para a mesma quota. Depois de salvar as respostas necessárias, elas também passam a ser exibidas na tela de status das quotas: {{ :dgti:servicos:ls69.png?850 }} ---- ===== 16. Avaliação ===== Na tela que surge após selecionar o menu ''**"Avaliações"**'', é possível criar avaliações e visualizar, editar ou apagar aquelas que já existam. Os campos a serem preenchidos são os que seguem. {{ :dgti:servicos:ls72_b.png?900 }} * **Escopo:** Indica a abrangência da avaliação. * **Total:** Cria uma avaliação baseada na soma de todas as respostas do questionário. * **Grupo:** Cria avaliação baseada na soma das respostas de um determinado grupo (a ser escolhido no campo seguinte). * **Grupo de questões:** Se o escopo for "Grupo", aqui é onde deve ser selecionado o grupo para avaliar. * **Mínimo:** A menor soma de respostas à qual a avaliação se aplica. * **Máximo:** A maior soma de respostas à qual a avaliação se aplica. * **Cabeçalho:** O cabeçalho do bloco de exibição da avaliação. * **Mensagem:** Mensagem para a avaliação, que pode incluir código HTML e alguns //placeholders//. //Placeholders// são "palavras reservadas" (uma espécie de termos especiais) que, quando colocadas no texto, são substituídas por uma informação. Há 3 //placeholders// para as mensagens de **Avaliação**. * **{PERC}:** Exibe o escore (soma) do grupo atual. * **{TOTAL}:** Exibe o escore total. * **{ASSESSMENT_CURRENT_TOTAL}:** Exibe o subtotal do escore ao longo do questionário. Funciona somente com escopo de grupo e em questionários que não estejam configurados para serem exibidos em uma única página, pois só é atualizado ao se clicar no botão ''**"Próximo"**''. É possível criar qualquer número de avaliações, e pode haver mais de uma a ser mostrada para um dado escore. **OBS.:** É importante notar que, para usar avaliações, a opção ''**“Carregar automaticamente a URL depois que o questionário for preenchido?”**'' (em ''**"Propriedades do questionário" >> "Configurações gerais"**'', aba ''**"Apresentação e Navegação"**'') **NÃO** deve ser escolhida, pois elas só vão aparecer na página final, após o envio das respostas. \\ ==== Exemplo ==== Um questionário possui a pergunta "É fumante?”, com 3 respostas possíveis: - "Sim, fumo mais de 10 cigarros por dia", onde deve-se colocar “10” para o código da resposta; - "Sim, fumo menos de 10 cigarros por dia", onde deve-se colocar "5" para o código da resposta; - "Não", onde deve-se colocar "1" para o código da resposta. {{ :dgti:servicos:ls73.png?700 }} O mesmo questionário tem outra pergunta: “Pratica exercício?", também com 3 respostas possíveis: - "Sim, pelo menos 3 vezes na semana, durante meia hora" onde deve-se colocar "1" para o código da resposta; - "Sim, de vez em quando", onde deve-se colocar "5" para o código da resposta; - "Não, nunca faço exercício", onde deve-se colocar “10” para o código da resposta. {{ :dgti:servicos:ls74.png?700 }} No final, ao contabilizar o total obtido com a soma dos valores de cada resposta dada, obtém-se uma indicação em termos gerais da saúde daquele participante. Alguém que fume e não pratique exercícios físicos terá marcado 10 pontos em cada resposta, somando 20; alguém que não fume e faça exercícios regularmente terá um total de 2 pontos. Não são permitidos códigos de resposta com valor igual a zero (0). {{ :dgti:servicos:ls75.png?900 }} ---- ===== 17. Expression Manager (EM) e Syntax Highlighting ===== \\ ---- ===== 18. Gerenciamento de códigos de acesso (tokens) ===== A ativação dos tokens pode ser feita por dois caminhos diferentes: - no momento da ativação do questionário; ou - clicando no botão ''**"Gerenciamento de códigos de acesso"**'', na barra de menu do questionário. Recomendamos essa opção, pois ela permite realizar outras alterações nas configurações do questionário, caso sejam necessárias, sem prejuízo algum. {{ :dgti:servicos:ls78.png?450 }} Em ambos os casos, será exibida uma tela de confirmação, conforme mostra a figura abaixo. A mensagem em inglês informa que "se você inicializar os tokens para este questionário, então ele será acessível somente para os usuários que informem um código válido, manualmente ou via URL". {{ :dgti:servicos:ls79.png?500 }} Após clicar no botão ''**"Inicializar códigos de acesso"**'', surgirá outra tela de confirmação. Ao final da mensagem, entre parênteses, aparece o nome dado pelo sistema à ''**tabela de códigos de acesso**'' que acaba de ser criada para o questionário. {{ :dgti:servicos:ls80.png?550 }} Até este ponto, nenhum código de acesso foi de fato criado para o questionário; apenas foi reservada uma tabela no sistema para armazená-los. Clicando no botão ''**"Continuar"**'', chega-se finalmente à tela de controle de códigos de acesso do questionário. A partir de agora, tal seção é mostrada sempre que se clicar no botão ''**"Gerenciamento de códigos de acesso"**'', na barra de menu do questionário. {{ :dgti:servicos:ls81.png?650 }} O controle de tokens possui uma barra de menus, apresentados brevemente a seguir. * **Voltar à administração do questionário:** Retorna à tela principal de administração de questionários. * **Exibir resumo dos códigos de acesso:** Apresenta um sumário sobre os códigos na tabela (quantidade de códigos, quantos foram enviados, quantos responderam). Também dá acesso às funções de Administração do Banco de Dados (veja abaixo). * Exibir participantes: Apresenta a lista completa de participantes na tabela de códigos. A partir dessa tela, pode-se editar ou apagar entradas individuais, bem como realizar uma série de outras funções. (Veja a seção Exibindo os códigos de acesso abaixo). * Incluir participantes: Permite incluir uma entrada (um participante) na tabela de códigos de acesso. * Add dummy tokens: * Gerenciar campos adicionais de atributos: * Importar participantes a partir de um arquivo CSV: -> O arquivo deve ser padrão CSV (delimitado por vírgulas), com aspas duplas em torno dos valores (default para OpenOffice e Excel). A primeira linha deve conter o cabeçalho (que será removido) e os dados devem ser ordenados da seguinte forma: "primeiro_nome","ultimo_nome","email","codigo_de_acesso","codigo_de_idiom a","atributo1","atributo2","tid". Apenas os 3 primeiros campos são obrigatórios -> Registros duplicados são identificados por primeiro_nome, ultimo_nome e email. Se um registro desses for encontrado durante a importação, a linha correspondente será omitida. * Importar participantes a partir de query LDAP: Permite importar informação de uma query LDAP (testado em um openLDAP, mas deve funcionar em qualquer diretório LDAP equivalente, incluindo ActiveDirectory) * Exportar participantes para um arquivo CSV: Permite exportar a sua lista de participantes para um arquivo CSV. Útil para permitir importá-la e voltar a usá-la em questionários futuros. É necessário que os campos de primeiro nome, sobrenome e email estejam preenchidos. * Editar modelos de e-mail: veja com mais detalhes em seção específica nesse manual. * Enviar convite por e-mail: Envia convites em massa, por e-mail a todos os participantes da tabela de código de acesso que para os quais ainda não foi enviado. * Enviar lembrete por e-mail: Envia e-mail em massa, para lembrar àqueles participantes da tabela de códigos que já receberam o convite, mas ainda não responderam ao questionário. * Gerar códigos de acesso: Cria código de acesso único para cada participante da tabela de códigos que ainda não possui um. * Apagar tabela de códigos de acesso: Apaga a tabela criada. * Bounce settings: Os seguintes campos aparecem no modelo de e-mail para convite e lembrete, e devem ser informados nas propriedades do questionário. Ao enviar os e-mails, esses campos serão substituídos pelo conteúdo informado. |{ADMINEMAIL}| E-mail do administrador do questionário| |{ADMINNAME}| Nome do administrador do questionário| |{SURVEYNAME}| Título do questionário| |{SURVEYDESCRIPTION}| Descrição do questionário| Os campos abaixo aparecem no assunto e/ou corpo dos e-mails enviados (convite ou lembrete): |{EMAIL}| E-mail do destinatário| |{FIRSTNAME}| Primeiro nome| |{LASTNAME}| Segundo nome| |{SURVEYURL}| A URL pública apontando para o início do questionário| |{TOKEN}| Códigos de acesso para o questionário| |{ATTRIBUTE_1}| Atributo_1| |{ATTRIBUTE_2}| Atributo_2| **Administração do banco de dados** A tela que apresenta um breve resumo, acessada através do ícone Exibir o resumo dos códigos de acesso, {{:dgti:servicos:limesurvey:ls27.png?500|}} permite acesso a recursos de Administração do banco de dados, incluindo: * Marcar todos os participantes com “Convite não enviado”: Atribui ‘N’ (Não), a todos os registros de que um convite tenha sido enviado. Obviamente, não deve ser usado normalmente. * Apagar todos os códigos de acesso: Remove o código de acesso para todos os participantes que já tenham algum. Mantém os participantes cadastrados. * Apagar todos os participantes: Apaga todos os registros (participantes) da tabela de código de acesso. Para que o questionário possa ser acessado, ainda será necessário cadastrar participantes na tabela e gerar código para eles. * Apagar tabela de códigos de acesso: Permite remover o recurso de código de acesso do questionário. Apaga todos os registros e a tabela, permitindo que o questionário possa ser acessado por qualquer um que conheça a URL. **Exibir participantes** Objetivo: Mostrar uma lista com todos os participantes, tendo ao lado botões que realizam funções específicas, as Ações, para cada um, individualmente. A primeira linha, acima da tabela permite ordenar a exibição dos registros e definir um ponto de início. A segunda apresenta o nome do campo, e uma seta verde que, uma vez clicada, atualiza a tela, mostrando os dados ordenados por aquele campo. A coluna de Ações mostra uma lista com atividades específicas que podem ser efetuadas em cada um dos participantes. * E: Editar o participante * D: Apagar o participante * S: Responder ao questionário, usando esse código de acesso * R: Enviar lembrete para o participante (só válido se o convite já foi enviado) * I: Enviar um convite para o participante (só disponível se o convite ainda não foi feito) * V: Se o questionário permitir identificação da resposta (não anônima), o botão "V" aparecerá, permitindo visualizar a respectiva resposta para aquela entrada. * U: Atualizar resposta, permite alterar ou incluir novas informações às respostas já recebidas. **Permitindo registro público** É possível deixar o questionário aberto ao público, com controle de participantes. Se tiver sido definido ‘Permitir Inscrição Pública’ para o questionário e a tabela de códigos de acesso for inicializada, qualquer pessoa que visite o site do questionário poderá se inscrever para participar. Quando o participante informar um e-mail que ainda não exista na tabela de códigos de acesso, uma entrada será criada para ele, e um e-mail enviado, convidando-o para o questionário e fornecendo um número como código de acesso. Todos os códigos fornecidos a participantes que se inscreveram começarão com a letra "R". **Números de segurança para Inscrição Pública (CAPTCHA)** Para proteger seu questionário de inscrições automáticas, existe o recurso de usar Números de Segurança nos formulários de Inscrição, Salvar e Carregar. Esses números (captchas) são comuns em sites que para garantir que não haja um programa realizando as inscrições, votações ou outra atividade automaticamente. Uma combinação de números/letras ou uma soma simples é apresentada para que o usuário dê o resultado num campo determinado. O recurso só está disponível para quem tem GD-support ativado na configuração do PHP. ---- ===== 19. Editando modelos de e-mail ===== **1.** Assunto do e-mail de Convite: O campo “Assunto” do e-mail quando o questionário é enviado aos participantes. **2.** E-mail Convite: Texto do e-mail que convida os participantes para o questionário, enviando códigos de acesso. Inicialmente já vem preenchido com um texto (definido no arquivo com a tradução de cada idioma), mas pode ser alterado conforme a necessidade. Deve-se preencher um “formulário” com os ampos abaixo para inserir informações individuais em cada e-mail. É bom lembrar que se não forem utilizados códigos de acesso para o questionário, esse campo será irrelevante a) {FIRSTNAME} – é substituído pelo campo "firstname" na tabela de código de acesso. b) {LASTNAME} - é substituído pelo campo "lastname" na tabela de código de acesso. c) {SURVEYNAME} - é substituído pelo nome do questionário. d) {SURVEYDESCRIPTION} - é substituído pela descrição do questionário. e) {ATTRIBUTE_1} - substitui o campo "atributo_1" da tabela de código de acesso. f) {ATTRIBUTE_2} - substitui o campo “atributo_2" da tabela de código de acesso. g) {SURVEYURL} - é substituído pela URL para o questionário. **3.** Assunto do e-mail de Lembrete: Depois de já ter enviado um convite para o questionário, caso ela ainda não tenha sido respondida pelo participante, é possível enviar novo e-mail, relembrando-o do questionário. Esse é o campo “Assunto” do email em questão. Novamente, vale lembrar que envio de e-mail só é possível quando se utiliza código de acesso. **4.** E-mail Lembrete: Texto do e-mail Lembrete que é enviado, quando o questionário usa códigos de acesso. **5.** E-mail de Confirmação - Assunto: Quando os códigos de acesso são usados, esse campo contém o assunto do e-mail que será, automaticamente, mandado aos participantes que enviarem o questionário. **6.** E-mail de Confirmação: Texto do e-mail que é mandado automaticamente aos participantes quando enviarem seus questionários respondidos. **7.** E-mail Inscrição Pública - Assunto: Esse é o campo que contém o Assunto do e-mail a ser enviado àquelas pessoas que se inscreveram para o Questionário. **8.** E-mail Inscrição Pública: Texto para o e-mail enviado às pessoas que se inscreveram para o questionário. Os mesmos campos de “formulário” se aplicam como visto anteriormente. ---- ===== 20. Testando um questionário ===== \\ ---- ===== 21. Ativando um questionário ===== Com o questionário ATIVO: a) Ainda será possível: * Alterar o nome ou descrição do questionário * Editar (alterar) os nomes de grupo * Editar (alterar) código ou texto das perguntas * Incluir, apagar ou editar respostas pré-definidas para perguntas (exceto no caso de questões com respostas múltiplas) * Incluir e alterar atributos das perguntas * Mudar a pergunta de um grupo para outro * Definir condições para a pergunta * Mudar a obrigatoriedade da pergunta * Colocar validação para a pergunta * Incluir ou remover respostas para perguntas que exigem apenas uma opção na resposta b) Não mais será possível: * Incluir ou apagar grupos * Incluir ou apagar perguntas * Modificar o tipo da pergunta * Incluir ou remover respostas para perguntas de múltipla escolha Depois que dados forem adicionados a esse questionário, caso deseje adicionar ou apagar grupos ou perguntas, será preciso desativar o questionário, lembrando que isso fará com que toda informação já existente seja movida para uma tabela separada. Veja mais na seção [[DGTI:Serviços:Limesurvey#fechando_um_questionario]] . ---- ===== 22. Executando um questionário com segurança ===== \\ ---- ===== 23. Alterando um questionário ativo via importação ===== O procedimento para se usar a Importação VV e Exportação VV deve ser o seguinte: 1. Exporte a estrutura do questionário original. Depois, importe esse arquivo como um novo questionário, e, se necessário, modifique-o conforme desejar. 2. Ative o novo questionário. 3. Faça a Exportação VV do novo questionário (vamos chamar esse arquivo Primeira Exportação) 4. Faça a Exportação VV do questionário antigo (vamos chamar esse arquivo Segunda Exportação) 5. Recorte as 2 primeiras linhas da Primeira Exportação e cole-as como as 2 primeiras linhas do Segunda Exportação. 6. Mantendo as 2 primeiras linhas inalteradas, corte e cole as colunas abaixo, para que, agora, elas fiquem no lugar certo de acordo com as 2 primeiras linhas. 7. Assim que os dados estejam no lugar correto, apague a terceira e quarta linha (os cabeçalhos da Segunda Exportação) 8. Salve como um arquivo delimitado por Tab. 9. Faça a Importação VV para o novo questionário A tela para exportação da estrutura pode ser acessada através do botão “Visualizar as respostas do questionário”. Lá, encontram-se os botões “Exportar/Importar um arquivo de questionário VV”. Dica: Ao reordenar colunas, troque os ids da coluna (linha 2) em vez de todo o conteúdo das colunas (da linha 3 ao final). Renomeie arquivos vv como .txt, e o Excel irá abri-los corretamente. ---- ===== 24. Visualizando resultados de questionários ===== * **Administração:** Retorna à tela principal de administração de questionários. * **Mostrar informações resumidas:** Exibe o total de respostas até o momento. * **Mostrar respostas:** Exibe todos os resultados do questionário. Mostra o texto das perguntas e as respostas. * **Mostrar as 50 últimas respostas:** Exibe as últimas 50 respostas do questionário, ordenadas da mais recente para a menos recente. * **Tela para entrada de dados:** Exibe a tela de entrada de dados para responder ao questionário (essa opção também está disponível a partir da tela de administração). * **Obter estatísticas a partir das respostas:** Uma forma simples para filtrar e obter resumo das respostas. (Veja a seção Estatísticas). * **Exportar resultados para aplicativo:** Exportar todas as respostas do questionário para o Word, Excel ou arquivo CSV. (Ver seção Exportando Resultados). * **Exportar resultado para um arquivo de comandos SPSS:** Exportar todas as respostas do questionário para um arquivo SPSS. * **Importar respostas da tabela de um questionário desativado:** Importar todas as respostas de um questionário desativado para o ativo em questão. * **Ver respostas salvas, mas não enviadas:** Visualizar as respostas incompletas que podem ocorrer nas seguintes situações: quando um participante usa a função “Salvar até o momento, mas não enviar”, ou quando um operador usa o recurso de entrada de dados sem '”Finalizar o envio'”, ou ainda, quando há uma falha na finalização do questionário de um participante por um problema no browser, por exemplo. * **Importar um arquivo de questionário VV:** Importar um arquivo de questionário de Verificação Vertical. * **Exportar um arquivo de questionário VV:** Exportar um arquivo de questionário de Verificação Vertical. ---- ===== 25. Fechando um questionário ===== **a) Desativação** * Todos os resultados já existentes serão movidos para uma tabela separada, não mais sendo possível acessá-los pelo LimeSurvey, apenas pelo banco de dados. Do ponto de vista da aplicação, todas as informações respondidas serão perdidas. * Todas as questões, grupos e parâmetros poderão ser editados de novo. * Um questionário desativado permanece acessível (você vê todas as questões, apenas não pode salvar os dados). * Você pode reativá-lo para usar novamente. * Opção interessante, caso deseje alterar as perguntas e/ou opções de respostas, após já ter ativado o questionário, mas tenha nenhum ou poucos resultados enviados. **b) Expiração** * Nenhum resultado será perdido. * Nenhuma informação respondida será perdida. * Alterações nas perguntas, grupos de perguntas e parâmetros serão limitadas. * Um questionário expirado não permanece acessível. Uma mensagem de que ela já expirou passa a ser apresentada. ---- ===== 26. Entrada de dados ===== \\ ---- ===== 27. Estatísticas ===== **Filtrando dados** Ao começar a usar a função de estatística, uma lista de perguntas será apresentada para possibilitar filtrar os dados. Cada caixa de pergunta mostra o código da pergunta, um botão que pode ser marcado para mostrar um resumo da tabela em questão, um ícone de alto-falante que quando o mouse passar por sobre ele, vai mostrar o texto completo da pergunta, e uma lista das respostas pré-definidas para a pergunta. Essa lista permite você selecionar uma ou mais opções. Passe por todas as caixas, escolhendo os filtros da sua preferência. A opção "Filtrar respostas incompletas" permite você decidir se deseja incluir pesquisas que ainda não foram finalizadas em sua análise. Depois de clicar em "Ver estatísticas", uma tabela de resultados será apresentada, mostrando o número total de respostas relacionado a cada critério e um percentual do total. **Visualizar resumo campo a campo** Com freqüência, você desejará um resumo de todos os resultados de uma pergunta quanto a um determinado aspecto. Para isso, marque o botão que fica acima da pergunta para a qual deseja o sumário, defina o critério nas outras caixas e clique em “Ver estatísticas”. É possível obter a estatística de todos os campos, marcando na opção “Ver resumo de todos os campos disponíveis”. Serão apresentadas as tabelas de resultados, indicando o número de respostas de acordo com o seu pedido, bem como uma tabela “Resumo por campo” que sintetizará todas as possíveis respostas para a questão selecionada, o total e o percentual. É importante observar que esses valores são um subconjunto do total de suas respostas. Assim, se seu critério tiver 146 registros de um total de 180, o resumo mostrará a análise apenas dos 146 para aquela tabela. Recomenda-se cuidado nas seguintes situações: * Se você definiu um filtro na mesma questão em que pediu o resumo, então a pergunta só apresentará respostas que obedeçam ao filtro. Assim, constitui-se boa prática não definir um critério na mesma questão onde se vai obter um resumo. * Para escolher mais de uma entrada para a pergunta, pressione o botão CTRL ao clicar em cada uma. Para desmarcar a seleção, clique na resposta marcada com, também segurando o botão CTRL. **Pesquisando / Exportando resultados filtrados** Para exportar as respostas que atendam ao critério definido, clique no botão “Exportar” abaixo da tabela 'Resultados'. A tela padrão de exportação aparecerá, porém ao exportar os resultados, você só receberá as respostas que obedecem a seu critério. Da mesma forma, clique em Navegar para ver as respostas na tela de pesquisa. **JPGraph – Gráfico** Se tiver sido definido no arquivo config.php para usar a biblioteca JPGraph-library, então além dos resultados do questionário, um **gráfico de barras e um de pizza** estarão disponíveis. Pode-se exportar esses gráficos facilmente, usando o clique do botão direito do mouse, escolhendo "Salvar a imagem como" e salvar o gráfico como um arquivo .png na pasta escolhida. Normalmente, os resultados são apresentados em gráfico de pizza; apenas para as perguntas de múltipla escolha, são usados os gráficos de barra. ---- ===== 28. Exportando um questionário ===== \\ ---- ===== 29. Exportando resultados ===== **Opções de exportação** * Cabeçalhos abreviados: Exporta o título resumido da pergunta. * Cabeçalhos completos: Exporta o título da pergunta como cabeçalho. * Códigos das perguntas: : Exporta apenas o número de identificação da pergunta. * Código das respostas: Exporta apenas os códigos relevantes para cada resposta, para aquelas que são diferentes de campo texto. * Respostas completas: Exporta o texto da resposta. * Formato Microsoft Word: Exporta os dados como um 'documento' (não formatado e com ‘tabs’ entre os dados). * Formato Microsoft Excel: Exporta os dados como uma planilha. * Formato CSV, delimitado por vírgulas: Exporta os dados como um arquivo delimitado por vírgulas. * PDF: Exporta os dados como um arquivo PDF. **Exportação VV e Importação VV** Agora que as respostas começaram a ser reunidas, pode ser necessário editar ou modificar diretamente grandes quantidades de dados da tabela de respostas, e nesse momento, uma ferramenta como a planilha pode ser útil. Exportação VV e Importação VV ("VV" significa verificação vertical) permitem exportar sua tabela de respostas para um arquivo .xls. Desde que mantenha a estrutura geral do arquivo, você pode editar os valores dentro dele e importar o arquivo de novo para a tabela de respostas, usando o recurso Importação VV. **Exportando um arquivo de pesquisa VV** Ao escolher exportar respostas usando Exportação VV, será dada a opção de exportar as respostas e deixar o questionário ativo ou exportar as respostas e desativar o questionário. Ao escolher desativar o questionário, a tabela de respostas será renomeada e se tornará apenas acessível através de acesso direto do MySQL (a tabela será renomeada da mesma forma que acontece quando um questionário é desativado). Caso o questionário possua códigos de acesso, observe que desativá-la também fará com que a tabela de códigos seja desativada e fique indisponível. É melhor não desativar um questionário que use códigos de acesso, a menos que você saiba como renomear tabelas usando MySQL e possa mover a tabela de códigos de acesso manualmente. A possibilidade de desativar o questionário é importante porque um arquivo de pesquisa VV permite importar respostas para um questionário quando a combinação pergunta/resposta foi alterada. Efetivamente, isso possibilita adicionar ou remover perguntas em um questionário ativo. Clicar em "Exportar Respostas" irá gerar um arquivo delimitado por ‘tab’ que pode ser aberto pelo Excel ou programa de planilha similar. As duas primeiras linhas da planilha são a coluna de labels. A primeira linha é uma coluna cabeçalho que detalha o nome da pergunta/resposta. A segunda linha é o nome da coluna interna do PHP para aquela resposta. Não se deve modificar essas duas primeiras linhas caso ainda se queira "importar" os dados de volta para o LimeSurvey. **Importando um arquivo VV** Desde que as duas primeiras linhas estejam intactas, é possível importar os dados de volta para um questionário LimeSurvey ativo. Caso o questionário tenha sido desativado, será preciso ativá-lo antes. Aí, então, a partir da tela de visualização das respostas, clique no ícone "Importar um arquivo de questionário". Na tela "Importar um arquivo de questionário VV" é preciso escolher o arquivo "VVexport". Se for selecionado "Excluir os números de identificação dos registros" os registros serão importados e novos números de identificação serão gerados para eles. Se essa opção for desmarcada, a identificação original será importada. Há diversas opções para escolher sobre como o LimeSurvey deve responder a entradas duplicadas ou múltiplas: * Informe o erro (e passe ao novo registro). * Renumere o novo registro * Ignore o novo registro * Substitua o registro existente ---- ===== 30. Gerenciamento de usuários ===== \\ ---- ===== 31. Gerenciamento de grupo de usuários ===== \\ ---- ===== 32. Opções de segurança do questionário ===== \\ ---- ===== 33. Trabalhando com backups ===== **Relembrando:** a instalação padrão do LimeSurvey incorpora o MySQL como o banco de dados para a aplicação, que é onde os dados do questionário são armazenados e onde a informação desejada deve ser procurada. Para isso, é preciso conhecer o front-end administrativo da aplicação para o MySQL. Há referência de boas experiências com o phpMyAdmin, disponível na Internet. Antes de iniciar seu trabalho com o MySQL, FAÇA SEMPRE BACKUP DOS DADOS. Verifique com seu administrador e esteja certo que o backup dos dados e aplicação seja o mais recentepossível, pelo menos feito nas últimas 24 horas. Quanto mais recente, melhor. Só então, faça seu próprio backup dos dados antes de começar seu trabalho. Uma vez conhecendo o phpMyAdmin, abra-o e use-o para abrir o banco de dados contendo os dados do LimeSurvey. Primeiro, faça uma CÓPIA da base de dados para sua instalação do LimeSurvey, criando uma nova área de trabalho com essas tabelas. Você NÃO deverá trabalhar com seus dados originais primários. Isso seria péssima prática! Em segundo lugar, comece a trabalhar com a cópia. Você encontrará tabelas com nomes bem estranhos, como “sidXgidXqid” e outras derivações desse formato. Nesses nomes, há sequências de letras que equivalem aos números da pergunta ou identificadores que você criou para cada pergunta no questionário. Antes de qualquer coisa, deve ficar claro que tabelas têm nomes que se relacionam com as várias formas de perguntas usadas. Perguntas com opções de respostas A, B, C e assim por diante, terão tabelas para cada opção. Se houver uma opção como ‘Outros’ para uma pergunta, haverá uma tabela com a seqüência ‘Outros’ formando o final do nome da tabela. Para pesquisar em alguma dessas tabelas, simplesmente marque a caixinha em frente ao nome da tabela. Isso irá destacar a linha que a tabela está listada. À direita dessa linha, há alguns ícones. Segurar o cursor sobre qualquer um deles fará abrir uma breve explicação sobre ele. O primeiro ícone permite pesquisar os dados da tabela. Como o phpMyAdmin define, isso significa fornecer uma visão limitada dos registros daquela tabela. O segundo ícone mais à direita mostra uma versão completa do conteúdo da tabela. Para ver a tabela completa, é melhor usar o ícone Browser (ao invés do ícone TEXTO COMPLETO). Quando a janela Browser estiver aberta, haverá um link para Imprimir e um outro para Imprimir Texto Completo. Usando a opção Imprimir Texto Completo, chegamos a uma nova tela com a informação procurada e pode-se imprimir. Depois de ter encontrado o que procurava, faça o que tem que fazer. Lembre-se, porém, de que está trabalhando com uma cópia. Qualquer mudança feita, você poderá copiar, importar ou manipular para que elas terminem na sua base de dados ativa realmente. Eis uma explicação dos nomes das tabelas mencionadas acima: **sidXgidXqid** * sid = ID do questionário * gid = ID do Grupo de Perguntas * qid = ID da Pergunta * X = ID-Value OBS.: Apesar de o arquivo exportado criar um arquivo SQL padrão, não é recomendado executá-lo diretamente num banco de dados LimeSurvey já existente, isto é, usando o phpMyAdmin, pois vários ponteiros internos no questionário precisam ser reinicializados. ---- ===== 34. Glossário ===== \\ ---- ===== FAQ: Perguntas mais frequentes ===== \\