LimeSurvey - Tópicos avançados - Histórico de revisão

Administrador: Página substituída por 'O conteúdo foi migrado para a IntraCGU. https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx'

2024-01-25T15:30:10Z

Página substituída por 'O conteúdo foi migrado para a IntraCGU. https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx'

Mostrar alterações

Administrador: /* Validação */

2023-10-23T14:44:34Z

Validação

← Edição anterior		Edição das 11h44min de 23 de outubro de 2023
Linha 76:		Linha 76:

	No caso de CEP, CNPJ, CPF e telefone, a formatação da entrada será automática quando se usarem os modelos “CGU” e “CGU BÁSICO”. Ou seja, bastará ao usuário final digitar os números do CEP, CNPJ, CPF ou telefone para que os demais caracteres sejam inseridos automaticamente.		No caso de CEP, CNPJ, CPF e telefone, a formatação da entrada será automática quando se usarem os modelos “CGU” e “CGU BÁSICO”. Ou seja, bastará ao usuário final digitar os números do CEP, CNPJ, CPF ou telefone para que os demais caracteres sejam inseridos automaticamente.

			É importante destacar que essa validação funciona apenas em perguntas do tipo "Texto Curto Livre".

	== Dinamizando um questionário ==		== Dinamizando um questionário ==

Administrador em 20h40min de 18 de outubro de 2023

2023-10-18T20:40:30Z

← Edição anterior		Edição das 17h40min de 18 de outubro de 2023
Linha 131:		Linha 131:

	Trabalho == “orgaopublico”		Trabalho == “orgaopublico”

	~~== Adicionando máscaras de formatação automática ==~~

	Os modelos CGU e Embutido incluem uma função em Javascript para acrescentar máscaras de formatação automática customizadas, além daquelas já disponibilizadas. Trata-se da função maskAll(m), que toma como argumentos um array de arrays contendo cada um a máscara, as suas opções, e a expressão regular de validação à qual se quer acrescentar a formatação automática. Para acrescentar as máscaras customizadas, acrescente um script como o seguinte ao código-fonte da descrição do questionário ou do grupo de perguntas:


	<script type="text/javascript"> $(document).ready(function() { var telefone = function (val) { return val.replace(/\D/g, '').length === 11 ? '00-00000-0000' : '00-0000-00009'; }; var telefoneOptions = { onKeyPress: function(val, e, field, options) { field.mask(telefone.apply({ }, arguments), options); } }; maskAll([[telefone, telefoneOptions, "/^[0-9]\u007b2\u007d-[0-9]\u007b4,5\u007d-[0-9]\u007b4\u007d$/", [12, 13]]]); }); </script>

	~~É preciso observar estritamente as quebras de linha antes e após as chaves (“{“ e “}”) e substituir as chaves nas strings, como se verá a seguir.~~

	== Utilizando de chaves em Javascript("{" e "}") ==		== Utilizando de chaves em Javascript("{" e "}") ==

Administrador em 20h36min de 18 de outubro de 2023

2023-10-18T20:36:57Z

← Edição anterior		Edição das 17h36min de 18 de outubro de 2023
Linha 57:		Linha 57:
	{\| border=1		{\| border=1
	\| Campo \|\| Expressão regular		\| Campo \|\| Expressão regular
			\|-
			\| DINHEIRO \|\| /^[0-9]{1,3}(\.[0-9]{3})*,[0-9]{2}$/
	\|-		\|-
	\| CEP \|\| /^[0-9]{5}-[0-9]{3}$/		\| CEP \|\| /^[0-9]{5}-[0-9]{3}$/
Linha 73:		Linha 75:
	\|}		\|}

	No caso de CEP, CNPJ, CPF e telefone, a formatação da entrada será automática quando se usarem os modelos ~~“CGU_2017”~~ e ~~“CGU_2017_BASCIO”~~. Ou seja, bastará ao usuário final digitar os números do CEP, CNPJ, CPF ou telefone para que os demais caracteres sejam inseridos automaticamente.		No caso de CEP, CNPJ, CPF e telefone, a formatação da entrada será automática quando se usarem os modelos “CGU” e “CGU BÁSICO”. Ou seja, bastará ao usuário final digitar os números do CEP, CNPJ, CPF ou telefone para que os demais caracteres sejam inseridos automaticamente.

	== Dinamizando um questionário ==		== Dinamizando um questionário ==

Administrador em 19h59min de 13 de março de 2023

2023-03-13T19:59:10Z

@@ Linha 5: / Linha 5: @@
 Por padrão, a nova tabela de códigos terá campos para informar o primeiro e o último nome do respondente, seu e-mail e o código de acesso (que também pode ser criado automaticamente). O botão [[Arquivo:NovoImagem17.PNG]] permite incluir novos campos nessa tabela, o que pode ser especialmente útil na personalização do questionário usando o expression manager. Nesse caso, far-se-á uso de expressões como {TOKEN:FIRSTNAME} ou {TOKEN:LASTNAME}.
-=== Modelos de e-mail ===
+== Modelos de e-mail ==
 O botão [[Arquivo:NovoPropriedadedoEnquerito.PNG]] do menu lateral "Configurações" leva às configurações de modelos de e-mail. Além dos e-mails relacionados à restrição de acesso ao formulário, modelos de notificação ao administrador, confirmação da conclusão do formulário e registro no sistema também estão disponíveis. Eles fazem uso extenso do expression manager.
-O uso conjunto de e-mails e chaves de acesso permite a criação de uma mala direta de convites para a participação no questinário.
+O uso conjunto de e-mails e chaves de acesso permite a criação de uma mala direta de convites para a participação no questionário.
 == Validação ==

Administrador: /* Reativando Respostas */

2022-12-02T18:01:29Z

Reativando Respostas

← Edição anterior		Edição das 15h01min de 2 de dezembro de 2022
Linha 134:		Linha 134:
	2- [[Arquivo:Lime_edit_participante_2.PNG]]		2- [[Arquivo:Lime_edit_participante_2.PNG]]

	Para permitir o participante complementar a resposta anterior, ~~em Respostas da pesquisa~~, ~~procure~~ a resposta pelo token do participante, ~~edite~~ a resposta e ~~marque~~ a opção '''Completo''' como '''Não''' e '''Salvar''':		Para permitir o participante complementar a resposta anterior, acessar o item "Registros" do menu lateral, procurar a resposta pelo token do participante, editar a resposta e marcar a opção '''Completo''' como '''Não'''. Em seguida, clicar em '''Salvar''':

	1- [[Arquivo:Lime_edit_resposta.PNG]]		1- [[Arquivo:Lime_edit_resposta.PNG]]

Administrador: /* Editando formulários fora do LimeSurvey */

2022-12-02T17:51:15Z

Editando formulários fora do LimeSurvey

← Edição anterior		Edição das 14h51min de 2 de dezembro de 2022
Linha 119:		Linha 119:
	== Editando formulários fora do LimeSurvey ==		== Editando formulários fora do LimeSurvey ==

	Há casos em que a edição de um formulário no LimeSurvey pode ser muito demorada – um formulário muito extenso, por exemplo, ou com várias perguntas semelhantes. Nessas ocasiões, pode ser vantajoso exportar o inquérito e editá-lo manualmente. Para isso, o usuário deve clicar no botão [[Arquivo:NovoImagem20.PNG]] na barra de ferramentas do ~~inquérito~~, em seguida ~~em [[Arquivo:NovoImagem21.PNG]]~~ Formato "valores separados por ~~tabulações"~~ (*.txt). Será baixado um arquivo de texto com todas as informações do inquérito, em um formato semelhante ao CSV, mas com os valores separados por tabulação.		Há casos em que a edição de um formulário no LimeSurvey pode ser muito demorada – um formulário muito extenso, por exemplo, ou com várias perguntas semelhantes. Nessas ocasiões, pode ser vantajoso exportar o inquérito e editá-lo manualmente. Para isso, o usuário deve clicar no botão [[Arquivo:NovoImagem20.PNG]] na barra de ferramentas do questionário, em seguida selecionar "Formato 'valores separados por tabulação' (*.txt)" e clicar em "Exportar". Será baixado um arquivo de texto com todas as informações do inquérito, em um formato semelhante ao CSV, mas com os valores separados por tabulação.

	O arquivo gerado pode ser aberto em diversos editores, mas é recomendável utilizar o Notepad++, que é homologado para uso na CGU. Não é recomendável utilizar nem o LibreOffice, nem o Excel, porque pode haver problemas na importação subseqüente. A primeira linha do arquivo corresponde a um cabeçalho com a identificação de cada coluna. A cada linha, uma informação de configuração ou uma unidade do formulário (questão ou grupo de questões). No caso de formulário com muitas repetições das questões, o procedimento de copiar um grupo de questões pronto, colar e substituir os códigos das questões deve ser suficiente para praticamente concluí-lo. Depois, para importar novamente o questionário, é preciso criar um novo com o botão [[Arquivo:Novos2Imagem22.PNG]] na barra de ferramentas do sistema, na aba importar selecionar o arquivo modificado no computador do usuário, e importar o inquérito.

			O arquivo gerado pode ser aberto em diversos editores, mas é recomendável utilizar o Notepad++, que é homologado para uso na CGU. Não é recomendável utilizar nem o LibreOffice, nem o Excel, porque pode haver problemas na importação subseqüente. A primeira linha do arquivo corresponde a um cabeçalho com a identificação de cada coluna. A cada linha, uma informação de configuração ou uma unidade do formulário (questão ou grupo de questões). No caso de formulário com muitas repetições das questões, o procedimento de copiar um grupo de questões pronto, colar e substituir os códigos das questões deve ser suficiente para praticamente concluí-lo. Depois, para importar novamente o questionário, é preciso criar um novo com o botão [[Arquivo:CriarQuestionario.PNG]] na barra de ferramentas do sistema, na aba importar selecionar o arquivo modificado no computador do usuário, e importar o questionário.

	== Reativando Respostas ==		== Reativando Respostas ==

Administrador: /* Equações de relevância */

2022-12-02T17:44:15Z

Equações de relevância

← Edição anterior		Edição das 14h44min de 2 de dezembro de 2022
Linha 94:		Linha 94:
	== Equações de relevância ==		== Equações de relevância ==

	Equações de relevância determinam se uma pergunta ou um grupo de perguntas será exibido para o usuário final – isto é, determinam se é relevante. Elas podem ser criadas com o uso do expression manager ou do botão ~~[[Arquivo:NovoImagem19.PNG]]~~ na barra de ferramentas da pergunta. Contudo, somente com o expression manager é possível determinar a relevância de todo o grupo de questões. Por isso, e por permitir formas mais refinadas para determinação da relevância, o expression manager é a opção recomendada.		[[Arquivo:NovoImagem19.PNG\|thumb\|direita\|Botão de acesso às condições]]

			Equações de relevância determinam se uma pergunta ou um grupo de perguntas será exibido para o usuário final – isto é, determinam se é relevante. Elas podem ser criadas com o uso do expression manager ou do botão "Designer de condições" na barra de ferramentas da pergunta. Contudo, somente com o expression manager é possível determinar a relevância de todo o grupo de questões. Por isso, e por permitir formas mais refinadas para determinação da relevância, o expression manager é a opção recomendada.

	Para adicionar uma equação de relevância usando o expression manager, não é preciso usar chaves para a delimitação da expressão (todo o conteúdo do campo “equação de relevância” é considerado código do expression manager). Um valor verdadeiro ou igual a 1 determinará a exibição da pergunta ou do grupo. Um valor falso ou igual a zero determinará sua não-exibição. Por exemplo, para que um grupo de perguntas seja exibido somente para servidores públicos, considerando que a pergunta com o código “Trabalho” tenha coletado essa informação, poderia ser utilizada a seguinte equação de relevância:		Para adicionar uma equação de relevância usando o expression manager, não é preciso usar chaves para a delimitação da expressão (todo o conteúdo do campo “equação de relevância” é considerado código do expression manager). Um valor verdadeiro ou igual a 1 determinará a exibição da pergunta ou do grupo. Um valor falso ou igual a zero determinará sua não-exibição. Por exemplo, para que um grupo de perguntas seja exibido somente para servidores públicos, considerando que a pergunta com o código “Trabalho” tenha coletado essa informação, poderia ser utilizada a seguinte equação de relevância:

Administrador: /* Modelos de e-mail */

2022-12-02T17:36:05Z

Modelos de e-mail

← Edição anterior		Edição das 14h36min de 2 de dezembro de 2022
Linha 7:		Linha 7:
	=== Modelos de e-mail ===		=== Modelos de e-mail ===

	O botão [[Arquivo:~~NovoImagem18~~.PNG]] leva ~~à configuração dos~~ modelos de e-mail ~~[[Arquivo:NovoPropriedadedoEnquerito.PNG]]~~. Além dos e-mails relacionados à restrição de acesso ao formulário, modelos de notificação ao administrador, confirmação da conclusão do formulário e registro no sistema estão disponíveis. Eles fazem uso extenso do expression manager.		O botão [[Arquivo:NovoPropriedadedoEnquerito.PNG]] do menu lateral "Configurações" leva às configurações de modelos de e-mail. Além dos e-mails relacionados à restrição de acesso ao formulário, modelos de notificação ao administrador, confirmação da conclusão do formulário e registro no sistema também estão disponíveis. Eles fazem uso extenso do expression manager.

	O uso conjunto de e-mails e chaves de acesso permite a criação de uma mala direta de convites para a participação ~~na pesquisa~~.		O uso conjunto de e-mails e chaves de acesso permite a criação de uma mala direta de convites para a participação no questinário.

	== Validação ==		== Validação ==

Administrador: /* Chaves de acesso */

2022-12-02T17:32:26Z

Chaves de acesso

← Edição anterior		Edição das 14h32min de 2 de dezembro de 2022
Linha 1:		Linha 1:
	== Chaves de acesso ==		== Chaves de acesso ==

	Por meio das chaves de acesso, é possível restringir a utilização dos questionários apenas a usuários finais selecionados. Ao publicar um formulário, o servidor será perguntado se deseja mudar para o modo de acesso restrito. Clicando “mudar para modo de acesso restrito”, essa funcionalidade será ativada e o sistema perguntará se deve inicializar os códigos, após o que será possível criar chaves de acesso e enviar e-mails de convite para o preenchimento do formulário. Os códigos são acessíveis por meio do botão [[Arquivo:NovoImagem16.PNG]] ~~na barra de ferramentas do inquérito~~.		Por meio das chaves de acesso, é possível restringir a utilização dos questionários apenas a usuários finais selecionados. Ao publicar um formulário, o servidor será perguntado se deseja mudar para o modo de acesso restrito. Clicando “mudar para modo de acesso restrito”, essa funcionalidade será ativada e o sistema perguntará se deve inicializar os códigos, após o que será possível criar chaves de acesso e enviar e-mails de convite para o preenchimento do formulário. Os códigos são acessíveis por meio do botão [[Arquivo:NovoImagem16.PNG]] no menu lateral "Configurações".

	Por padrão, a nova tabela de códigos terá campos para informar o primeiro e o último nome do respondente, seu e-mail e o código de acesso (que também pode ser criado automaticamente). O botão [[Arquivo:NovoImagem17.PNG]] permite incluir novos campos nessa tabela, o que pode ser especialmente útil na personalização do questionário usando o expression manager. Nesse caso, far-se-á uso de expressões como {TOKEN:FIRSTNAME} ou {TOKEN:LASTNAME}.		Por padrão, a nova tabela de códigos terá campos para informar o primeiro e o último nome do respondente, seu e-mail e o código de acesso (que também pode ser criado automaticamente). O botão [[Arquivo:NovoImagem17.PNG]] permite incluir novos campos nessa tabela, o que pode ser especialmente útil na personalização do questionário usando o expression manager. Nesse caso, far-se-á uso de expressões como {TOKEN:FIRSTNAME} ou {TOKEN:LASTNAME}.