LimeSurvey - Tutoriais
Está é uma seção de tutoriais, caso tenha alguma dúvida entre em contato conosco através do e-mail: sesol@cgu.gov.br.
Tutoriais
Como configurar um formulário para receber notificações administrativas em e-mails diferentes dependendo da resposta do usuário?
Suponha que o formulário possuia uma questão do tipo Opção, e dependendo da escolha do usuário, o formulário deve enviar o e-mail de notificação administrativa para determinado endereço de e-mail
Nesse caso, se o usuário escolher a opção "Setor A", o formulário deve enviar o e-mail de notificações administrativas para o endereço setorA@email.setor e caso o usuário selecione a opção "Setor B", o formulário deve enviar o e-mail de notificações administrativas para o endereço setorB@email.setor.
Para fazer essa configuração, acesse a aba "Notificações e Dados", e nos campos "Enviar e-mail de notificação básica para:" e/ou "Enviar e-mail de notificação detalhada para:" preencher o seguinte código:
{if(G01Q01=="A1", "setorA@email.setor","setorB@email.setor")}
Lembre-se de alterar o código da pergunta ( Onde está "G01Q01", inserir o código da pergunta) e os endereços de e-mail correspondentes.
Como configurar um formulário para receber no Assunto do e-mail de notificações administrativas a data e o horário em que foi preenchida a resposta?
Primeiro, é preciso criar uma pergunta do tipo "Formula", e inserir o seguinte código no campo de fórmula:
{date('Y-m-d H:i:s')}
Na aba "Mostrar, selecione a opção "Desligado" para pergunta não ser mostrada para os participantes.
No painel de edição do questionário, na aba "Modelos de Email", insira nos campos "Enviar e-mail de notificação básica para:" e/ou "Enviar e-mail de notificação detalhada para:" o seguinte código:
Pronto, agora os e-mails de notificação enviados após o preenchimento de cada questionário vão ser enviados com a data e o horário de preenchimento, da seguinte forma:
Como configurar um formulário para receber no corpo do e-mail de notificações administrativas um link para fazer o download de um arquivo enviado por um participante?
Primeiro, é preciso criar uma pergunta do tipo "Formula", e inserir o seguinte código no campo de fórmula:
{SAVEDID}
Na aba "Mostrar, selecione a opção "Desligado" para pergunta não ser mostrada para os participantes.
No painel de edição do questionário, na aba "Modelos de Email", insira nos campos "Enviar e-mail de notificação básica para:" e/ou "Enviar e-mail de notificação detalhada para:" o seguinte código:
Antes de salvar, altere os seguintes campos do link:
NUMERO_DO_FORMULARIO é o código do formulário. Se encontra na página principal do formulário e também no link de publicação.
CODIGO_QUESTAO_SAVEDID é o código da pergunta que foi criada para armazenar o ID da resposta. Esse código deve ser envolvido em chaves {} no link.
CODIGO_QUESTAO_COM_ANEXO é o código da pergunta que contém a opção de inserir um anexo.
Pronto, agora os e-mails de notificação enviados após o preenchimento de cada questionário vão ser enviados um link para download do arquivo enviado pelo participante.
Como configurar URLs amigaveis?
Documentação base: https://manual.limesurvey.org/Text_elements#Survey_Alias_.28New_in_5.5_.29 , https://manual.limesurvey.org/URL_fields#End_URL_field
Introdução
Os parâmetros dos campos de URL podem ser usados em:
Campo de URL final da pesquisa (consulte os elementos de texto da pesquisa) Campo de URL da regra de cota (leia mais sobre cotas de pesquisa aqui) Campo URL inicial da pesquisa (consulte os elementos de texto da pesquisa).
Campo de URL final Ao final de uma pesquisa ou quando uma cota causa o encerramento de uma pesquisa, existe a opção de definir um URL final. Essa URL é apresentada ao participante que concluiu a pesquisa na página final ou, opcionalmente, você pode configurar o participante para ser redirecionado automaticamente para a respectiva URL. Isso pode ser feito preenchendo a opção URL final no painel Elementos de texto da pesquisa e habilitando o carregamento automático da URL final no painel Apresentação após a conclusão da pesquisa.
Mas o LimeSurvey oferece a possibilidade de usar os campos de URL de muitas outras maneiras, o que, por sua vez, permite que você aprimore a funcionalidade de sua pesquisa.
Campos básicos
Você pode usar {SAVEDID}, {TOKEN}, {SID} e {LANG} no URL final:
SAVEDID é o id atribuído a este envio específico; TOKEN é o token utilizado para participar da pesquisa; SID é o ID da pesquisa; LANG é o código do idioma. Por exemplo:
https://www.limesurvey.org/test.php?var1={SAVEDID}&var2={TOKEN}&var3={SID}&lang={LANG}
Campos de resposta
Você também pode usar variáveis {INSERTANS:SGQA} ou ExpressionScript. Esse campo de URL permite que você adicione a resposta a uma pergunta específica da pesquisa na URL final. Isso pode ser útil para enviar uma resposta a um script externo (ou seja, um endereço de e-mail coletado durante a pesquisa).
Por exemplo:
https://www.limesurvey.org/test.php?email={EMAILADDRESS}
É importante adicionar "newtest/y" ao URL para forçar uma nova sessão sempre que os participantes da pesquisa quiserem preencher sua pesquisa.
No cenário acima, a URL pertence a uma pesquisa com ID = 48315, grupo =2, pergunta=22 e códigos de resposta = 2007 e 2008.
Help.png Para mais detalhes sobre a necessidade de "newtest/y", verifique o seguinte tópico do fórum. Expressões Você também pode usar qualquer expressão aqui.
Por exemplo:
http://www.limesurvey.org/test.php?gender={if(sex=='Masculino','M','F')}&name;={nome}
Campos de passagem
Para usar campos de passagem, você deve definir os nomes das variáveis por meio da integração do painel. Se você não atribuir uma pergunta-alvo, as variáveis não serão salvas nas respostas (leia mais sobre o recurso de integração do painel LimeSurvey). Para usar tal parâmetro na URL final, basta inserir a tag {PASSTHRU:<paramname>} onde <paramname> é o nome do seu parâmetro de entrada.
Vamos supor que você tenha definido um parâmetro chamado "foobar". A pesquisa é iniciada com um link como este:
https://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123
O XYZ123 é o valor que você quer "passar".
A URL final de uma pesquisa com a seguinte URL https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar} seria então convertida para https://www.limesurvey.org/test.php? foobarout=XYZ123
URL inicial Pré-preenchimento de uma pesquisa usando parâmetros GET Você pode preencher todas as respostas, exceto o tipo de pergunta de upload e equação. Você pode usar a nomenclatura qcode para parâmetros e definir o valor para tipos de perguntas individuais ou usar o identificador SGQA.
Em seguida, as respostas são definidas com o valor pré-preenchido. Para a opção de escolha única, você deve usar o código da resposta, para a pergunta de múltipla escolha, você deve usar S se quiser preencher a resposta.
Aqui estão alguns exemplos de URL inicial:
http://ls.example.org/1234?QTEXT=prefilled : Preencha a pergunta com o código QTEXT com 'pré-preenchido' https://ls.example.org/1234?MULTI_SQ001=pré-preenchido (Novo em 3.14.1 ): Preencha a subquestão SQ001 da pergunta com o título MULTI com 'pré-preenchido' (para uma pergunta de texto múltiplo, por exemplo). https://ls.example.org/1234?single=-oth-&single_other=Other%20text (Novo em 3.14.1): Selecione a opção de resposta "outro" de uma pergunta de escolha única e preencha o outro valor com o texto "Outro texto". https://ls.example.org/1234?1234X1X1SQ001=pré-preenchido : Preencha a subquestão SQ001 da pergunta com ID: 1 do grupo com ID: 1 com 'pré-preenchido' https://ls.example.org/1234?1234X1X1SQ001=A1 : Pré-selecione a opção de resposta 'A1' da subquestão SQ001 da pergunta com ID: 1 do grupo que possui ID: 1. https://ls.example.org/1234?1234X1X1SQ001=Y : Pré-selecione a subquestão SQ001 da questão que tem o ID 1, do grupo que tem o ID: 1.