Campos de URL

Introdução

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

• campo URL de saída do inquérito (consulte os elementos de texto do inquérito)
• campo de URL da regra de quota (saiba mais sobre as quotas do inquérito aqui)
• campo URL de entrada do inquérito (consulte os elementos de texto do inquérito).

Campo URL de saída

No final de um inquérito ou quando uma quota faz com que um inquérito termine, existe a opção de definir um URL de saída. Este URL é apresentado ao participante que terminou o inquérito na página final, ou pode, opcionalmente, definir que o participante seja redirecionado automaticamente para esse URL. Pode fazê-lo preenchendo a opção URL de saída no painel Elementos de texto do inquérito e ativando o carregamento automático do URL de saída no painel Apresentação quando um inquérito é concluído.

No entanto, o LimeSurvey permite utilizar os campos de URL de muitas outras formas, o que, por sua vez, lhe permite melhorar a funcionalidade do seu inquérito.

Se aceder a “Participantes no inquérito” no menu lateral do inquérito e alterar o inquérito para “modo de acesso fechado”, depois de adicionar previamente os participantes, cada um com um código, o parâmetro do código será adicionado ao URL de saída.

Campos básicos

Pode utilizar {SAVEDID}, {TOKEN}, {SID} e {LANG} no URL de saída:

• SAVEDID é o id atribuído a esta submissão em particular;
• TOKEN é o código utilizado para participar no inquérito;
• SID é o ID do inquérito;
• 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

Também pode utilizar variáveis do ExpressionScript. Este campo de URL permite-lhe adicionar ao URL de saída a resposta a uma pergunta específica do inquérito. Isto pode ser útil para enviar uma resposta a um script externo (por exemplo, um endereço de email recolhido durante o inquérito).

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 do seu inquérito queiram preencher o inquérito.

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

No cenário acima, o 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

Também pode utilizar aqui qualquer expressão.

Por exemplo:

http://www.limesurvey.org/test.php?gender={if(sex=='Male','M','F')}&name;={name}

Campos de passagem direta (passthrough)

Para utilizar campos de passagem direta, tem de definir os nomes das variáveis através da integração do painel. Se não atribuir uma pergunta alvo, as variáveis não serão guardadas nas respostas (saiba mais sobre a funcionalidade de integração do painel do LimeSurvey). Para utilizar um parâmetro deste tipo no URL de saída, basta inserir a tag {PASSTHRU:<paramname>}, em que <paramname> é o nome do seu parâmetro de entrada.

Vamos supor que definiu um parâmetro com o nome "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 pretende "passar".

O URL de saída de um inquérito com o seguinte URL https://www.limesurvey.org/test.php?foobarout={PASSTHRU:foobar} seria então convertido em https://www.limesurvey.org/test.php?foobarout=XYZ123

URL inicial

Pré-preencher um inquérito com parâmetros GET

Pode pré-preencher todas as respostas, exceto as dos tipos de pergunta de carregamento de ficheiros e de equação. Pode utilizar a nomenclatura de códigos de pergunta para os parâmetros e definir o valor para tipos de pergunta simples, ou utilizar o identificador SGQA.

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

Seguem-se 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, numa 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 "Outro" de uma pergunta de escolha única e preenche o valor de "Outro" 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 utilizam "?" para o primeiro parâmetro e "&" para os seguintes. Se já tiver "?" no seu URL, tem de utilizar "&" para adicionar mais parâmetros GET.

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

Pré-preencher um inquérito com parâmetros GET através do separador de parâmetros de URL

Pode pré-preencher respostas (por vezes de forma mais simples) utilizando parâmetros de URL, que podem ser configurados em Integração do painel.

Pré-preencher e ocultar a resposta

Pode utilizar o atributo "oculto" de uma pergunta para a ocultar dos seus participantes. Neste caso, a pergunta continua pré-preenchida.