Campos de URL

Introdução

Os parâmetros dos campos de URL podem ser usados no:

• campo URL final do inquérito (veja Elementos textuais do questionário)
• campo de URL da regra de quota (saiba mais sobre as quotas de questionário aqui)
• campo URL inicial do inquérito (veja Elementos textuais do questionário).

Campo URL final

No final de um inquérito ou quando uma quota faz com que o inquérito seja encerrado, existe a opção de definir uma URL final. Essa URL é apresentada ao participante que concluiu o inquérito na página final, ou você pode, opcionalmente, definir que o participante seja redirecionado automaticamente para essa URL. Isso pode ser feito preenchendo a opção URL final no painel Elementos de texto e ativando o carregamento automático da URL final no painel Apresentação quando um inquérito for concluído.

No entanto, o LimeSurvey oferece a possibilidade de usar campos de URL de muitas outras maneiras, o que, por sua vez, permite ampliar a funcionalidade do seu inquérito.

Se você acessar “Participantes do questionário” no menu lateral do inquérito e alterar o inquérito para o “modo de acesso fechado”, depois de adicionar previamente participantes, cada um com um código, o parâmetro de código será adicionado à URL final.

Campos básicos

Você pode usar {SAVEDID}, {TOKEN}, {SID} e {LANG} na URL final:

• SAVEDID é o ID atribuído a esta submissão específica;
• TOKEN é o código usado para participar do inquérito;
• SID é o ID do questionário;
• LANG é o código de língua.

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 do ExpressionScript. Este campo de URL permite adicionar à URL final a resposta a uma pergunta específica do inquérito. Isso pode ser útil para enviar uma resposta a um script externo (por exemplo, um e-mail coletado durante o inquérito).

Por exemplo:

https://www.limesurvey.org/test.php?email={EMAILADDRESS}

É importante adicionar "newtest/y" à URL para forçar uma nova sessão sempre que os participantes do seu inquérito quiserem respondê-lo.

https://exampletest.limequery.com/index.php/survey/index/sid/48315/newtest/Y?48315X2X222007=Y&48315X2X222008=Y

No cenário acima, a URL refere-se a um inquérito com ID = 48315, grupo = 2, pergunta = 22 e códigos de resposta = 2007 e 2008.

Para mais detalhes sobre a necessidade de "newtest/y", consulte 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=='Male','M','F')}&name;={name}

Campos de passagem direta (passthrough)

Para usar campos de passagem direta, você deve definir os nomes das variáveis por meio do Painel de integração. Se você não atribuir uma questão alvo, as variáveis não serão salvas nas respostas (saiba mais sobre o recurso Painel de integração do LimeSurvey). Para usar esse parâmetro na URL final, basta inserir a tag {PASSTHRU:<paramname>}, onde <paramname> é o nome do seu parâmetro de entrada.

Suponha que você definiu um parâmetro chamado "foobar". O inquérito é iniciado com uma hiperligação como esta:

https://example.org/limesurvey/index.php/survey/index/sid/12345/lang/eb?foobar=XYZ123

XYZ123 é o valor que você deseja "passar".

A URL final de um inquérito com a seguinte URL https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar} seria então convertida em https://www.limesurvey.org/test.php?foobarout=XYZ123

URL inicial

Pré-preenchendo um inquérito usando parâmetros GET

Você pode pré-preencher todas as respostas, exceto as dos tipos de pergunta carregamento de arquivos e equação. Você pode usar a nomenclatura de código da pergunta (qcode) nos parâmetros e definir o valor para tipos de pergunta simples, ou usar o identificador SGQA.

Assim, as respostas são definidas com o valor pré-preenchido. Para perguntas de escolha única, você deve usar o código da resposta; para perguntas de múltipla escolha, você deve usar Y se quiser pré-preencher a resposta.

Aqui estão alguns exemplos de URL inicial:

• http://ls.example.org/1234?QTEXT=prefilled : Preenche a pergunta com o código QTEXT com 'prefilled'
• https://ls.example.org/1234?MULTI_SQ001=prefilled ^{(New in 3.14.1 )} : Preenche a pergunta secundária SQ001 da pergunta com o título MULTI com 'prefilled' (por exemplo, em uma pergunta de texto múltiplo).
• https://ls.example.org/1234?single=-oth-&single_other=Other%20text ^{(New in 3.14.1 )} : Seleciona a opção de resposta "Outros" de uma pergunta de escolha única e preenche o valor de "Outros" com o texto "Other text".
• https://ls.example.org/1234?1234X1X1SQ001=prefilled : Preenche a pergunta secundária SQ001 da pergunta com ID: 1 do grupo com ID: 1 com 'prefilled'
• https://ls.example.org/1234?1234X1X1SQ001=A1 : Pré-seleciona a opção de resposta 'A1' da pergunta secundária SQ001 da pergunta com ID: 1 do grupo com ID: 1.
• https://ls.example.org/1234?1234X1X1SQ001=Y : Pré-seleciona a pergunta secundária SQ001 da pergunta com ID 1, do grupo com ID: 1.

 Hint: Os parâmetros GET usam "?" para o primeiro parâmetro e "&" para os seguintes. Se a sua URL já contiver "?", você deve usar "&" para adicionar mais parâmetros GET.

 Hint: Os parâmetros GET adicionais só são preenchidos quando o inquérito é iniciado novamente. Portanto, para testes, sempre adicione newtest=Y para iniciar um inquérito novo. Por exemplo: http://ls.example.org/1234?QTEXT=prefilled&newtest=Y

Pré-preenchendo um inquérito usando parâmetros GET por meio da aba de parâmetros de URL

Você pode pré-preencher respostas (às vezes de forma mais fácil) usando parâmetros de URL, que podem ser configurados no Painel de integração.

Pré-preenchendo e ocultando a resposta

Você pode usar o atributo de ocultação de uma pergunta para ocultá-la dos seus respondentes. Nesse caso, a pergunta continua pré-preenchida.