Integração do painel
From LimeSurvey Manual
Os exemplos e explicações seguintes baseiam-se inteiramente nas contribuições dos nossos utilizadores. Sinta-se à vontade para contribuir, se quiser ajudar a expandir o nosso conhecimento aberto sobre a integração do painel.
Introdução
A partir deste separador pode definir os parâmetros URL que serão aceites pelo seu inquérito. (Estes parâmetros serão anexados ao URL geral de início do inquérito). Esta opção é importante se quiser integrar o seu inquérito com um fornecedor de painéis de inquéritos profissional que lhe fornece os participantes. Este último fornece normalmente o ID único de cada participante do inquérito e terá de gravar esses IDs únicos para referência futura.
Atenção : Com alguns fornecedores, o ID único do participante que será excluído devido a um limite de quota ou ao concluir o inquérito tem de ser enviado de volta ao fornecedor do painel no URL de saída do inquérito ou no URL da quota.
Integração do painel do inquérito: Menu de inquérito > Menu de inquérito > Integração do painel
Integração do painel do inquérito
Será apresentada uma tabela vazia com a opção que lhe permite adicionar um parâmetro URL.
É necessário preencher dois campos:
- Parâmetro: Introduza neste campo o nome do novo parâmetro.
- Pergunta alvo: O valor do parâmetro é sempre gravado na sessão do inquérito, mesmo que não defina aqui uma pergunta alvo. Aqui, pode selecionar uma pergunta do tipo 'Texto curto' ou 'Textos múltiplos'.
Se não gravar o valor do parâmetro URL, poderá continuar a utilizar este parâmetro no URL de saída. Para mais documentação, continue a ler a secção da wiki sobre o URL de saída.
Como utilizar a função de integração do painel
É apresentado abaixo um exemplo simples para explicar como utilizar a função de integração do painel.
1) Primeiro, crie uma pergunta de texto livre curto/longo e dê-lhe o nome que quiser (utilizaremos "LS" no campo Códigos das perguntas). Em seguida, ative a opção Ocultar sempre esta pergunta, localizada no separador Visualização dentro do menu da pergunta.
2) Aceda ao separador de integração do painel e clique em "Adicionar parâmetro URL".
Selecione a pergunta de texto curto/longo que criou no primeiro passo. Os participantes provenientes do respetivo fornecedor de painel profissional chegarão à pergunta alvo. Esta pode estar oculta para que os participantes possam começar a responder ao inquérito.
O nome que escolher para o parâmetro terá de ser incluído na hiperligação de entrada que fornecerá mais tarde ao seu fornecedor de painel. No nosso exemplo, chamar-se-á "LSid". Não se esqueça de clicar no botão Gravar, localizado na parte superior direita da tabela!
3) Agora, tem de configurar a hiperligação de entrada que enviará ao seu fornecedor de painel. Para obter a hiperligação do URL do inquérito, clique nos botões Pré-visualizar inquérito.
Copie o URL a que acedeu a partir da barra de endereços:
Sugestão: O parâmetro "newtest" é utilizado para reinicializar a sessão. Isto é útil quando pretende testar localmente a integração do painel ou quando sabe que os seus participantes estão a utilizar o mesmo dispositivo/navegador para responder ao inquérito. Assim, adicionar "newtest=Y" ao URL do inquérito cria novas respostas na tabela de respostas, forçando a criação de uma nova sessão independentemente do dispositivo/navegador utilizado.
Adicione no final o parâmetro recém-adicionado: &LSid="xxxxxx". A hiperligação deverá ter o seguinte aspeto:
http://localhost/index.php/369498?newtest=Y&lang=en&LSid="xxxxxx"
Sugestão: Os parâmetros GET utilizam "?" para o primeiro parâmetro e "&" para os restantes. Se já tiver "?" no seu URL, tem de utilizar "&" para adicionar outros parâmetros GET. Leia sobre os parâmetros GET e a sua utilização aqui.
Seja o que for que substitua por "xxxxxx", será guardado na pergunta de texto livre curto/longo quando o seu inquirido chegar a essa página. Por exemplo, enviei a um utilizador a seguinte hiperligação:
http://localhost/index.php/369498?newtest=Y&lang=en&LSid=ABCD5
A cadeia de caracteres após LSid foi guardada como resposta à pergunta de texto curto/longo.
Leia a secção da wiki Campos de URL para obter mais informações sobre a personalização de URL.
Exemplos
Os exemplos seguintes foram criados para o ajudar a adicionar:
- Redirecionamentos se os inquiridos terminaram o preenchimento do inquérito;
- Redirecionamentos se os inquiridos foram excluídos devido a uma quota;
- Redirecionamentos se o limite da quota foi atingido.
Nota: parametername={PASSTHRU:parametername}" fornece ao fornecedor do painel o ID do participante.
Atenção : As soluções apresentadas abaixo utilizam os campos de passagem. Tenha em atenção que, para além de "parametername={PASSTHRU:parametername}", tudo o resto tem de ser fornecido pelo seu fornecedor do painel!
A hiperligação de conclusão
A hiperligação de conclusão deve ser inserida no campo URL de saída, que também tem de ser carregado automaticamente para todos os que concluírem com sucesso todo o inquérito.
O URL que tem de enviar de volta ao fornecedor do painel deverá ter o seguinte aspeto:
https://panelproviderwebsite.com/?return=complete¶metername={PASSTHRU:parametername}
A hiperligação de exclusão (screenout)
Uma exclusão (screenout) impede os participantes de continuarem o inquérito porque não pertencem ao grupo-alvo do seu inquérito. Para exclusões, tem de definir o campo do limite da quota como "0" (zero) e permitir que o URL da quota seja carregado automaticamente quando for acionado.
Em seguida, adicione a seguinte hiperligação ao campo URL da quota:
https://panelproviderwebsite.com/?return=screenout¶metername={PASSTHRU:parametername}
Nota: Leia a seguinte secção da wiki para saber mais sobre o sistema de quotas do LimeSurvey e a sua utilização.
A hiperligação de quota cheia (quotafull)
Uma quota cheia (quotafull) exclui os participantes de continuarem o inquérito, porque uma determinada quota foi excedida.
https://panelproviderwebsite.com/?return=quotafull¶metername={PASSTHRU:parametername}
Nota: Leia a seguinte secção da wiki para saber mais sobre o sistema de quotas do LimeSurvey e a sua utilização.
Integração do painel do inquérito através de expressões
Em construção