Sistema de Pesquisa On-line

LimeSurvey
verso 1.71

Manual do Usurio

TPICOS

1. 2. 3. 4. 5. 6. 7. 8. 9.

Estrutura e projeto do questionrio Criando um questionrio Importando um questionrio Criando um grupo de perguntas Mudando a ordem do grupo de perguntas Adicionando uma pergunta Mudando a ordem das perguntas Tipos de perguntas do LimeSurvey Atributos das perguntas

10. Adicionando as possveis respostas 11. Tela de status do questionrio 12. Testando um questionrio 13. Ativando um questionrio 14. Editando modelos de e-mail 15. Executando um questionrio com segurana 16. Visualizando resultados de questionrios 17. Fechando um questionrio 18. Entrada de dados 19. Cdigos de acesso 20. Definindo quotas para o questionrio 21. Estatsticas 22. Exportando um questionrio 23. Exportando resultados 24. Gerenciamento de usurios 25. Gerenciamento de grupo de usurios 26. Opes de segurana do questionrio 27. Avaliao 28. Modelos/Editor de modelos 29. Definio de legendas 30. Trabalhando com backups

1 Data Verso: 06/10/2008

1.

Estrutura e projeto do questionrio

Todo questionrio no LimeSurvey possui, obrigatoriamente, 3 elementos: Um nome Um grupo de perguntas, no mnimo Uma pergunta, no mnimo

O questionrio ainda pode incluir: Uma lista de possveis respostas para as questes aplicadas Legendas personalizadas Condies que determinam se uma pergunta dever ou no ser exibida (dependncia entre perguntas)

O Nome o ttulo para o questionrio e aparece para relacionar as vrias opes e configuraes referentes a ele, como mensagem de boas vindas, descrio do questionrio, informaes sobre como contatar o administrador do questionrio, em que formato ele ser apresentado etc. Cada questionrio tem suas perguntas divididas em grupos, cada um com ttulo obrigatrio e uma descrio opcional, permitindo uma organizao lgica em grupos de questes similares. necessrio haver, pelo menos, um grupo em cada questionrio, mesmo que no se deseje dividi-lo em mais de um. As perguntas so a essncia do questionrio e encaixam-se em um grupo, como explicado acima. No h limite tcnico quanto ao nmero de questes por questionrio ou grupo. Entende-se por pergunta, a questo propriamente dita, bem como a configurao que determina que tipo de resposta deve-se esperar. possvel tambm incluir uma breve explicao para cada pergunta e a indicao se ela ou no obrigatria, isto , se precisa ou no ser respondida antes de se passar prxima.

2.

Criando um questionrio
localizado

Para criar um questionrio, clique no boto Criar ou importar novo questionrio direita da barra de botes de Administrao. A tela "Criar ou importar questionrio" ser exibida com os seguintes campos: Geral

1. Idioma base: Define o idioma base do questionrio. possvel desenvolver pesquisas em diversos idiomas Ao criar um questionrio, no possvel ainda definir os idiomas adicionais para possveis tradues. Isso s pode ser feito quando for editar as suas propriedades posteriormente. Em relao ao Idioma base, uma vez escolhido e salvo, no possvel mais alter-lo. 2. Ttulo: Nome do questionrio que d uma idia do que se trata. Ex.: 1 Pesquisa de Satisfao dos Colaboradores da SEAD. Esse ttulo ser exibido em cada pgina do questionrio.

2 Data Verso: 06/10/2008

3. Descrio: Breve descritivo do questionrio. Ex.: Pesquisa para identificar pontos fortes e fracos da SEAD, enquanto ambiente de trabalho dos seus funcionrios, com o objetivo de reforar o lado positivo e melhorar o negativo. Pode-se utilizar HTML nesta seo. 4. Mensagem de Boas Vindas: Permite entrar com uma mensagem que ser exibida quando o participante acessar o questionrio pela primeira vez. Ex.: "Obrigado por reservar um pouco do seu tempo para participar desse questionrio. Pode-se utilizar HTML nesta seo. 5. Administrador: Nome da pessoa/contato responsvel pela administrao do questionrio em questo. Ser includo em todos os e-mails enviados, convidando para o questionrio. 6. E-mail do Administrador: Correio eletrnico (e-mail) do administrador acima. 7. E-mail para casos de erro: Correio eletrnico (e-mail) que recebe as notificaes de erro no envio do questionrio. 8. Fax Para: Campo usado para informar o nmero do fax que aparece no texto da Verso do questionrio para impresso. A impresso do questionrio uma facilidade til que permite imprimi-lo em situaes onde o participante no pode/consegue acess-lo on-line. O boto aparece disponvel na barra de botes do questionrio. Apresentao e Navegao 1. Formato: Forma de apresentao das perguntas. possvel selecionar entre "Uma de cada vez", "Por grupo" ou "Todas de uma s vez". a) Uma de cada vez: O questionrio apresentar uma questo por pgina. b) Por grupo: O questionrio apresentar todas as questes de um grupo em uma mesma pgina. Esta opo tambm separa a pgina de Boas Vindas e a de Envio, da mesma forma que o formato de apresentao Uma de cada vez. c) Todas de uma s vez: O questionrio apresentar todas as perguntas numa s pgina inclusive as pginas de Boas Vindas e a de Envio. 2. Modelo: Permite selecionar dentre os modelos existentes. possvel consultar mais informaes sobre como criar seu prprio modelo na seo Modelos/Editor de Modelos. 3. Permite Salvar?: Marcar "Sim" para essa opo permite que usurios possam salvar questionrios no enviados e voltar depois para complet-los e/ou envi-los. 4. Mostrar o boto [<<Ant]: A opo default Sim. Marc-la com No impedir que os usurios tenham a opo de mover para pginas anteriores enquanto preenchem o questionrio. 5. Participantes podem imprimir as respostas?: A opo default No. Marc-la como Sim, permite que o participante imprima um resumo de suas respostas. 6. Listar questionrios: A opo default No. Marc-la como Sim, faz com a que pesquisa seja listada no portal de pesquisas disponveis. 7. URL Final: Essa URL ser apresentada ao final do questionrio e permite direcionar os participantes de volta pgina inicial ou outra URL definida. Dever ser vir com "http://" no incio, como, por exemplo: http://www.sead.salvador.ba.gov.br. 8. Descrio da URL: Descrio para o link usando a URL final. 9. Carregar automaticamente a URL depois que o questionrio for preenchido?: Ao escolher "Sim" para essa opo, a URL definida em URL Final" ser automaticamente carregada depois que o questionrio for enviado, em vez de exibir pgina Completa". No use essa opo se estiver usando Avaliao, seno o resultado calculado no aparece.

3 Data Verso: 06/10/2008

Controle de publicao e acesso 1. Expira?: Defina com Sim caso deseje que o questionrio expire em uma data especfica. 2. Data de Expirao: Essa ser a ltima data na qual os participantes ainda podero acessar e responder o questionrio. Exemplo: Num questionrio com Data de Expirao em 31/12/2007, as pessoas no mais podero acess-la a partir de 01/01/2008. No necessrio j definir essa data no momento de criao do questionrio; pode-se acrescent-la com ele j ativo, a qualquer momento 3. Utilizar cookies?: Se a opo "Utilizar cookies" for utilizada e o questionrio no usar cdigo de acesso para os participantes, um cookie ser salvo no computador cliente de cada participante que envie o questionrio. O objetivo evitar que o mesmo computador acesse o questionrio mais de uma vez. H algumas limitaes nessa segurana, mas em termos gerais, permite que as pesquisas mantenham certo controle sobre mltiplas entradas. 4. Permitir inscrio pblica: Quando um questionrio possui cdigos de acesso, as nicas pessoas que podem acess-lo so aquelas que aparecem na tabela de cdigo de acesso. Se voc deseja usar os cdigos de acesso, mas tambm permitir inscrio aberta ou pblica, voc deve usar esse campo. Marcar "Sim" permite que um visitante acesse a URL do questionrio e inscreva-se, colocando seu nome e endereo eletrnico (e-mail). Feito isso, uma nova entrada para essa pessoa ser criada na tabela de cdigo de acesso, e um e-mail Convite ser enviado para ela. Isso assegura que s uma pessoa por e-mail possa completar o questionrio e que a resposta seja enviada apenas uma vez. 5. Uso de CAPTCHA: O default utilizar o CAPTCHA apenas para a pgina de inscrio pblica, mas possvel habilit-lo para aparecer tambm antes de acessar o questionrio e antes de salvar/carregar um questionrio que foi salvo parcialmente. CAPTCHA um acrnimo da expresso "Completely Automated Public Turing test to tell Computers and Humans Apart" e utilizado para impedir que softwares automatizados executem aes que degradam a qualidade do servio de um sistema dado, devido despesa do abuso ou do recurso. 6. Nomes dos atributos dos cdigos de acesso: A tabela de cdigo de acesso tem 2 campos reserva para guardar informao adicional sobre os usurios. Ao usar o mecanismo de inscrio pblica, pode-se usar esses 2 campos para atribuir um nome mais amigvel ao pblico. Assim por exemplo, o Atributo 1 pode gravar o nome do rgo em que participante trabalha, e o Atributo 2, o setor. Com isso, no momento em que se cadastram os participantes na tabela de cdigo de acesso, o Atributo 1 vai aparecer como rgo, com um campo para preenchimento do rgo, e Atributo 2, como Setor, com o campo para preenchimento do setor. 7. Usar formato HTML para e-mails com cdigo de acesso?: Ao marcar Sim, todos os e-mails enviados (convite, lembrete, confirmao), utilizando o gerenciamento de cdigos de acesso sero formatados como HTML. Nesse caso, ser possvel formatlos usando codificaao HTML. A opo default Sim, mas ateno ao mud-la: voc dever verificar se os modelos de seus e-mails ainda esto sendo exibidos da forma desejada. Notificao e gerenciamento dos dados 1. Notificao para o Administrador: Opo para o e-mail que chegar para o Administrador do questionrio a cada vez em que uma resposta a ele for enviada. Existem 3 alternativas: a) Sem notificao por e-mail. b) Notificao bsica um e-mail mandado ao Administrador, informando que as respostas pesquisa foram enviadas.
4 Data Verso: 06/10/2008

2.

3.

4.

5.

6.

c) Envio de notificao com os cdigos das respostas respostas completas so passadas no e-mail quando o questionrio respondido e enviado. Respostas annimas?: Indica se as respostas estaro associadas aos cdigos de acesso utilizados para responder ao questionrio ou se sero mantidas como annimas. A resposta default Sim. Se for escolhido No para annimo, ser necessria uma tabela de cdigo de acesso para o questionrio quando for ativ-lo. Colocar data de envio?: Esse campo indica se o questionrio deve guardar data e hora para as respostas enviadas. Quando escolher "Sim", um campo indicando data e hora ser includo para cada resposta enviada. Salvar Endereo IP?: Esse campo permite que seja indicado se o questionrio armazenar ou no o endereo IP para as respostas. Quando escolher "Sim", um campo indicando o endereo IP do participante ser includo para cada resposta enviada. Salvar URL de referncia?: Esse campo permite que voc indique se o questionrio ir salvar a URL das respostas. Quando escolher "Sim", para cada resposta enviada, um campo ser includo contendo o URL de referncia. Uma URL de referncia a URL a partir da qual o usurio foi direcionado para seu questionrio. Habilitar Auto-save para respostas baseadas em cdigos de acesso?: Se o questionrio utilizar cdigo de acesso e no for annimo, voc poder desejar usar esse recurso. Ao marcar essa opo com Sim, uma funo Auto-Salvar executada a cada vez que o participante responder a uma questo, o que significa que mesmo ele no enviando o questionrio e havendo uma interrupo em sua conexo, lhe ser possvel recuperar suas respostas ao retornar ao questionrio. Pode ser til tambm durante o preenchimento de questionrios atravs da entrada de dados ou importao VV (Verificao Vertical).

Idiomas Adicionais: Uma vez j criado o questionrio, ao entrar no modo de edio, pode-se adicionar ou remover idiomas. bom atentar que quando um idioma removido de um questionrio, todo o contedo referente a ele tambm ser apagado permanentemente.

3.

Importando um questionrio
Opcionalmente, tambm possvel Importar um Questionrio. 1. Importar usando a interface de administrao Se voc j exportou um questionrio anteriormente, pode import-lo na tela Criar ou importar questionrio, atravs da guia Importao de questionrio. Clique no boto para pesquisar e escolher o arquivo SQL/CSV, e ento, clique no boto Importao de Questionrio. O processo de importao l arquivos com formato CSV, criados pelo LimeSurvey. Dessa forma, possvel importar questionrios de verses anteriores. A importao renumera o identificador do questionrio, grupo, pergunta, resposta e condio, de modo que eles se relacionem. Veja a seo Exportando um Questionrio para maiores informaes. 2. Importar usando linha de comando Para usar essa funo, deve-se ter acesso ao DOS, e o interpretador do PHP precisa estar configurado para permitir execuo de scripts. Esse recurso til quando voc tem problemas de timeout com a verso web, ao importar questionrios muito grandes. Para us-lo, v pasta limesurvey/admin e execute:

5 Data Verso: 06/10/2008

php cmdline_importsurvey <Arquivo a importar> [<user> <password>] <Arquivo a importar> deve ser um dos descritos acima <user> tem que ser um usurio com permisso para criar questionrios <password> senha para o usurio

*<user> e <password> s so necessrios se o controle de acesso estiver ativo Se precisar ver os parmetros, voc pode executar: php cmdline_importsurvey h

3. Alterar um questionrio ativo via importao Questionrios ativos s podem sofrer modificaes mnimas em alguns campos texto. Caso seja necessrio incluir ou remover perguntas e/ou respostas, o LimeSurvey tem as funes Importao VV e Exportao VV, que podem ser usadas para mover todos os resultados de uma pesquisa para outra. Importao VV e Exportao VV tambm podem ser usadas para combinar resultados de questionrios que rodaram em mais de um servidor, ou seja, que tem resultados armazenados em diferentes servidores. O procedimento para se usar a Importao VV e Exportao VV deve ser o seguinte: 1. Exporte a estrutura do questionrio original. Depois, importe esse arquivo como um novo questionrio, e, se necessrio, modifique-o conforme desejar. 2. Ative o novo questionrio. 3. Faa a Exportao VV do novo questionrio (vamos chamar esse arquivo Primeira Exportao) 4. Faa a Exportao VV do questionrio antigo (vamos chamar esse arquivo Segunda Exportao) 5. Recorte as 2 primeiras linhas da Primeira Exportao e cole-as como as 2 primeiras linhas do Segunda Exportao. 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 cabealhos da Segunda Exportao) 8. Salve como um arquivo delimitado por Tab. 9. Faa a Importao VV para o novo questionrio A tela para exportao da estrutura pode ser acessada atravs do boto Visualizar as respostas do questionrio. L, encontram-se os botes Exportar/Importar um arquivo de questionrio VV. Dica: Ao reordenar colunas, troque os ids da coluna (linha 2) em vez de todo o contedo das colunas (da linha 3 ao final). Renomeie arquivos vv como .txt, e o Excel ir abri-los corretamente.

4.

Criando um grupo de perguntas

Antes de adicionar perguntas ao questionrio, preciso adicionar o(s) Grupo(s) de Perguntas. Se houver apenas um grupo no seu questionrio, o nome irrelevante, (exceto para ser
6 Data Verso: 06/10/2008

exibido). Entretanto, se houver mais de um, as perguntas sero apresentadas por grupo. Se for necessrio exibir os grupos em uma ordem especfica, possvel faz-lo, usando o recurso de reordenamento. Grupos de Perguntas incluem um campo "Descrio" que permite fazer uma explanao sobre o conjunto de perguntas a seguir. Quando a descrio for includa, ela ser apresentada no incio de cada grupo de questes. Se nenhum texto for colocado, os participantes simplesmente passaro diretamente para a primeira pergunta. permitido usar cdigo HTML para a descrio do grupo ou para incluso de imagens como no exemplo abaixo: <img border="0" src="http://www.yourdomain.com/yourpics/pic.jpg"> O grupo criado ao clicar no cone na barra botes do Questionrio. Podem-se criar tantos grupos quanto for necessrio. Opcionalmente, voc ainda pode importar um grupo exportado anteriormente.

5.

Mudando a ordem do grupo de perguntas

possvel reordenar os grupos de perguntas, clicando no cone na barra de botes do Questionrio. Se o questionrio tiver mais de um grupo de perguntas, os grupos sero ordenados conforme a ordem estabelecida. Pode-se alter-la, simplesmente clicando nos botes Para cima e Para baixo. Deve-se prestar ateno existncia de pr-requisitos ou condies entre perguntas, pois o sistema no permitir colocar uma pergunta que seja pr-requisito de outra, depois dela. Para isso, ser preciso remover a condio antes. O cone para alterao da ordem do grupo de perguntas s ir aparecer quando houver mais de um grupo.

6.

Adicionando uma pergunta

Uma vez tendo criado os grupos de perguntas, pode-se comear a adicionar as perguntas dentro de cada um ou no grupo nico, se for o caso. Para criar uma questo, deve-se clicar no cone direita da barra de menu de Grupos de Perguntas.

Ao adicionar uma pergunta, ser preciso preencher o Cdigo da Pergunta, a Pergunta, a Ajuda (opcional) e o Tipo da Pergunta. Todas as questes estaro associadas ao Grupo que foi selecionado antes de clicar em Adicionar Pergunta, o que pode ser alterado mais tarde.

Descrio dos Campos Cdigo da Pergunta: a identificao (nmero ou cdigo) para a questo. Esse campo serve apenas para uma rpida identificao da pergunta durante exportao ou avaliao. Procure ser consistente na codificao. O planejamento facilita bastante a avaliao posteriormente. Pergunta: Esse o texto da pergunta, de fato. No h limite para seu tamanho. Caso necessrio, possvel dar explicaes sobre a pergunta, utilizando o campo Ajuda. Cdigo HTML pode ser ser usado para incluir imagens, como por exemplo: <img src="http://www.yourdomain.com/yourpics/pic.jpg">
7 Data Verso: 06/10/2008

Informao da tabela de cdigo de acesso possvel inserir informao/texto da tabela de cdigos de acesso na pergunta para que ela mostre informao relacionada ao contexto. Para o LimeSurvey fazer isso, o questionrio precisa ter sido definido como NO ANNIMO e ter uma tabela de cdigos. Os campos disponveis so: {TOKEN:FIRSTNAME} Insere o valor do campo "firstname" na tabela de cdigo acesso {TOKEN:LASTNAME} Insere o valor do campo "lastname" na tabela de cdigo acesso {TOKEN:EMAIL} Insere o valor do campo "email" na tabela de cdigo acesso {TOKEN:ATTRIBUTE_1} Insere o valor do campo "attribute_1" na tabela de cdigo acesso {TOKEN:ATTRIBUTE_2} Insere o valor do campo "attribute_2" na tabela de cdigo acesso de de de de de

Para usar essa funcionalidade, voc deve digitar o texto da pergunta, inserindo uma das variveis acima, como mostrado no exemplo a seguir: Ol {TOKEN:FIRSTNAME}. Foi enviado a voc um e-mail usando o seguinte endereo {TOKEN:EMAIL}. Est correto? Ateno, pois se houver espao ou erro de digitao, o script no tem como fazer a correo. Informao da resposta anterior Tambm possvel incluir a resposta de perguntas anteriores no texto de uma pergunta com as seguintes condies: A pergunta deve ter sido respondida em uma pgina previamente apresentada no questionrio respostas a perguntas na pgina atual no estaro disponveis. Voc deve se referir ao nmero de identificao correto do Questionrio, do Grupo de Perguntas e da Pergunta para a qual a resposta foi dada na seguinte forma: {INSERTANS:SIDXGIDXQID} isto {INSERTANS:1X2X3}.

Continuao da Descrio dos Campos Ajuda: Campo opcional. til se a pergunta precisa de alguma explicao para ser respondida. Ao colocar um texto nesse campo, um cone Sinal de Interrogao aparece nas telas de entrada do questionrio com o texto de ajuda ao lado. Tipo de Pergunta: Determina o tipo de resposta que o questionrio permite. Veja a seo Tipos de Pergunta para uma descrio das vrias opes disponveis. Conjunto de legendas: Para alguns tipos de perguntas, possvel escolher um conjunto de legendas. Para exibir legendas de um determinado idioma, preciso t-lo disponvel no questionrio. Veja a seo Definio de Legendas.. Validao: Funcionalidade disponvel em todos os tipos de perguntas que compreendam texto livre. ("Texto Livre Curto", "Texto Livre Longo", "Data" ou
8 Data Verso: 06/10/2008

"Numrico"). possvel usar um padro de expresses regulares (ver Expresses Regulares) nesse campo para validar as respostas pergunta. Caso no sejam aprovadas, ser apresentada uma mensagem ao usurio, que dever modific-las antes de prosseguir. Outros: A depender do tipo de pergunta escolhida, pode aparecer essa opo. Permite que o participante d uma outra resposta, acrescentada por ele, diferente das apresentadas pela pergunta. Obrigatria: Disponvel para todos os tipos de perguntas, exceto as perguntas texto. Definir uma pergunta como obrigatria requer do participante do questionrio uma resposta antes de passar prxima questo. Atributos da Pergunta: Veja mais na seo Atributos da Pergunta.

Importando uma Pergunta Na parte inferior do Formulrio para novas perguntas, h uma caixa para importar um arquivo de perguntas. possvel importar qualquer arquivo de pergunta (*.csv) que tenha sido exportado anteriormente o que til, por exemplo, se voc deseja utilizar uma questo de outro questionrio. Importante: Ao importar uma pergunta, uma nova ser criada. Para copiar uma pergunta dentro do mesmo questionrio, recomendamos usar a funo Copiar Pergunta, por ser mais fcil.

7.

Mudando a ordem das perguntas

possvel reordenar as perguntas, clicando no cone na barra de botes do Grupo de Perguntas. Se o questionrio tiver mais de uma pergunta, elas sero ordenadas conforme a ordem estabelecida. Pode-se alter-la, simplesmente clicando nos botes Para cima e Para baixo. Deve-se prestar ateno existncia de pr-requisitos ou condies entre perguntas, pois o sistema no permitir colocar uma pergunta que seja pr-requisito de outra, depois dela. Para isso, ser preciso remover a condio antes.

9 Data Verso: 06/10/2008

8.

Tipos de perguntas do LimeSurvey

H uma grande variedade nos tipos de perguntas disponveis no LimeSurvey. Abaixo, segue uma descrio detalhada sobre cada um. Classificao: Permite apresentar ao participante uma lista de possveis respostas/opes, que ele pode ordenar de acordo com sua preferncia. Ex: Ordene as cores, comeando pelas suas preferidas:

Data: Ex: Quando voc nasceu?

10 Data Verso: 06/10/2008

Entrada Numrica: Requer uma resposta que s contenha nmeros: 1 2 3 4 5 6 7 8 9 0 Ex.: Quantos anos voc tem?

Entrada Numrica Mltipla: Permite perguntas com mltiplas respostas com entradas numricas: 1 2 3 4 5 6 7 8 9 0

11 Data Verso: 06/10/2008

Lista (Dropdown): A partir de uma srie de opes, o participante deve escolher uma resposta.

Lista (Legendas personalizadas) Dropdown - com Legendas customizveis a partir do Editor de Legendas:

Lista (Legendas personalizadas) Radio:

12 Data Verso: 06/10/2008

Lista (Radio):

Lista com Comentrio: A partir de uma srie de opes, o participante deve escolher uma resposta. A pergunta inclui uma rea para explicar a escolha.

Matriz (Aumentar/Manter/Reduzir): Permite apresentar ao participante uma lista com possveis respostas/opes que podem receber as seguintes respostas: Aumentar/Manter/Reduzir

13 Data Verso: 06/10/2008

Matriz (Legendas Personalizadas) Escala Dupla: Permite apresentar ao participante uma pergunta com dois grupos de legendas personalizadas.

Matriz (Legendas personalizadas) Radio: Uma matriz com legenda personalizada, pr-definida, formando um cabealho, permite ao participante responder a uma srie de possveis opes. Uma vez criadas, as legendas podem ser reutilizadas em outras perguntas/ questionrios.

Legenda personalizada

Diferencial de Semntica: Essa uma modificao da Matriz (Legendas personalizadas) Radio. Voc precisa escolher Matriz (Legendas personalizadas) Radio como tipo da pergunta, e depois dividir a resposta que dever estar esquerda da que estar direita da matriz, usando o caractere '|'. Por exemplo: Se desejar manter 'Bom' e 'Ruim' esquerda e direita da linha, digite 'Bom|Ruim' no campo de resposta.

14 Data Verso: 06/10/2008

Matriz (Legendas personalizadas) por Coluna: Semelhante a Matriz (Legendas personalizadas) (Radio), com a diferena que linhas e colunas so trocadas.

Matriz (Legendas personalizadas) por Coluna com Diferencial de Semntica:

15 Data Verso: 06/10/2008

Matriz (Seleo de 10 Pontos): Permite apresentar ao participante uma lista com possveis respostas/opes que podem receber uma classificao de 1 10.

Matriz (Seleo de 5 Pontos): Permite apresentar ao participante uma lista com possveis respostas/opes que podem receber uma classificao de 1 5. (Ex: Em que grau voc concorda com a seguinte declarao? (1=Concorda totalmente, 5=Discorda totalmente)

16 Data Verso: 06/10/2008

Matriz (Sim/No/No sei): Permite apresentar ao participante uma lista de possveis respostas, para as quais ele pode responder Sim, No ou No sei. Ex: Voc concorda com as seguintes proposies?

Mudana de Idioma: Com essa pergunta possvel troca o idioma do questionrio. A partir de uma lista de opes, o usurio pode selecionar dentre as opes disponveis.

Mltipla Escolha: Oferece uma srie de opes, permitindo ao participante escolher a resposta que achar melhor: nenhuma, uma ou mais de uma.

17 Data Verso: 06/10/2008

Mltipla Escolha com Comentrio: Oferece uma srie de opes, permitindo que o participante escolha a resposta que achar melhor: nenhuma, uma ou mais de uma, e ainda fazer um comentrio sobre cada uma.

Pergunta Explicativa: No exatamente uma pergunta, mas apenas um texto para explicao, instrues ou comentrio. No possvel responder.

Seleo de 5 pontos: Permite atribuir nota de 1 5:

Sexo:

18 Data Verso: 06/10/2008

Sim/No: D opo para o participante responder Sim ou No.

Texto livre Curto, Longo ou Muito Longo: Permite dar respostas curtas, longas ou escrever a histria da sua vida.

19 Data Verso: 06/10/2008

Textos Curtos Mltiplos: Permite perguntas com mltiplas respostas em texto curto.

20 Data Verso: 06/10/2008

9.

Atributos das perguntas

Atributos da pergunta so uma forma de acrescentar controle extra a sua apresentao ou funcionalidade. Atributos adicionais ainda podem ser desenvolvidos facilmente por programadores de PHP e acrescentados lista de opes de atributos. Tipos diferentes de perguntas possuem tipos diferentes de atributos. Cada um tem um campo Valor associado, que indica se o atributo se aplica ou no (normalmente, usa-se "1" para aplicar), ou indica o valor usado pelo atributo. Uma pergunta pode ter mais de um atributo. Atributos disponveis: answer_width Define a largura da linha de resposta. array_filter Pode ser usado para filtrar respostas apresentadas a partir da seleo de respostas de uma pergunta de mltipla escolha. O objetivo remover respostas por categorizao ou classificao. Apenas disponvel em matrizes, o valor desse atributo deve ser definido no cdigo da questo de uma pergunta de mltipla escolha. code_filter Pode ser usado para filtrar os cdigos de legenda da pergunta baseado numa resposta dada anteriormente. Seu objetivo refinar as possveis opes a resposta da questo anterior comparada ao cdigo da legenda da pergunta atual. Os cdigos das legendas devem ter um nmero mximo de 5 caracteres. display_columns Atributo disponvel para as perguntas do tipo Lista Dropdown/Radio e Mltipla escolha. Permite exibir as respostas para a questo em mais de uma coluna. Ao usar esse atributo, indique o nmero de colunas que deseja. display_rows Define o nmero de linhas para a janela de resposta das perguntas do tipo Texto livre longo, cujo nmero padro 5; e tambm para as perguntas Texto Muito Longo, cujo nmero padro 30. Se o usurio digitar mais linhas, aparecer uma barra de rolagem. dropdown_date Ao colocar dropdown_date igual a 1, em vez de mostrar o calendrio para escolha da data, sero exibidas 3 caixas: uma para selecionar o dia, outra para selecionar o ms, e outra, o ano. Data
Dia Ms Ano --

Ex.: Quando seu aniversrio?

21 Data Verso: 06/10/2008

dropdown_prepostfix Em perguntas de escala dupla (com use_dropdown = 1), ao definir um texto para o atributo dropdown_prepostfix, ele ser exibido como separador depois da resposta e entre as caixas dropdown. Matriz Leg Pers Escala Dupla
Coluna A Gosta de Sep1 Prepostfix esquiar Gosta de Sep1 Prepostfix nadar Gosta de Sep1 Prepostfix correr
Sem resposta

Coluna B Sep2 Prepostfix

Sem resposta

Sem resposta

Sep2 Prepostfix

Sem resposta

Sem resposta

Sep2 Prepostfix

Sem resposta

dropdown_separators Em perguntas de escala dupla (com use_dropdown = 1), caso dropdown_separators tenha sido definido, o layout apresentar o texto informado como separador depois da resposta e entre as caixas dropdown. O formato a ser usado Separator1|Separador2. Matriz Leg Pers Escala Dupla
Coluna A Gosta de esquiar Sep1 Gosta de nadar Sep1 Gosta de correr Sep1
Sem resposta Sem resposta Sem resposta

Coluna B Sep2 Sep2 Sep2

Sem resposta Sem resposta Sem resposta

dualscale_headerA/dualscale_headerB Em perguntas de escala dupla, esse o texto que ser apresentado como cabealho para a coluna A e como cabealho para a coluna B. Matriz Leg Pers Escala Dupla
Coluna A Gosta de esquiar Sep1 Gosta de nadar Sep1 Gosta de correr Sep1
Sem resposta Sem resposta Sem resposta

Coluna B Sep2 Sep2 Sep2

Sem resposta Sem resposta Sem resposta

equals_num_value

22 Data Verso: 06/10/2008

Permite defiinir a soma que deve ser obtida com as respostas. Disponvel em questes do tipo entrada numrica mltipla. Um exemplo disso seria colocar equals_num_value = 100. A soma dos valores colocados em cada entrada no poderia ser diferente de 100. exclude_all_others Vlido apenas para perguntas tipo mltipla escolha. O valor associado a esse atributo dever ser o cdigo de uma das respostas da questo. Quando essa resposta for marcada, no mais ser possvel marcar nenhuma outra, ou caso alguma outra j esteja marcada, o sistema, automaticamente, desmarcar ela. Para o exemplo abaixo, caso seja colocado exclude_all_others igual a 4, ao marcar Todas as opes anteriores no ser mais permitido escolher nenhuma outra. possvel marcar as opes 1, 2, 3 e 5 simultaneamente, porm no a opo 4.
*Computador, para voc, PRINCIPALMENTE:
Escolha a que mais se adeque

Um instrumento de trabalho Uma forma de lazer Lista telefnica, enciclopdia, dicionrio, mapa... Todas as opes anteriores Nenhuma das opes anteriores

hide_tip A maioria das perguntas apresenta "Selecione" ou similar. Esse atributo permite no apresentar essa pequena introduo para alguns tipos de pergunta. Exemplo: "hide_tip 1" max_answers Usado para limitar um nmero mximo de opes que o participante pode marcar em perguntas de mltipla escolha. Por exemplo, se definido como igual a 2, s ser possvel marcar no mximo 2 checkboxes (quadrinhos) ou 1 checkbox, alm de preencher o campo Outros, por exemplo, caso disponvel. max_num_value Permite defiinir a soma mxima a ser obtida com as respostas. O valor definido para esse atributo representa o valor mximo. Disponvel em questes do tipo entrada numrica mltipla. Um exemplo disso seria colocar max_num_value = 100. A soma dos valores colocados em cada entrada no poderia ultrapassar 100: 101 no seria aceito; qualquer valor menor ou igual a 100, seria.

maximum_chars

23 Data Verso: 06/10/2008

Disponvel para questes tipo texto. Define o nmero mximo de caracteres para a resposta. Ao entrar com 20, por exemplo, o participante no consegue digitar mais de 20 caracteres no campo da resposta. min_num_value Permite defiinir a soma mnima a ser obtida com as respostas. O valor definido para esse atributo representa o valor mnimo. Disponvel em questes do tipo entrada numrica mltipla. Um exemplo disso seria colocar min_num_value = 20. A soma dos valores colocados em cada entrada no poderia ser inferior a 20. numbers_only S funciona para o tipo de questo de Mltiplos textos curtos. Faz com que todas as caixas de texto aceitem apenas nmeros. Exemplo: "numbers_only 1". other_replace_text Permite colocar texto curto para substituir a palavra Outros. S est disponvel nas questes em que Outros pode ser usado, como: Lista (Dropdown), Lista (Radio), Lista (Legendas personalizadas) Dropdown, Lista (Legendas personalizadas) Rdio, Mltipla escolha, e Mltipla escolha com comentrios. Ao colocar a palavra Alternativa para esse atributo, em vez de aparecer Outros vai aparecer Alternativa. prefix Permite acrescentar um prefixo (texto) antes da caixa de entrada de texto. Por exemplo: Colocar "R$" para esse atributo, faz aparecer a representao de moeda em Real, antes da caixa texto em questo. random_order Aplica-se a qualquer tipo de pergunta que tenha uma lista de possveis respostas, fazendo com que o LimeSurvey ignore a ordem existente e ordene as respostas randomicamente. importante notar que a cada vez que a questo for apresentada, ser de uma forma diferente, assim se algum voltar ao questionrio, ela dever estar diferente da vez anterior. Ter as respostas dessa forma til para evitar influncias ou tendncias nas respostas. O valor do atributo deve ser definido como 1 para habilit-lo. suffix Permite acrescentar um sufixo (texto) aps a caixa de entrada de texto. Por exemplo: Colocar "%" para esse atributo, faz aparecer a representao percentagem, aps a caixa texto em questo.

24 Data Verso: 06/10/2008

text_input_width Define a largura da caixa de resposta, mas sem limitar o nmero de caracteres. use_dropdown Em perguntas com escala dupla (Matriz Legendas Personalizadas - Escala Dupla), quando esse atributo est definido como igual a 1, o layout ser dropdown, em vez linhas de boto de rdio. Com use_dropdown = 1 Matriz Leg Pers Escala Dupla
Coluna A Gosta de esquiar Sep1 Gosta de nadar Sep1 Gosta de correr Sep1
Sem resposta Sem resposta Sem resposta

Coluna B Sep2 Sep2 Sep2

Sem resposta Sem resposta Sem resposta

Sem usar o atributo use_dropdown Matriz Leg Pers Escala Dupla

Coluna A
Nunca Raramente Freqentemente Sempre

Coluna B
Elevado Mdio Baixo Sem resposta

Gosta de esquiar Gosta de nadar Gosta de correr

10. Adicionando as possveis respostas

Vrios tipos de perguntas requerem que seja adicionada uma lista de possveis respostas para os participantes escolherem ou que sero usadas como cabealho para as respostas. Para incluir as respostas, clique no cone na barra de botes das Perguntas. "Adicionar/Editar Respostas para essa Pergunta

Ao adicionar uma resposta, ser preciso informar um Cdigo, uma Resposta e se ela "Default". 1. Cdigo da Resposta: Esse o dado usualmente exportado para a planilha ao compilar os resultados. Pode ser qualquer cdigo, desde que tenha, no mximo, 5 caracteres alfanumricos. 2. 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 opes. Por exemplo: Para colocar Bom e Ruim direita e esquerda da linha, digite 'Bom|Ruim' nesse campo. Isso bastante til para criar perguntas com diferenas de semntica. 3. Ordenamento: Determina a ordem das respostas. Pode-se usar os botes "Para cima" e "Para baixo" ao lado de cada resposta para mudar sua posio na lista.
25 Data Verso: 06/10/2008

4. Default: Uma das respostas pode ser marcada como default, ou seja, j ser apresentada como a escolhida, a menos que o participante mude. Coloque o campo Default com "Y" (yes), caso deseje que aquela resposta seja a default.

11. Tela de status do questionrio

Na barra de Administrao, ao selecionar um questionrio, pode-se consultar os dados configurados para o mesmo. A maioria auto-explicativa; so as informaes definidas durante a Criao ou Edio do Questionrio:

1. Ttulo: O ttulo do questionrio seguido pela sua identificao. 2. URL do Questionrio: URL usada para acessar o questionrio pela Internet. Exemplo: http://www.yourdomain.com/limesurvey/index.php?sid=xxx&lang=zz Onde xxx a identificao do questionrio; zz o cdigo do idioma do questionrio. Se o questionrio usar cdigo de acesso, adicionado "&token=yy" ao final da URL. yy o cdigo de acesso. 3. Descrio: Uma descrio para o questionrio. 4. Mensagem de Boas Vindas: O texto apresentado na pgina inicial. 5. Administrador: Nome do administrador, seguido do seu e-mail. 6. Fax para: Nmero de fax automaticamente preenchido, quando o questionrio impresso. 7. Data de Expirao: Se tiver sido definida uma data para expirao do questionrio, ser mostrado aqui. 8. Modelo: O modelo do formulrio usado para o questionrio. 9. Idioma Base: Idioma principal para o questionrio. 10. Idiomas Adicionais: Idiomas que foram usados para o questionrio em questo. 11. Link para sada: Link para a URL final, apresentada ou carregada quando um questionrio enviado com sucesso. 12. Nmero de perguntas/grupo: Mostra o nmero de perguntas e grupos no questionrio em questo. 13. Pesquisa ativa no momento: Mostra o status do questionrio ativo ou no ativo. 14. Nome da tabela do questionrio: Se o questionrio estiver ativo, o nome da tabela no banco de dados ser mostrado. 15. Outras informaes (Dicas): Se annimo ou no. Formato do questionrio: Pergunta por pergunta, Grupo a grupo ou Todas as perguntas em uma s pgina. Se a data de envio das respostas gravada ou no. Se endereos IP so registrados ou no. Se a URL de referncia gravada ou no. Se so utilizados cookies. Se permitido ou no salvar o questionrio. Se ter notificao por e-mail. Se gera novos cdigos de perguntas: o Normal (Direto): Cada pergunta recebe um novo cdigo. A primeira, 001; a segunda, 002; a terceira, 003,... (A ordem do grupo ignorada). o Por grupo: Cada pergunta recebe um novo cdigo. A primeira pergunta de cada grupo, 001; a segunda de cada grupo, 002; a terceira, 003,...

12. Testando um questionrio

26 Data Verso: 06/10/2008

Pode-se testar um questionrio durante a sua criao, atravs do boto Testar o Questionrio na seo Questionrio. Isso permite visualizar o questionrio, antes de ativ-lo. Durante esse teste, as respostas no sero salvas.

13. Ativando um questionrio

Ao concluir a estrutura do questionrio, deve-se ativ-lo clicando no cone Questionrio". Ativar um questionrio implica em: "Ativar

1. Criar uma tabela no banco de dados MySQL separada para conter todas as respostas. 2. Permitir s pessoas entrar com dados naquela tabela e dar acesso a outros aspectos do questionrio, incluindo browse e recursos de cdigo de acesso. 3. Dar-lhe permisso aos recursos dos cdigos de acesso. Depois que o questionrio for ativado, o boto Ativar/editar cdigos de acesso para o questionrio ficar disponvel. (Ver seo Cdigos de Acesso). 4. Se o questionrio foi definido como "No annimo, aparecer uma mensagem perguntando se deseja mudar para o modo restrito, quando ento uma tabela de cdigos de acesso ser criada automaticamente. O questionrio ativado, clicando-se no boto "Ativar Questionrio" da barra de Questionrio. Se o cone no estiver aparecendo, porque o questionrio ainda no est pronto para ser ativado. Depois de clicar nele, o LimeSurvey vai executar uma rpida consistncia para certificar-se que o questionrio funcione corretamente. Antes de ativar o questionrio, deve-se observar algumas regras: Com o questionrio ATIVO: a) Ainda ser possvel: Alterar o nome ou descrio do questionrio Editar (alterar) os nomes de grupo Editar (alterar) cdigo ou texto das perguntas Incluir, apagar ou editar respostas pr-definidas para perguntas (exceto no caso de questes com respostas mltiplas) Incluir e alterar atributos das perguntas Mudar a pergunta de um grupo para outro Definir condies para a pergunta Mudar a obrigatoriedade da pergunta Colocar validao para a pergunta Incluir ou remover respostas para perguntas que exigem apenas uma opo na resposta

b) No mais ser possvel: Incluir ou apagar grupos Incluir ou apagar perguntas Modificar o tipo da pergunta Incluir ou remover respostas para perguntas de mltipla escolha Depois que dados forem adicionados a esse questionrio, caso deseje adicionar ou apagar grupos ou perguntas, ser preciso desativar o questionrio, lembrando que isso far com que

27 Data Verso: 06/10/2008

toda informao j existente seja movida para uma tabela separada. Veja mais na seo Fechando um Questionrio.

14. Editando modelos de e-mail

Opo disponvel dentro de cada questionrio. acesso para o questionrio, indo no cone definindo um texto padro para cada modelo. do sistema para os participantes cadastrados na padronizado. Ao clicar em Ativar/editar cdigos de possvel Editar modelos de e-mail, Dessa forma, todo e-mail enviado a partir tabela com cdigo de acesso ter o texto

1. Assunto do e-mail de Convite: O campo Assunto do e-mail quando o questionrio enviado aos participantes. 2. E-mail Convite: Texto do e-mail que convida os participantes para o questionrio, enviando cdigos de acesso. Inicialmente j vem preenchido com um texto (definido no arquivo com a traduo de cada idioma), mas pode ser alterado conforme a necessidade. Deve-se preencher um formulrio com os campos abaixo para inserir informaes individuais em cada e-mail. bom lembrar que se no forem utilizados cdigos de acesso para o questionrio, esse campo ser irrelevante a) {FIRSTNAME} substitudo pelo campo "firstname" na tabela de cdigo de acesso. b) {LASTNAME} - substitudo pelo campo "lastname" na tabela de cdigo de acesso. c) {SURVEYNAME} - substitudo pelo nome do questionrio. d) {SURVEYDESCRIPTION} - substitudo pela descrio do questionrio. e) {ATTRIBUTE_1} - substitui o campo "atributo_1" da tabela de cdigo de acesso. f) {ATTRIBUTE_2} - substitui o campo atributo_2" da tabela de cdigo de acesso. g) {SURVEYURL} - substitudo pela URL para o questionrio. 3. Assunto do e-mail de Lembrete: Depois de j ter enviado um convite para o questionrio, caso ela ainda no tenha sido respondida pelo participante, possvel enviar novo e-mail, relembrando-o do questionrio. Esse o campo Assunto do email em questo. Novamente, vale lembrar que envio de e-mail s possvel quando se utiliza cdigo de acesso. 4. E-mail Lembrete: Texto do e-mail Lembrete que enviado, quando o questionrio usa cdigos de acesso. 5. E-mail de Confirmao - Assunto: Quando os cdigos de acesso so usados, esse campo contm o assunto do e-mail que ser, automaticamente, mandado aos participantes que enviarem o questionrio. 6. E-mail de Confirmao: Texto do e-mail que mandado automaticamente aos participantes quando enviarem seus questionrios respondidos. 7. E-mail Inscrio Pblica - Assunto: Esse o campo que contm o Assunto do e-mail a ser enviado quelas pessoas que se inscreveram para o questionrio. 8. E-mail Inscrio Pblica: Texto para o e-mail enviado s pessoas que se inscreveram para o questionrio. Os mesmos campos de formulrio se aplicam como visto anteriormente.

15. Executando um questionrio com segurana

Depois que o questionrio for ativado e j estiver recebendo as respostas, vale a pena considerar os seguintes pontos:

28 Data Verso: 06/10/2008

Exportar a estrutura do questionrio ( lugar seguro.

) imediatamente e salvar o arquivo .csv file em

Regularmente, visitar a tela de "browse" ( ) para exportar as respostas recebidas e manter uma cpia do arquivo. Procurar no fazer alteraes no questionrio. Algumas partes do questionrio continuam podendo ser modificados mesmo ele tendo sido ativado, e apesar disso no causar problemas, melhor ter cautela. Teste detalhadamente seu questionrio antes de ativ-lo e tente deix-lo exatamente como est. Se tiver acesso ao phpMyAdmin ou recurso similar, faa backups regularmente de todo o banco de dados (estrutura e dados). Se o pior acontecer e todo o banco for perdido, ser possvel recri-lo, importar as tabelas do backup e o LimeSurvey muito provavelmente poder recomear de onde parou.

16. Visualizando resultados de questionrios

A funo Visualizar as respostas do questionrio ( ) pode ser utilizada para, aps o questionrio ter sido ativado, obter informaes sobre as respostas enviadas at o momento, a fim de visualizar ou exportar as respostas. Quando o questionrio est ativo, o boto Visualizar as respostas do questionrio aparece. Ao clicar nesse boto, a tela principal, Mostrar informaes resumidas, ser exibida, informando a quantidade de respostas para o questionrio at o momento: O nmero total de respostas gravadas: completas e incompletas O nmero total de respostas recebidas (enviadas) O nmero total de respostas incompletas gravadas

Respostas incompletas so registros de respostas que ainda no foram enviadas e podem ocorrer nas seguintes situaes: quando um participante usa a funo Salvar at o momento, mas no enviar, ou quando um operador usa o recurso de entrada de dados sem 'Finalizar o envio', ou ainda, quando h uma falha na finalizao do questionrio de um participante por um problema no browser, por exemplo. As demais opes so descritas abaixo: Administrao: Retorna tela principal de administrao de questionrios. Mostrar informaes resumidas: Exibe o total de respostas at o momento. Mostrar respostas: Exibe todos os resultados do questionrio. Mostra o texto das perguntas e as respostas. Mostrar as 50 ltimas respostas: Exibe as ltimas 50 respostas do questionrio, ordenadas da mais recente para a menos recente. Tela para entrada de dados: Exibe a tela de entrada de dados para responder ao questionrio (essa opo tambm est disponvel a partir da tela de administrao). Obter estatsticas a partir das respostas: Uma forma simples para filtrar e obter resumo das respostas. (Veja a seo Estatsticas). Exportar resultados para aplicativo: Exportar todas as respostas do questionrio para o Word, Excel ou arquivo CSV. (Ver seo Exportando Resultados). Exportar resultado para um arquivo de comandos SPSS: Exportar todas as respostas do questionrio para um arquivo SPSS. Importar respostas da tabela de um questionrio desativado: Importar todas as respostas de um questionrio desativado para o ativo em questo.
29 Data Verso: 06/10/2008

Ver respostas salvas, mas no enviadas: Visualizar as respostas incompletas que podem ocorrer nas seguintes situaes: quando um participante usa a funo Salvar at o momento, mas no enviar, ou quando um operador usa o recurso de entrada de dados sem 'Finalizar o envio', ou ainda, quando h uma falha na finalizao do questionrio de um participante por um problema no browser, por exemplo. Importar um arquivo de questionrio VV: Importar um arquivo de questionrio de Verificao Vertical. Exportar um arquivo de questionrio VV: Exportar um arquivo de questionrio de Verificao Vertical.

17. Fechando um questionrio

H 2 formas de se encerrar um questionrio, cada uma prestando a um objetivo diferente: a) Desativao - Clique em "Desativar o Questionrio" na barra de botes Questionrio. Todos os resultados j existentes sero movidos para uma tabela separada, no mais sendo possvel acess-los pelo LimeSurvey, apenas pelo banco de dados. Do ponto de vista da aplicao, todas as informaes respondidas sero perdidas. Todas as questes, grupos e parmetros podero ser editados de novo. Um questionrio desativado permanece acessvel (voc v todas as questes, apenas no pode salvar os dados). Voc pode reativ-lo para usar novamente. Opo interessante, caso deseje alterar as perguntas e/ou opes de respostas, aps j ter ativado o questionrio, mas tenha nenhum ou poucos resultados enviados.

b) Expirao - Entre para editar os detalhes do questionrio, escolha "Expirar?" e preencha a "Data para Expirar". Nenhum resultado ser perdido. Nenhuma informao respondida ser perdida. Alteraes nas perguntas, grupos de perguntas e parmetros sero limitadas. Um questionrio expirado no permanece acessvel. Uma mensagem de que ela j expirou passa a ser apresentada.

18. Entrada de dados

Abra a tela de Entrada de Dados, clicando no cone . Essa funo no dever estar disponvel aos participantes de seu questionrio. Seu objetivo dar entrada em uma massa de dados de questionrios finalizados, e para isso foi projetada para digitao, usando tabs, barra de espao, setas, teclado numrico etc. Teclas de Atalho: Tecla Tab: mover para a prxima pergunta Tecla Shift + Tecla Tab: volta para a pergunta anterior A opo "Finalizar envio de respostas" finaliza a gravao dos registros ao: Adicionar a data de envio ao registro, o que vai deixar o questionrio finalizado disponvel para questes de visualizao de respostas ou computao de estatsticas. Marcar o cdigo de acesso como j usado (se o questionrio tiver cdigo de acesso).
30 Data Verso: 06/10/2008

Se a opo "Finalizar envio de respostas" no for marcada, a resposta ser considerada como no preenchida completamente e o cdigo de acesso permanecer disponvel para outro participante.

19. Cdigos de acesso

Em muitas ocasies, voc poder querer convidar um grupo de pessoas para participar do questionrio, acompanhar quem j terminou e ter a certeza de que cada um participe apenas uma vez. Cdigos de acesso podem ser inicializados assim que o questionrio tiver sido ativado e permitem realizar o seguinte: Importar uma lista de nomes e e-mails para os participantes (de um arquivo CSV ou de uma query LDAP) ou adicionar/remover indivduos. Gerar um cdigo de acesso nico para cada participante. Enviar um convite por e-mail para cada pessoa de sua lista, seja em grupo, seja individualmente. Enviar um lembrete para cada pessoa de sua lista que ainda no tenha respondido, em grupo ou individualmente. Acompanhar quem de sua lista j respondeu. Restringir o acesso daquelas pessoas que no receberam um cdigo e daqueles que possuem um cdigo, mas j responderam. Editar/alterar qualquer detalhe em sua lista.

Depois de ativar os cdigos para um questionrio, as nicas pessoas que podero acess-la so aquelas que receberam um. Os cdigos de acesso so combinados aos questionrios definidos como no-annimos, durante a sua criao. Assim, se um questionrio for no-annimo, ento a lista de cdigos pode ser usada para encontrar a resposta de um determinado participante. Entretanto, quando um questionrio for annimo, mesmo havendo o cdigo de acesso atribudo a cada participante, no haver ligao entre tabela de cdigo de acesso e as respostas, garantindo ao mesmo tempo o anonimato e a segurana da unicidade da resposta. Veja, a seguir, uma breve explicao das opes de menu na tela de Cdigos de Acesso: Administrao: Retorna tela principal de administrao de questionrios. Exibir resumo dos cdigos de acesso: Apresenta um sumrio de cdigos na tabela (nmero de cdigos, quantos foram enviados, quantos responderam). Tambm d acesso s funes de Administrao do Banco de Dados (veja abaixo). Exibir cdigos de acesso: Apresenta a lista completa de participantes na tabela de cdigos. A partir dessa tela, pode-se editar ou apagar entradas individuais, bem como realizar uma srie de outras funes. (Veja a seo Exibindo os cdigos de acesso abaixo). Incluir cdigo de acesso: Permite incluir uma entrada (um participante) na tabela de cdigos de acesso. Importar cdigos de acesso a partir de um arquivo CSV: o O arquivo deve ser padro CSV (delimitado por vrgulas), com aspas duplas em torno dos valores (default para OpenOffice e Excel). A primeira linha deve conter o cabealho (que ser removido) e os dados devem ser ordenados da seguinte forma:

31 Data Verso: 06/10/2008

"primeiro_nome","ultimo_nome","email","codigo_de_acesso","codigo_de_idiom a","atributo1","atributo2","tid". Apenas os 3 primeiros campos so obrigatrios Registros duplicados so identificados por primeiro_nome, ultimo_nome e email. Se um registro desses for encontrado durante a importao, a linha correspondente ser omitida. Importar cdigos de acesso a partir de query LDAP: Permite importar informao de uma query LDAP (testado em um openLDAP, mas deve funcionar em qualquer diretrio LDAP equivalente, incluindo ActiveDirectory) Exportar cdigos de acesso 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 questionrios futuros. necessrio que os campos de primeiro nome, sobrenome e email estejam preenchidos. Editar modelos de e-mail: veja com mais detalhes em seo especfica nesse manual. Enviar convite por e-mail: Envia convites em massa, por e-mail a todos os participantes da tabela de cdigo de acesso que para os quais ainda no foi enviado. Enviar lembrete por e-mail: Envia e-mail em massa, para lembrar queles participantes da tabela de cdigos que j receberam o convite, mas ainda no responderam ao questionrio. Gerar cdigos de acesso: Cria cdigo de acesso nico para cada participante da tabela de cdigos que ainda no possui um. Apagar tabela de cdigos de acesso: Apaga a tabela criada. o

Os seguintes campos aparecem no modelo de e-mail para convite e lembrete, e devem ser informados nas propriedades do questionrio. Ao enviar os e-mails, esses campos sero substitudos pelo contedo informado. {ADMINEMAIL} E-mail do administrador do questionrio {ADMINNAME} Nome do administrador do questionrio {SURVEYNAME} Ttulo do questionrio {SURVEYDESCRIPTION} Descrio do questionrio Os campos abaixo aparecem no assunto e/ou corpo dos e-mails enviados (convite ou lembrete): {EMAIL} E-mail do destinatrio {FIRSTNAME} Primeiro nome {LASTNAME} Segundo nome {SURVEYURL} A URL pblica apontando para o incio do questionrio {TOKEN} Cdigos de acesso para o questionrio {ATTRIBUTE_1} Atributo_1 {ATTRIBUTE_2} Atributo_2

Administrao do banco de dados A tela que apresenta um breve resumo, acessada atravs do cone dos cdigos de acesso, permite acesso a recursos de Administrao incluindo:
32

Exibir o resumo do banco de dados,

Data Verso: 06/10/2008

Marcar todos os participantes com Convite no enviado: Atribui N (No), a todos os registros de que um convite tenha sido enviado. Obviamente, no deve ser usado normalmente. Apagar todos os cdigos de acesso: Remove o cdigo de acesso para todos os participantes que j tenham algum. Mantm os participantes cadastrados. Apagar todos os participantes: Apaga todos os registros (participantes) da tabela de cdigo de acesso. Para que o questionrio possa ser acessado, ainda ser necessrio cadastrar participantes na tabela e gerar cdigo para eles. Apagar tabela de cdigos de acesso: Permite remover o recurso de cdigo de acesso do questionrio. Apaga todos os registros e a tabela, permitindo que o questionrio possa ser acessado por qualquer um que conhea a URL.

Exibir os cdigos de acesso Objetivo: Mostrar uma lista com todos os participantes, tendo ao lado botes que realizam funes especficas, as Aes, para cada um, individualmente. A primeira linha, acima da tabela permite ordenar a exibio dos registros e definir um ponto de incio. 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 Aes mostra uma lista com atividades especficas que podem ser efetuadas em cada um dos participantes. E: Editar o participante D: Apagar o participante S: Responder ao questionrio, usando esse cdigo de acesso R: Enviar lembrete para o participante (s vlido se o convite j foi enviado) I: Enviar um convite para o participante (s disponvel se o convite ainda no foi feito) V: Se o questionrio permitir identificao da resposta (no annima), o boto "V" aparecer, permitindo visualizar a respectiva resposta para aquela entrada. U: Atualizar resposta, permite alterar ou incluir novas informaes s respostas j recebidas.

Permitindo registro pblico possvel deixar o questionrio aberto ao pblico, com controle de participantes. Se tiver sido definido Permitir Inscrio Pblica para o questionrio e a tabela de cdigos de acesso for inicializada, qualquer pessoa que visite o site do questionrio poder se inscrever para participar. Quando o participante informar um e-mail que ainda no exista na tabela de cdigos de acesso, uma entrada ser criada para ele, e um e-mail enviado, convidando-o para o questionrio e fornecendo um nmero como cdigo de acesso. Todos os cdigos fornecidos a participantes que se inscreveram comearo com a letra "R". Nmeros de segurana para Inscrio Pblica (CAPTCHA) Para proteger seu questionrio de inscries automticas, existe o recurso de usar Nmeros de Segurana nos formulrios de Inscrio, Salvar e Carregar. Esses nmeros (captchas) so comuns em sites que para garantir que no haja um programa realizando as inscries, votaes ou outra atividade automaticamente. Uma combinao de nmeros/letras ou uma soma simples apresentada para que o usurio d o resultado num campo determinado. O recurso s est disponvel para quem tem GD-support ativado na configurao do PHP.

20. Definindo quotas para o questionrio

33 Data Verso: 06/10/2008

Uma quota usada para definir um limite de respostas para um determinado grupo de pessoas em um questionrio ativo. Alguns dos atributos mais comumente usados so: sexo, idade, raa, cidade/estado.

Tipos de perguntas utilizadas

No momento, apenas os seguintes tipos de perguntas esto disponveis: Sexo Mltipla escolha Matriz (Seleo de 5 pontos) Matriz (Seleo de 10 pontos) Idioma Sim/No

Adicionando uma quota No sistema, voc deve ir no cone e clicar em Adicionar quota: Nome da quota: deve identificar o que a quota representa. Limite da quota: Nmero mximo de questionrios que podem ser preenchidos para aquela quota. Ao da quota: Ao desejada quando se atinge o valor limite definido. Pode ser concluir o questionrio e exibir um aviso, ou, simplesmente, concluir o questionrio. Concluir questionrio: Finaliza e fecha o questionrio. Terminar o questionrio e exibir aviso: Avisa ao participante da restrio de quota e permite voltar. Depois da quota includa, possvel adicionar respostas. Adicionando respostas Selecione a pergunta: Ao adicionar uma resposta, ser apresentada uma relao das perguntas j criadas no questionrio e disponveis quota. Se uma pergunta no aparecer nessa lista porque no est disponvel para usar com quotas. Depois de escolher, clique em Prximo para ir para a prxima pergunta. Selecione uma resposta: Depois de selecionar a pergunta, ser apresentada uma lista com as possveis respostas, onde voc dever escolher a que se adqe sua necessidade. Quando uma quota estiver cheia possvel alterar a pgina para onde o questionrio ser redirecionado Pode-se encontrar a funo check_quota() no fim do arquivo index.php, na linha 2533, aps o cdigo: ... echo "\t".$clang->gT("Sorry your responses have exceeded a quota on this survey.")."<br /></center>&nbsp;\n" ... Voc pode incluir: echo "<a href=\"index.php?sid=$surveyid&lang=ro&newtest=Y\">NEW</a><br />";

34 Data Verso: 06/10/2008

Isso ir redirecionar para um novo questionrio. Exemplo de uma quota: Pode-se precisar conduzir um questionrio com 25 homens e 30 mulheres. No sistema, voc deve ir no cone e clicar em Adicionar quota. L, deve atribuir: Nome da quota: Sexo Masculino. Limite da quota: Para atender ao caso acima, deve ser estabelecido um limite igual a 25, que ser verificado quando se responde pergunta que corresponde quota. Ao da quota: Ao desejada quando o total de homens a responder o questionrio atinja o valor limite. Feito isso, voc deve clicar em Adicionar pergunta, para selecionar dentre as perguntas cadastradas - no caso Sexo e, depois, selecionar a resposta para ela - no caso Masculino. O mesmo procedimento deve ser adotado para limitar a quota do sexo feminino, adequando seu quantitativo. Isso far com que, no mximo, 25 homens e 30 mulheres completem o questionrio.

21. Estatsticas
Depois de o questionrio ter sido ativado, a partir de sua barra de Administrao, e depois de clicar no boto Visualizar as respostas do questionrio, chega-se tela com o cone em forma de grfico, para gerar Estatsticas. O que esse recurso de Estatsticas? Digamos que voc tenha um questionrio em andamento ou j finalizado e deseje analisar os resultados. O LimeSurvey pode carregar todos os resultados numa planilha Excel (ou arquivo CSV ou um arquivo Microsoft Word) para que voc possa trabalhar como preferir. Opcionalmente, possvel tambm usar a Estatstica do sistema e obter informaes teis a partir dela. Este recurso permite filtrar seus dados e recuperar nmeros e resumos de diferentes campos do questionrio. O sistema no oferece filtros com alto grau de complexidade, mas voc pode se surpreender com o tipo de informao que pode ser facilmente obtido. Filtrando dados Ao comear a usar a funo de estatstica, uma lista de perguntas ser apresentada para possibilitar filtrar os dados. Cada caixa de pergunta mostra o cdigo da pergunta, um boto que pode ser marcado para mostrar um resumo da tabela em questo, 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 opes. Passe por todas as caixas, escolhendo os filtros da sua preferncia. A opo "Filtrar respostas incompletas" permite voc decidir se deseja incluir pesquisas que ainda no foram finalizadas em sua anlise. Depois de clicar em "Ver estatsticas", uma tabela de resultados ser apresentada, mostrando o nmero total de respostas relacionado a cada critrio e um percentual do total.

Visualizar resumo campo a campo

35 Data Verso: 06/10/2008

Com freqncia, voc desejar um resumo de todos os resultados de uma pergunta quanto a um determinado aspecto. Para isso, marque o boto que fica acima da pergunta para a qual deseja o sumrio, defina o critrio nas outras caixas e clique em Ver estatsticas. possvel obter a estatstica de todos os campos, marcando na opo Ver resumo de todos os campos disponveis. Sero apresentadas as tabelas de resultados, indicando o nmero de respostas de acordo com o seu pedido, bem como uma tabela Resumo por campo que sintetizar todas as possveis respostas para a questo selecionada, o total e o percentual. importante observar que esses valores so um subconjunto do total de suas respostas. Assim, se seu critrio tiver 146 registros de um total de 180, o resumo mostrar a anlise apenas dos 146 para aquela tabela. Recomenda-se cuidado nas seguintes situaes: Se voc definiu um filtro na mesma questo em que pediu o resumo, ento a pergunta s apresentar respostas que obedeam ao filtro. Assim, constitui-se boa prtica no definir um critrio na mesma questo onde se vai obter um resumo. Para escolher mais de uma entrada para a pergunta, pressione o boto CTRL ao clicar em cada uma. Para desmarcar a seleo, clique na resposta marcada com, tambm segurando o boto CTRL.

Pesquisando / Exportando resultados filtrados Para exportar as respostas que atendam ao critrio definido, clique no boto Exportar abaixo da tabela 'Resultados'. A tela padro de exportao aparecer, porm ao exportar os resultados, voc s receber as respostas que obedecem a seu critrio. Da mesma forma, clique em Navegar para ver as respostas na tela de pesquisa. JPGraph Grfico Se tiver sido definido no arquivo config.php para usar a biblioteca JPGraph-library, ento alm dos resultados do questionrio, um grfico de barras e um de pizza estaro disponveis. Podese exportar esses grficos facilmente, usando o clique do boto direito do mouse, escolhendo "Salvar a imagem como" e salvar o grfico como um arquivo .png na pasta escolhida. Normalmente, os resultados so apresentados em grfico de pizza; apenas para as perguntas de mltipla escolha, so usados os grficos de barra.

36 Data Verso: 06/10/2008

22. Exportando um questionrio

Naturalmente, tendo concludo um questionrio com dezenas de perguntas que lhe tomaram 5 dias para criar, voc deve desejar fazer um backup. O boto Exportar o questionrio na barra de botes do questionrio ir carregar todos os grupos de perguntas, perguntas, opes de respostas e condies do seu questionrio em um arquivo padro CSV. Esse arquivo poder ser usado novamente depois, usando a funo 'Importar Pesquisa'. O arquivo no contm as respostas enviadas. Estas s podem ser exportadas de pesquisas ativadas pelo menu Visualizar as respostas do questionrio Exportar resultados para aplicativo.
37 Data Verso: 06/10/2008

23. Exportando resultados

Para exportar respostas, clique no boto "Exportar resultados para aplicativo" da tela de visualizao das respostas. Ser apresentada uma nova janela, mostrando as vrias opes de exportao. Cabealhos abreviados: Exporta o ttulo resumido da pergunta. Cabealhos completos: Exporta o ttulo da pergunta como cabealho. Cdigos das perguntas: : Exporta apenas o nmero de identificao da pergunta. Cdigo das respostas: Exporta apenas os cdigos relevantes para cada resposta, para aquelas que so diferentes de campo texto. Respostas completas: Exporta o texto da resposta. Formato Microsoft Word: Exporta os dados como um 'documento' (no formatado e com tabs entre os dados). Formato Microsoft Excel: Exporta os dados como uma planilha. Formato CSV, delimitado por vrgulas: Exporta os dados como um arquivo delimitado por vrgulas. PDF: Exporta os dados como um arquivo PDF.

A tela de exportao tambm permite escolher quais campos sero exportados, e caso o questionrio no seja annimo, ainda possibilita associar a informao de cdigo de acesso, nome, sobrenome, e-mail e atributos a cada resposta. Exportao VV ( ) e Importao VV ( )

Agora que as respostas comearam a ser reunidas, pode ser necessrio editar ou modificar diretamente grandes quantidades de dados da tabela de respostas, e nesse momento, uma ferramenta como a planilha pode ser til. Exportao VV e Importao VV ("VV" significa verificao 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 Importao VV. Exportando um arquivo de pesquisa VV Ao escolher exportar respostas usando Exportao VV, ser dada a opo de exportar as respostas e deixar o questionrio ativo ou exportar as respostas e desativar o questionrio. Ao escolher desativar o questionrio, a tabela de respostas ser renomeada e se tornar apenas acessvel atravs de acesso direto do MySQL (a tabela ser renomeada da mesma forma que acontece quando um questionrio desativado). Caso o questionrio possua cdigos de acesso, observe que desativ-la tambm far com que a tabela de cdigos seja desativada e fique indisponvel. melhor no desativar um questionrio que use cdigos de acesso, a menos que voc saiba como renomear tabelas usando MySQL e possa mover a tabela de cdigos de acesso manualmente. A possibilidade de desativar o questionrio importante porque um arquivo de pesquisa VV permite importar respostas para um questionrio quando a combinao pergunta/resposta foi
38 Data Verso: 06/10/2008

alterada. Efetivamente, isso possibilita adicionar ou remover perguntas em um questionrio 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 so a coluna de labels. A primeira linha uma coluna cabealho que detalha o nome da pergunta/resposta. A segunda linha o nome da coluna interna do PHP para aquela resposta. No 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, possvel importar os dados de volta para um questionrio LimeSurvey ativo. Caso o questionrio tenha sido desativado, ser preciso ativ-lo antes. A, ento, a partir da tela de visualizao das respostas, clique no cone "Importar um arquivo de questionrio". Na tela "Importar um arquivo de questionrio VV" preciso escolher o arquivo "VVexport". Se for selecionado "Excluir os nmeros de identificao dos registros" os registros sero importados e novos nmeros de identificao sero gerados para eles. Se essa opo for desmarcada, a identificao original ser importada. H diversas opes para escolher sobre como o LimeSurvey deve responder a entradas duplicadas ou mltiplas: Informe o erro (e passe ao novo registro). Renumere o novo registro Ignore o novo registro Substitua o registro existente

24. Gerenciamento de usurios

Ao clicar no cone (Criar/Editar Usurios) voc chega ao Gerenciamento de Usurios. Aqui possvel criar, editar ou apagar usurios existentes, alm de atribuir-lhes direitos ou permisses de acesso Administrao de Pesquisa. Esses direitos determinam se um usurio pode: Criar pesquisas Configurar pesquisas Criar usurios Mover usurios Apagar usurios Gerenciar modelos Gerenciar legendas

25. Gerenciamento de grupo de usurios

39 Data Verso: 06/10/2008

Ao clicar no cone (Criar/Editar grupos) voc chega ao Gerenciamento de Grupos de Usurios. Grupos podem ser uma unidade organizacional num determinado momento. No h direitos associados ao grupo, porm ao colocar usurios num grupo, o Administrador do Questionrio pode dar acesso de administrao ao questionrio usando grupos, bem como enviar e-mail a todos os usurios daquele grupo com um s clique. Assim, a utilizao de Grupos pode ser particularmente til para dar ou manter acesso a questionrios especficos. Em outras palavras, voc pode incluir usurios ou grupos especficos em pesquisas especficas, limitando dessa forma o acesso quele questionrio. Como fazer: Entre no sistema como Administrador com plenos direitos Selecione o questionrio qual sero atribudos os direitos Clique no boto Opes de Segurana do Questionrio. Isso lhe levar a uma tela onde possvel associar qual usurio ou grupo ter direitos de acesso quele questionrio.

26. Opes de segurana do questionrio

Boto disponvel na barra de menu do questionrio, ao lado do boto de Ativao. A partir dele, possvel adicionar outros usurios/grupos que podero ter acesso parte de administrao pesquisa. Depois de adicionar o usurio/grupo, possvel atribuir os seguintes direitos: Editar Propriedades do Questionrio o Editar pesquisa em andamento o Configurar regras de avaliao o Inicializar e gerenciar cdigos de acesso Definir Perguntas o Adicionar/Editar/Apagar Grupos o Adicionar/Editar/Apagar Perguntas o Adicionar/Editar/Apagar Respostas o Adicionar/Apagar Condies o Copiar pergunta o Visualizar pergunta Pesquisar Respostas o Pesquisar Respostas / Gerenciamento de Respostas (sem apagar) o Visualizar respostas salvas, mas no enviadas o Visualizar cdigos de acesso Exportar o Exportar pesquisas o Exportar grupos o Exportar perguntas o Exportar cdigos de acesso o Exportar resultado de pesquisa Apagar Pesquisa o Apagar pesquisa o Apagar respostas Ativar Pesquisa o Ativar pesquisa o Inicializar e gerenciar cdigos de acesso

40 Data Verso: 06/10/2008

27. Avaliao
O LimeSurvey tem a possibilidade de criar "Avaliaes" no questionrio. Avaliaes so regras que avaliam as respostas logo depois de terem sido enviadas e, baseando-se nisso, apresentam uma mensagem. Considere o seguinte exemplo: Num questionrio com 2 questes, a primeira pergunta se o participante fuma - fumante?, tem 3 respostas possveis: "Sim, fumo mais de 10 cigarros por dia", onde deve-se colocar 10 para o cdigo da resposta; "Sim, fumo menos de 10 cigarros por dia", onde deve-se colocar "5" para o cdigo da resposta; "No", onde deve-se colocar "1" para o cdigo da resposta.

A segunda questo Pratica exerccio?" tem tambm 3 respostas possveis: "Sim, pelo menos 3 vezes na semana, durante meia-hora" onde deve-se colocar "1" para o cdigo da resposta; "Sim, de vez em quando", onde deve-se colocar "5" para o cdigo da resposta; "No, nunca fao exerccio", onde deve-se colocar 10 para o cdigo da resposta.

Ao contabilizar o total obtido com a soma dos valores de cada resposta dada, obtm-se ao final, uma indicao em termos gerais da sade daquele participante. Algum que fume e no pratique exerccios fsicos ter marcado 10 pontos em cada resposta, dando uma soma de 20; algum que no fume e faa exerccios regularmente ter marcado 1, com total igual a 2. No so permitidos cdigos de resposta com valor igual a zero (0). A ferramenta de avaliao permite definir regras baseadas na soma de valores de cada pergunta no questionrio, seja nela como um todo, seja dentro de cada grupo de perguntas. Essa ferramenta est disponvel na barra de botes do Questionrio Definir regras de avaliao. A partir dela, possvel criar avaliaes, visualizar, editar ou apagar outras existentes. Esto disponveis as seguintes opes: Escopo: Indica a abrangncia da avaliao. "Total" vai criar uma avaliao baseada na soma de todas as respostas do questionrio. "Grupo de Perguntas" cria avaliao baseada na soma das respostas de um determinado grupo (a ser escolhido na linha seguinte). Grupo: Se o escopo for "Grupo de Perguntas", aqui onde ser selecionado o grupo para avaliar. Mnimo: A menor soma de respostas qual a avaliao se aplica. Mximo: A maior soma de respostas para a avaliao. Cabealho: O cabealho da avaliao que vai aparecer se a avaliao for apresentada. Mensagem: Mensagem para a avaliao (pode incluir cdigo HTML). URL: Link URL que vai apresentar a avaliao.

possvel criar qualquer nmero de avaliaes, e pode haver mais de uma para mostrar para um dado escore.
41 Data Verso: 06/10/2008

 importante observar que para usar avaliaes, a opo de Carregar automaticamente a URL ao final do questionrio (durante a configurao dos parmetros inicial) no deve ser escolhida, pois elas s vo aparecer na pgina final Completa, que aparece aps o envio.

28. Modelos/Editor de modelos

Muitos elementos em comum do LimeSurvey podem ser ajustados atravs de uma srie de modelos pr-definidos. Essa seo faz uma breve explicao desses modelos. Para ver informaes mais detalhadas especialmente sobre a criao/edio dos modelos, consulte http://docs.limesurvey.org/tiki-index.php?page=Templates+%2B+Styles. O editor de modelos do LimeSurvey O Editor de Modelos do LimeSurvey permite editar o contedo dos modelos on-line. Pode ser iniciado, clicando-se no cone Editor de Modelos da barra de Administrao do LimeSurvey. A tela principal parecida tela de configurao de pesquisas do LimeSurvey e permite selecionar o modelo para editar/visualizar. Uma vez selecionado, possvel escolher uma dentre as vrias pginas do questionrio. A partir da, apresentada uma lista com os arquivos de modelos que compem aquela pgina. O menu do modelo Semforo: O cone semforo indica se o modelo pode ou no ser modificado. A luz vermelha indica que o modelo de leitura apenas (read-only); verde indica que alteraes podem ser feitas. Para passar o semforo de vermelho para verde, preciso, antes, mudar as permisses em alguns arquivos do modelo. Renomear o modelo: Pemite mudar o nome do modelo. Exportar modelo: Permite exportar o modelo para um arquivo .zip. Copiar modelo: Permite fazer um novo modelo, copiando o atual.

A tela listada direita permite escolher a pgina do questionrio que ser visualizada. A seo de controle de arquivo Na janela "Controle de Arquivo", esquerda, possvel selecionar um dos arquivos de modelo que usado para compilar a pgina. O cdigo HTML para aquele arquivo aparecer no centro da janela "Agora, editando". Se o modelo puder ser modificado (o que determinado pelas permisses de diretrio), pode-se proceder s modificaes desejadas e salv-las. A janela Outros Arquivos" mostra uma lista de todos os outros arquivos no diretrio do modelo. Pode-se usar esse lado para carregar arquivos de imagens (fotos, logomarcas...) ou outros necessrios para criar o modelo. Observao: Ao invs de linkar diretamente cada figura no modelo, pode-se usar {TEMPLATEURL}.Ao invs de: "<imgsrc='/limesurvey/templates/yourtemplate/mypicture.jpg'>", voc pode usar: "<img src=';{TEMPLATEURL}:mypicture.jpg'>". Uma amostra da pgina do modelo que est sendo editado pode ser vista na parte inferior da tela. No possvel apagar um modelo do editor de modelos. Isso deve ser feito usando ftp, apagando-se o diretrio.
42 Data Verso: 06/10/2008

O modelo "default" no pode ser editado usando o editor de modelos, embora seja possvel fazer isso manualmente. Substituies / Variveis dos campos As seguintes variveis sero, automaticamente, substitudas pelo LimeSurvey ao executar o arquivo do modelo e apresentadas aos usurios do questionrio. Aparecem em quase todos os modelos, exceto no Pgina Completa. CAMPO {SURVEYNAME} {SURVEYDESCRIPTION} {WELCOME} {PERCENTCOMPLETE} SUBSTITUDO POR Nome do questionrio Descrio do questionrio Mensagem de boas vindas do questionrio Um grfico (barra de progresso) mostrando o percentual j completo do questionrio. {GROUPNAME} Nome do grupo de perguntas {GROUPDESCRIPTION} Descrio do grupo de perguntas {QUESTION} A pergunta (texto) {QUESTION_CODE} O cdigo da pergunta (cdigo) {ANSWER} As respostas pergunta atual {THEREAREXQUESTIONS} Substitudo pela declarao "H X perguntas nesse questionrio" - onde X o nmero total de perguntas do questionrio. {NUMBEROFQUESTIONS} O nmero total de perguntas do questionrio {TOKEN} ID do cdigo de acesso atual {SID} ID do questionrio atual {QUESTIONHELP} O texto de ajuda para a pergunta atual, em uma janela pop-up em javascript {QUESTIONHELPPLAINTEXT} O texto de ajuda para a pergunta atual {NAVIGATOR} Os botes "Prximo >>" e "<< Anterior" {SUBMITBUTTON} O boto "Enviar" {COMPLETED} "Pesquisa completa e salva" do arquivo de idioma {URL} O ttulo URL para esse questionrio {PRIVACY} Inclui o contedo do modelo privacy.pstpl {PRIVACYMESSAGE} Mensagem de privacidade do arquivo de idioma {CLEARALL} A URL para "Sair e limpar respostas" {TEMPLATEURL} A URL para o local do modelo atual (til para referenciar arquivos de imagem para o modelo) {SUBMITCOMPLETE} A declarao (dos arquivos de idiomas) que informa aos usurios que o questionrio foi finalizada e devem clicar no boto Enviar {SUBMITREVIEW} A declarao (dos arquivos de idiomas) que informa aos usurios que possvel rever/alterar as respostas dadas, clicando em "<< Anterior" {TOKEN:FIRSTNAME} Para o caso de respostas NO ANNIMAS: a varivel substituda pelo primeiro nome (informao presente na tabela de cdigos de acesso) de cada usurio. {TOKEN:LASTNAME} Para o caso de respostas NO ANNIMAS: a varivel
43 Data Verso: 06/10/2008

{TOKEN:EMAIL}

{TOKEN:ATTRIBUTE_1}

{TOKEN:ATTRIBUTE_2}

{ANSWERSCLEARED} {RESTART} {CLOSEWINDOW} {REGISTERERROR} {REGISTERMESSAGE1} {REGISTERMESSAGE2} {REGISTERFORM} {CHECKJAVASCRIPT}

substituda pelo ltimo nome (informao presente na tabela de cdigos de acesso) de cada usurio. Para o caso de respostas NO ANNIMAS: a varivel substituda pelo e-mail (informao presente na tabela de cdigos de acesso) de cada usurio. Para o caso de respostas NO ANNIMAS: a varivel substituda pelo atributo_1 (informao presente na tabela de cdigos de acesso) de cada usurio. Para o caso de respostas NO ANNIMAS: a varivel substituda pelo atributo_2 (informao presente na tabela de cdigos de acesso) de cada usurio. A declarao "Respostas apagadas "dos arquivos de idioma URL para reiniciar o questionrio URL para fechar o questionrio em andamento Mostra qualquer mensagem de erro na pgina de inscrio (Por exemplo: "Voc deve preencher o campo de e-mail") A declarao "Voc deve estar inscrito para completar esse questionrio" dos arquivos de idioma Detalhes sobre inscrio dos arquivos de idioma O formulrio de inscrio ser alterado a depender de como os campos atributo_1 e atributo_2 forem definidos. Uma mensagem de advertncia para usurios finais com javascript desabilitado em seu browser. O estilo usado para esse campo controlado pelas diretrizes CSS definidas no arquivo startpage.pstl para a classe ".warnings".

29. Definio de legendas

O boto Editar/Adicionar conjuntos de legendas , presente no menu de Administrao, usado para editar, criar, apagar, importar ou exportar grupos de legendas usados nas perguntas. Adicionar novo Grupo de Legenda: Nome do grupo: cada um deve receber um nome. Idiomas: Cada grupo de legendas deve ser especificado para o idioma em que v ser usado. possvel escolher qualquer nmero de idiomas.

Importar Definio de Legendas: Selecione um grupo de legendas exportado anteriormente, em formato CSV e clique no boto "Importar Legenda". Ao importar um questionrio inteiro, as Legendas j so importadas com as perguntas.

Editar, Apagar, Exportar Definio de Legendas: Selecione uma legenda j existente que aparece na caixa dropdown, na barra de administrao de Legendas para editar, apagar ou exportar.
44 Data Verso: 06/10/2008

Editar Legenda: possvel renomear a legenda e adicionar/remover idiomas para ela. Apagar Legenda: Aps uma mensagem de aviso, possvel apagar a legenda escolhida. Exportar Legenda: Exportar o grupo de legendas selecionado para um arquivo .csv. Barra de Legendas: o Para adicionar uma nova legenda, preciso preencher o cdigo e o texto para ela e clicar no boto "Adicionar nova legenda". Depois disso, a legenda aparecer na lista acima. o possvel usar um grfico em substituio ou adio ao texto da legenda. Para o grfico, use cdigo HTML, como por exemplo: <img border="0" src="http://www.yourdomain.at/pics/pic.gif"> Um exemplo com 3 tipos de sorriso mostrado abaixo. o o Se o grupo de legendas tiver mais de um idioma, pode-se usar aquele que se deseja editar. Toda legenda precisa de um cdigo e de um ttulo. O cdigo s pode ser alterado no idioma base do conjunto de legendas. O ttulo o texto que exibido na pergunta. possvel apagar legendas com o boto "Apagar". possvel mudar a ordem das legendas, usando os botes "Para cima" e "Para baixo". Legendas que esto sendo usadas possuem um hyperlink para a pergunta em questo. Fix Sort: Verificar a integridade e ordenar as legendas clicando no boto "Fix Sort".

o o o o

Exemplo: Grfico (3 tipos diferentes de sorriso) em substituio a uma legenda em texto:

30. Trabalhando com backups

Se o questionrio foi fechado acidentalmente Se, por alguma razo, for necessrio reaver os dados depois de encerrar um questionrio, s ser possvel se tiver sido feito um backup do questionrio anteriormente. Relembrando: a instalao padro do LimeSurvey incorpora o MySQL como o banco de dados para a aplicao, que onde os dados do questionrio so armazenados e onde a informao desejada deve ser procurada. Para isso, preciso conhecer o front-end administrativo da aplicao para o MySQL. H referncia de boas experincias com o phpMyAdmin, disponvel na Internet.
45 Data Verso: 06/10/2008

Antes de iniciar seu trabalho com o MySQL, FAA SEMPRE BACKUP DOS DADOS. Verifique com seu administrador e esteja certo que o backup dos dados e aplicao seja o mais recente possvel, pelo menos feito nas ltimas 24 horas. Quanto mais recente, melhor. S ento, faa seu prprio backup dos dados antes de comear seu trabalho. Uma vez conhecendo o phpMyAdmin, abra-o e use-o para abrir o banco de dados contendo os dados do LimeSurvey. Primeiro, faa uma CPIA da base de dados para sua instalao do LimeSurvey, criando uma nova rea de trabalho com essas tabelas. Voc NO dever trabalhar com seus dados originais primrios. Isso seria pssima prtica! Em segundo lugar, comece a trabalhar com a cpia. Voc encontrar tabelas com nomes bem estranhos, como sidXgidXqid e outras derivaes desse formato. Nesses nomes, h seqncias de letras que equivalem aos nmeros da pergunta ou identificadores que voc criou para cada pergunta no questionrio. Antes de qualquer coisa, deve ficar claro que tabelas tm nomes que se relacionam com as vrias formas de perguntas usadas. Perguntas com opes de respostas A, B, C e assim por diante, tero tabelas para cada opo. Se houver uma opo como Outros para uma pergunta, haver uma tabela com a seqncia 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 explicao sobre ele. O primeiro cone permite pesquisar os dados da tabela. Como o phpMyAdmin define, isso significa fornecer uma viso limitada dos registros daquela tabela. O segundo cone mais direita mostra uma verso completa do contedo da tabela. Para ver a tabela completa, melhor usar o cone Browser (ao invs do cone TEXTO COMPLETO). Quando a janela Browser estiver aberta, haver um link para Imprimir e um outro para Imprimir Texto Completo. Usando a opo Imprimir Texto Completo, chegamos a uma nova tela com a informao procurada e pode-se imprimir. Depois de ter encontrado o que procurava, faa o que tem que fazer. Lembre-se, porm, de que est trabalhando com uma cpia. Qualquer mudana feita, voc poder copiar, importar ou manipular para que elas terminem na sua base de dados ativa realmente. Eis uma explicao dos nomes das tabelas mencionadas acima: sidXgidXqid sid = ID do questionrio gid = ID do Grupo de Perguntas qid = ID da Pergunta X = ID-Value Observao: Apesar de o arquivo exportado criar um arquivo SQL padro, no recomendado execut-lo diretamente num banco de dados LimeSurvey j existente, isto , usando o phpMyAdmin, pois vrios ponteiros internos no questionrio precisam ser reinicializados.

31. Glossrio
46 Data Verso: 06/10/2008

COOKIES: Cookies so pequenos arquivos de dados transferidos de um site da web para o disco do seu computador. uma informao que um servidor web pode armazenar temporariamente junto a um browser. Uma aplicao prtica disto no comrcio via Internet. Suponhamos que algum entre em uma loja virtual, faa vrias selees para compra e v navegar em outros sites. Ao voltar ao site de venda, todas as suas selees tero sido mantidas e ele poder ento fechar o seu negcio ou fazer mais aquisies. As informaes so guardadas pelo browser e no pelo servidor web. Ficaria muito mais difcil para um servidor se lembrar dos milhares de browsers que o acessaram recentemente e exatamente o que cada um deles fez ou selecionou. Os cookies so enviados para o seu browser e mantidos na memria. Ao encerrar a sua sesso com seu browser, todos os cookies que ainda no expiraram so gravados em um arquivo (cookie file). Muitas pessoas julgam que os cookies possam ser usados pelo servidor para obter informaes a seu respeito ou invadir o seu disco rgido e obter dados a partir de l, o que no verdade. Todas as informaes gravadas em um cookie so informaes que voc forneceu voluntariamente ao servidor, de uma forma ou de outra. No caso do LimeSurvey, o cookie serve para evitar que um questionrio seja respondido repetidas vezes por um mesmo computador. ENDEREO IP: Sigla para Internet Protocol, que o protocolo utilizado pela rede Internet para enviar e receber pacotes de informaes. como um nmero de identidade que cada computador recebe toda vez que se conecta internet. Este nmero, em conjunto com data e hora, pode ser utilizado para detectar de onde o internauta se conectou. Um exemplo de endereo IP 206.98.23.16. Cada um dos 4 nmeros dentro do endereo IP assume valores entre 1 e 255. Como so difceis de lembrar, muitos tambm tm equivalentes em texto, como por exemplo: www.brasil.gov.br ou www.blackbox.com.br. EXPRESSES REGULARES: Uma expresso regular, em Informtica, define um padro a ser usado na formao de grupos de palavras. um meio preciso de se fazer buscas de determinadas pores de texto, por exemplo. Uma expresso regular uma combinao de letras e/ou dgitos e/ou smbolos que juntos do origem a uma informao um nome, um email, telefone, cdigo de endereamento postal (CEP), CPF, CNPJ etc. Expresses regulares devem comear com "/". Pode-se encontrar uma boa biblioteca de expresses regulares no site http://www.regxlib.net/. Esses padres sempre iro funcionar se envolvidos pela barra /. Exemplos: Validao de e-mail: /(\w[-._\w]*\w@\w[-._\w]*\w\.\w{2,3})/ Hora vlida: /^([01][0-9]|2[0-3]|24)(?(?<=24):00|:[0-5][0-9])$/ /^[0-9]{4}/

HTML: A sigla HTML deriva da expresso inglesa HyperText Markup Language - Linguagem de Formatao de Hipertexto. Trata-se de uma linguagem de marcao utilizada para produzir

47 Data Verso: 06/10/2008

pginas na Internet. De modo geral so documentos de texto escritos em cdigos que podem ser interpretados pelos browsers (navegadores) para exibir as pginas da World Wide Web. SPSS: um software aplicativo (programa de computador) do tipo cientfico, acrnimo de Statistical Package for the Social Sciences - pacote estatstico para as cincias sociais, de apoio a tomada de deciso que inclui: aplicao analtica, Data Mining, Text Mining e estatstica, que transformam os dados em informaes importantes proporcionando reduo de custos e aumento da lucratividade. O SPSS Data Editor til para fazer testes estatsticos, tais como os testes da correlao, multicolinearidade, e de hipteses; pode tambm providenciar ao pesquisador contagens de freqncia, ordenar dados, reorganizar a informao, alm de servir como um mecanismo de entrada dos dados, com rtulos para pequenas entradas. URL: A URL, ou Uniform Resource Locator (localizador de recursos uniforme), uma indicao do protocolo e do endereo para acessar informaes na Internet. Em outras palavras, um nome que identifica documentos e servios na Internet. Ela mostra a localizao de um arquivo em determinado computador, bem como a forma de atingi-lo. Por exemplo: digamos que voc estivesse visitando o seguinte endereo: http://www.editoraatlas.com.br/FAQs. Esta a URL da pgina.

48 Data Verso: 06/10/2008