https://wiki.cgu.gov.br/api.php?action=feedcontributions&user=Administrador&feedformat=atomWiki CGU - Contribuições do usuário [pt-br]2024-03-28T13:33:14ZContribuições do usuárioMediaWiki 1.36.3https://wiki.cgu.gov.br/index.php?title=Formularios&diff=7889Formularios2024-02-01T17:27:53Z<p>Administrador: </p>
<hr />
<div>O conteúdo foi migrado para a IntraCGU.<br />
<br />
https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Formularios&diff=7888Formularios2024-02-01T17:27:29Z<p>Administrador: </p>
<hr />
<div>O conteúdo foi migrado para a IntraCGU.<br />
<br />
[Criação de Formulários Utilizando o Lime Survey](https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx)<br />
[teste](https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx)</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Formularios&diff=7887Formularios2024-02-01T17:26:56Z<p>Administrador: </p>
<hr />
<div>O conteúdo foi migrado para a IntraCGU.<br />
<br />
[Criação de Formulários Utilizando o Lime Survey](https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx)</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=7876LimeSurvey - Tópicos avançados2024-01-25T15:30:10Z<p>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'</p>
<hr />
<div>O conteúdo foi migrado para a IntraCGU.<br />
<br />
https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Formularios&diff=7797Formularios2024-01-10T14:06:59Z<p>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'</p>
<hr />
<div>O conteúdo foi migrado para a IntraCGU.<br />
<br />
https://cgugovbr.sharepoint.com/sites/intracgu-tecnologia-da-informacao/SitePages/Lime-Survey(1).aspx</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=7497LimeSurvey - Tópicos avançados2023-10-23T14:44:34Z<p>Administrador: /* Validação */</p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
== Modelos de e-mail ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Enviando o horário de preenchimento no e-mail de notificação ===<br />
<br />
Siga os passos abaixo caso queira configurar a notificação de e-mail para enviar o horário de preenchimento do formulário no campo de Assunto do e-mail ou dentro do corpo do e-mail:<br />
<br />
1 - Crie uma pergunta do tipo "Formula". Pode ser necessário desativar o questionário. Nesse caso, efetue previamente o backup das respostas enviadas.<br />
<br />
2 - Na aba "Formula" nas opções de Configuração da direita, insira o seguinte código:<br />
<br />
<blockquote><br />
{date('Y-m-d H:i:s')}<br />
</blockquote><br />
<br />
[[Arquivo:Questao-Data.png]]<br />
<br />
3 - Na aba "Mostrar, selecione a opção "Desligado" para pergunta não ser mostrada para os participantes.<br />
<br />
[[Arquivo:Questao-Esconder.png]]<br />
<br />
4 - No painel de edição do questionário, na aba "Modelos de Email", selecione o modelo "Notificações Administrativas Básicas"<br />
<br />
[[Arquivo:Email-Assunto-Questao.png]]<br />
<br />
<br />
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:<br />
[[Arquivo:Email-Assunto-Hora.png]]<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| DINHEIRO || /^[0-9]{1,3}(\.[0-9]{3})*,[0-9]{2}$/<br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
É importante destacar que essa validação funciona apenas em perguntas do tipo "Texto Curto Livre".<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=7476LimeSurvey - Tópicos avançados2023-10-18T20:40:30Z<p>Administrador: </p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
== Modelos de e-mail ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Enviando o horário de preenchimento no e-mail de notificação ===<br />
<br />
Siga os passos abaixo caso queira configurar a notificação de e-mail para enviar o horário de preenchimento do formulário no campo de Assunto do e-mail ou dentro do corpo do e-mail:<br />
<br />
1 - Crie uma pergunta do tipo "Formula". Pode ser necessário desativar o questionário. Nesse caso, efetue previamente o backup das respostas enviadas.<br />
<br />
2 - Na aba "Formula" nas opções de Configuração da direita, insira o seguinte código:<br />
<br />
<blockquote><br />
{date('Y-m-d H:i:s')}<br />
</blockquote><br />
<br />
[[Arquivo:Questao-Data.png]]<br />
<br />
3 - Na aba "Mostrar, selecione a opção "Desligado" para pergunta não ser mostrada para os participantes.<br />
<br />
[[Arquivo:Questao-Esconder.png]]<br />
<br />
4 - No painel de edição do questionário, na aba "Modelos de Email", selecione o modelo "Notificações Administrativas Básicas"<br />
<br />
[[Arquivo:Email-Assunto-Questao.png]]<br />
<br />
<br />
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:<br />
[[Arquivo:Email-Assunto-Hora.png]]<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| DINHEIRO || /^[0-9]{1,3}(\.[0-9]{3})*,[0-9]{2}$/<br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=7475LimeSurvey - Tópicos avançados2023-10-18T20:36:57Z<p>Administrador: </p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
== Modelos de e-mail ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Enviando o horário de preenchimento no e-mail de notificação ===<br />
<br />
Siga os passos abaixo caso queira configurar a notificação de e-mail para enviar o horário de preenchimento do formulário no campo de Assunto do e-mail ou dentro do corpo do e-mail:<br />
<br />
1 - Crie uma pergunta do tipo "Formula". Pode ser necessário desativar o questionário. Nesse caso, efetue previamente o backup das respostas enviadas.<br />
<br />
2 - Na aba "Formula" nas opções de Configuração da direita, insira o seguinte código:<br />
<br />
<blockquote><br />
{date('Y-m-d H:i:s')}<br />
</blockquote><br />
<br />
[[Arquivo:Questao-Data.png]]<br />
<br />
3 - Na aba "Mostrar, selecione a opção "Desligado" para pergunta não ser mostrada para os participantes.<br />
<br />
[[Arquivo:Questao-Esconder.png]]<br />
<br />
4 - No painel de edição do questionário, na aba "Modelos de Email", selecione o modelo "Notificações Administrativas Básicas"<br />
<br />
[[Arquivo:Email-Assunto-Questao.png]]<br />
<br />
<br />
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:<br />
[[Arquivo:Email-Assunto-Hora.png]]<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| DINHEIRO || /^[0-9]{1,3}(\.[0-9]{3})*,[0-9]{2}$/<br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Wiki_CGU:Sobre&diff=6697Wiki CGU:Sobre2023-04-05T16:10:10Z<p>Administrador: </p>
<hr />
<div><br />
<br />
== Página destinada a conteúdos relacionados a edição de páginas na Wiki CGU. ==<br />
<br />
<br />
[https://www.mediawiki.org/wiki/Help:Links/pt-br Como criar conexões (links) entre as páginas.]</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Wiki_CGU:Sobre&diff=6696Wiki CGU:Sobre2023-04-05T16:00:51Z<p>Administrador: Criou página com ' Página destinada a conteúdos relacionados a edição de páginas na Wiki CGU.'</p>
<hr />
<div><br />
<br />
Página destinada a conteúdos relacionados a edição de páginas na Wiki CGU.</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Codigo.png&diff=6671Arquivo:Questao-Codigo.png2023-03-13T22:26:28Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Mostrar.png&diff=6670Arquivo:Questao-Mostrar.png2023-03-13T22:23:28Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Savedid.png&diff=6669Arquivo:Questao-Savedid.png2023-03-13T22:19:42Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Setor2.png&diff=6668Arquivo:Questao-Setor2.png2023-03-13T22:05:44Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Setor.png&diff=6667Arquivo:Questao-Setor.png2023-03-13T21:50:18Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Predefini%C3%A7%C3%A3o:%C3%8Dndice&diff=6665Predefinição:Índice2023-03-13T21:14:03Z<p>Administrador: </p>
<hr />
<div>{| border="1" cellpadding="5" cellspacing="0" style="text-align: center;"<br />
|+'''Índice Geral'''<br />
|-<br />
| '''[[Formularios]]''' <br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Iniciando uso ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Criando um formulário ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Tipos de questões ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Publicando o Formulário ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Configurações do questionário ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Exportação e importação ]]<br />
|-<br />
! style="background: #DCDBF2;" | [[ LimeSurvey - Tópicos avançados ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Problemas Conhecidos ]] <br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Perguntas Frequentes do LimeSurvey ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Atualizações do LimeSurvey ]]<br />
|-<br />
| style="background: #DCDBF2;" | [[ LimeSurvey - Tutoriais ]]<br />
|}</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Formularios&diff=6664Formularios2023-03-13T21:11:38Z<p>Administrador: </p>
<hr />
<div>= Sistema de formulários e Pesquisas da CGU (LimeSurvey) =<br />
<br />
<center>{{Índice}}</center><br />
<br />
== LimeSurvey - Apresentação ==<br />
<br />
O Sistema de Formulários e Pesquisas da CGU (LimeSurvey) é uma ferramenta de coleta de dados implementada na CGU a partir do primeiro semestre de 2015, com vistas à substituição de ferramentas externas como os formulários do Google Docs. Ele é um software livre, com código-fonte aberto e sujeito às modificações necessárias para uma melhor adequação às necessidades do utilizador ou para corrigir eventuais defeitos.<br />
<br />
Este breve “manual de sobrevivência” visa atender às necessidades mais prementes do usuário comum da CGU, especialmente para a criação de pesquisas e extração de dados. Foram adicionados também alguns tópicos avançados, que serão úteis para certos usuários.<br />
<br />
O manual eletrônico da ferramenta está disponível em http://manual.limesurvey.org/<br />
<br />
== Cadastro e Acesso ==<br />
<br />
Para realizar o cadastro no sistema, é preciso realizar o pedido no Portal de Serviços: https://servicos.cgu.gov.br, opção Sistemas > Solicitar criação de usuário no Sistema LIME SURVEY (https://servicos.cgu.gov.br/sm/ess/offeringPage/1002_SISTEMAS_LIMESURVEY_3) e prosseguir com a solicitação. <br />
Obs.: O cadastro deverá ser autorizado pela chefia.<br />
<br />
=== Ambiente de Produção ===<br />
<br />
É o ambiente que '''deve ser usado''' para criação e distribuição de formulários reais.<br />
<br />
URL: https://formularios.cgu.gov.br/admin/<br />
<br />
Também pode ser acessado pela intranet (https://intra.cgu.gov.br): Guia de Sistemas > Lime Survey<br />
<br />
=== Ambiente de Homologação ===<br />
<br />
É o ambiente de '''testes''' do sistema. Usar apenas para validar alguma funcionalidade ou caso de uso.<br />
<br />
URL: https://formularios-h.cgu.gov.br/admin<br />
<br />
== O LimeSurvey ==<br />
<br />
O LimeSurvey é o software por trás do Sistema de Formulários e Pesquisas da CGU. Ele foi adotado como alternativa às soluções hospedadas por terceiros, em especial os formulários do Google Docs, que vinham sendo utilizados por algumas áreas da casa como ferramenta de coleta de dados.<br />
<br />
Ele é uma ferramenta de formulários, o que significa que os dados coletados serão estruturados em função das questões que forem criadas. Em outras palavras, as questões devem ser elaboradas tendo em vista o uso que será feito das respostas.<br />
<br />
O LimeSurvey não contempla o tratamento dos dados coletados. Portanto, no cenário ideal, o fluxo de trabalho posterior à coleta já terá sido pensado antes mesmo da criação dos formulários.<br />
<br />
As questões devem ser elaboradas tendo em vista o uso que será feito das respostas. No cenário ideal, o fluxo de trabalho posterior à coleta já terá sido pensado antes mesmo da criação dos formulários.<br />
<br />
=== Conceitos básicos ===<br />
<br />
* Para utilizar o LimeSurvey, é preciso conhecer algumas palavras-chave:<br />
** Formulário: um instrumento de coleta de dados, estruturado em torno de questões e grupos de questões.<br />
** Questão: a unidade por meio da qual um dado será coletado. Possui um enunciado, um campo de entrada e possivelmente um texto de ajuda. Existem vários tipos de questão, que serão abordados mais adiante.<br />
** Grupo de questões: conjunto de questões. Serve somente para organizar a exibição do formulário para o usuário final. Possui um título e pode possuir uma explicação.<br />
** Etiqueta: em questões com alternativas, o nome e o valor de cada alternativa.<br />
** Conjunto de etiquetas: um conjunto pré-definido de etiquetas. Podem ser criados ou carregados no momento da edição da questão.<br />
** CSV (valores separados por vírgula): formato de arquivo que pode ser utilizado tanto para manipular formulários fora do LimeSurvey, quanto para exportar dados de respostas. Contém uma linha de título e linhas de valores separados por alguma pontuação. O LimeSurvey utiliza vírgulas como separadores, aspas duplas como delimitadores de texto e codificação UTF-8. Veja mais no tópico exportação e importação.<br />
** Validação: código utilizado para dizer se uma resposta é aceitável ou não. Utiliza expressões regulares (veja mais no manual do LimeSurvey e no Google). Alguns códigos de validação estão elencados na sessão Validação.<br />
** Equação de relevância: código que determina a exibição ou não de uma questão ou de um grupo de questões (em outras palavras, se a questão é relevante segundo as respostas dadas previamente). Pode utilizar o expression manager. Um valor igual a 1 indica que o item será exibido.<br />
** Expression manager: mecanismo do LimeSurvey que permite a utilização de fórmulas e a exibição de informações atualizadas dinamicamente conforme as respostas do usuário final. Tópico avançado.<br />
<br />
<br />
<br />
= LimeSurvey - Conclusão =<br />
<br />
Este manual de sobrevivência não esgota as funcionalidades do LimeSurvey. Contudo, deve servir para o usuário comum realizar as tarefas necessárias na Controladoria-Geral da União, sem medo de usar a ferramenta. Mais informações úteis podem ser obtidas na internet, seja nos mecanismos de pesquisa, seja no manual do LimeSurvey. O melhor caminho para aprender a usar o sistema consiste em criar um formulário de teste, que não seja exibido na lista de formulários, e ali testar e experimentar as diferentes possibilidades oferecidas por ele.</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=6663LimeSurvey - Tópicos avançados2023-03-13T19:59:10Z<p>Administrador: </p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
== Modelos de e-mail ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
=== Enviando o horário de preenchimento no e-mail de notificação ===<br />
<br />
Siga os passos abaixo caso queira configurar a notificação de e-mail para enviar o horário de preenchimento do formulário no campo de Assunto do e-mail ou dentro do corpo do e-mail:<br />
<br />
1 - Crie uma pergunta do tipo "Formula". Pode ser necessário desativar o questionário. Nesse caso, efetue previamente o backup das respostas enviadas.<br />
<br />
2 - Na aba "Formula" nas opções de Configuração da direita, insira o seguinte código:<br />
<br />
<blockquote><br />
{date('Y-m-d H:i:s')}<br />
</blockquote><br />
<br />
[[Arquivo:Questao-Data.png]]<br />
<br />
3 - Na aba "Mostrar, selecione a opção "Desligado" para pergunta não ser mostrada para os participantes.<br />
<br />
[[Arquivo:Questao-Esconder.png]]<br />
<br />
4 - No painel de edição do questionário, na aba "Modelos de Email", selecione o modelo "Notificações Administrativas Básicas"<br />
<br />
[[Arquivo:Email-Assunto-Questao.png]]<br />
<br />
<br />
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:<br />
[[Arquivo:Email-Assunto-Hora.png]]<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Email-Assunto-Hora.png&diff=6662Arquivo:Email-Assunto-Hora.png2023-03-13T19:57:16Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Email-Assunto-Questao.png&diff=6661Arquivo:Email-Assunto-Questao.png2023-03-13T19:54:34Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Esconder.png&diff=6660Arquivo:Questao-Esconder.png2023-03-13T19:46:33Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Data.png&diff=6659Arquivo:Questao-Data.png2023-03-13T19:43:57Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Questao-Data.png</p>
<hr />
<div>== Descrição do arquivo ==<br />
Configuração de uma pergunta que armazena a data e hora em que é respondido o formulário.</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Questao-Data.png&diff=6658Arquivo:Questao-Data.png2023-03-13T19:30:47Z<p>Administrador: Configuração de uma pergunta que armazena a data e hora em que é respondido o formulário.</p>
<hr />
<div>== Descrição do arquivo ==<br />
Configuração de uma pergunta que armazena a data e hora em que é respondido o formulário.</div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Configura.png&diff=6633Arquivo:Configura.png2022-12-02T18:39:58Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Configura.png</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:AlterarSenha.png&diff=6632Arquivo:AlterarSenha.png2022-12-02T18:35:41Z<p>Administrador: </p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Usuario.png&diff=6631Arquivo:Usuario.png2022-12-02T18:34:11Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Usuario.png</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Erro_500:Internal_Server_Error&diff=6630Erro 500:Internal Server Error2022-12-02T18:30:30Z<p>Administrador: </p>
<hr />
<div>Erro da nova atualização do LimeSurvey. Para corrigir esse erro é necessário desativar e ativar novamente o questionário. Porém é necessário que realize o backup das respostas e dos participantes antes de desativar o questionário já que esse processo perde as respostas e os participantes.<br />
<br />
Para realizar o backup dos participantes (Exportando) e recuperar o backup (Importando): [[Exportando_e_Importando_participantes]]<br />
<br />
Para realizar o backup das respostas (Exportando) e recuperar o backup (Importando): [[Exportando_e_Importando_respostas]]<br />
<br />
=== Desativar o questionário: ===<br />
<br />
* 1º Passo: Entrar no questionário que está com erro e clicar em "Parar este questionário".<br />
<br><br />
[[Imagem:PrincipalQuestionario.PNG|center|Pagina principal do questionário]]<br />
<br><br><br />
* 2º Passo: Clicar em "Desativar questionário".<br />
<br><br />
[[Imagem:DesativandoQuestionario.PNG|center|Desativando Questionário]]<br />
<br />
<br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:DesativandoQuestionario.PNG&diff=6629Arquivo:DesativandoQuestionario.PNG2022-12-02T18:30:19Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:DesativandoQuestionario.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:PrincipalQuestionario.PNG&diff=6628Arquivo:PrincipalQuestionario.PNG2022-12-02T18:28:59Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:PrincipalQuestionario.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Como_configurar_uma_pergunta_do_Tipo_Anexo&diff=6627Como configurar uma pergunta do Tipo Anexo2022-12-02T18:24:36Z<p>Administrador: </p>
<hr />
<div>Para deixar a pergunta obrigatória, é necessário configurar uma opção avançada, conforme o passo a passo a seguir.<br />
<br />
1 - Pergunta. Procure a pergunta no menu lateral "Estrutura" e clica em cima dela.<br />
<br />
[[Arquivo:Pergunta.PNG|frame|none]]<br />
<br />
2 - Em seguida, clique em "Editar" na barra de ferramentas superior.<br />
<br />
[[Arquivo:Editar.PNG|frame|none]]<br />
<br />
3 - Role a página do formulário de edição para baixo e localize a seção "Outros". Na opção "Número mínimo de arquivos", você deve colocar pelo menos 1. Assim quando o usuário for responder o questionário ele terá que pelo menos anexar 1 arquivo.<br />
<br />
[[Arquivo:Outros.PNG|frame|none]]<br />
<br />
--------------<br />
<br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Outros.PNG&diff=6626Arquivo:Outros.PNG2022-12-02T18:24:22Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Outros.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Editar.PNG&diff=6625Arquivo:Editar.PNG2022-12-02T18:21:04Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Editar.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Pergunta.PNG&diff=6624Arquivo:Pergunta.PNG2022-12-02T18:18:47Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Pergunta.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Question%C3%A1rio_Expirado&diff=6623Questionário Expirado2022-12-02T18:13:17Z<p>Administrador: </p>
<hr />
<div>Para mudar a condição do formulário de expirado para ativo, acesse o item "Publicação e acesso" no menu lateral do questionário.<br />
<br />
[[Imagem:ferramentasComAsInstroçõesAcima.PNG|frame|none|Acessando as configurações de publicação]]<br />
<br />
---------------<br />
Em seguida, limpe o campo "Data de expiração" ou selecione uma nova data e salve.<br />
<br />
[[Imagem:ControledeAcessoePublicação.PNG|frame|none|Controle de Acesso e Publicação]]<br />
<br />
== Possível Erro ==<br />
Caso não tenha mudado o status do questionário, o possível problema está nas configurações do usuário. Para acessar as configurações do usuário siga o passo a passo da imagem abaixo. <br />
Na aba "Configurações pessoais", encontre o campo "Formato da data" selecione a opção dd/mm/aaaa. Salve e repita todo o processo descrito acima.<br />
Caso as instruções apresentadas não tenham sido suficientes, favor contatar-nos pelo e-mail sesol@cgu.gov.br.<br />
<br />
[[Imagem:clicandoNoUsuario.PNG|frame|none]] <br />
<br />
------------------------------<br />
<br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:ClicandoNoUsuario.PNG&diff=6622Arquivo:ClicandoNoUsuario.PNG2022-12-02T18:12:05Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:ClicandoNoUsuario.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:ControledeAcessoePublica%C3%A7%C3%A3o.PNG&diff=6621Arquivo:ControledeAcessoePublicação.PNG2022-12-02T18:08:04Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:ControledeAcessoePublicação.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:FerramentasComAsInstro%C3%A7%C3%B5esAcima.PNG&diff=6620Arquivo:FerramentasComAsInstroçõesAcima.PNG2022-12-02T18:07:09Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:FerramentasComAsInstroçõesAcima.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Excesso_de_op%C3%A7%C3%A3o_na_pergunta&diff=6619Excesso de opção na pergunta2022-12-02T18:04:53Z<p>Administrador: </p>
<hr />
<div>Este é um exemplo onde um usuario do LimeSurvey tinha várias opção para um determinada pergunta e excedia o limite de opções.<br />
<br />
*Para melhorar a visualização é indicado fazer uma questão após o usuário selecionar o estado perguntando qual letra inicia o município.<br />
<br />
[[Imagem:Questaoum.png| Questão 1]]<br />
<br />
*E fazer 3 questões onde cada questão terá um grupo com cerca de 250 municípios na ordem.<br><br />
---------<br />
=== Exemplo ===<br />
<br />
*Questão 1 terá todos os municípios A-F<br />
<br />
[[Imagem:QuestaoumAF.png|Questão 1 terá todos os municípios A-F]]<br />
<br />
*Questão 2 terá todos os municípios G-L<br />
<br />
[[Imagem:QuestaodoisGL.png|Questão 2 terá todos os municípios G-L]]<br />
<br />
*Questão 3 terá todos os municípios M-Z<br />
<br />
[[Imagem:QuestaotresLZ.png|Questão 3 terá todos os municípios M-Z]]<br />
<br />
*E também definir condições para as perguntas, que só irão aparecer no questionário caso a opção<br />
selecionada na questão 1 seja seu correspondente.<br />
<br />
*Caso 1<br />
<br />
[[Imagem:Casoum.png|Caso 1.]]<br />
---------<br />
*Caso 2<br />
<br />
[[Imagem:Casodois.png|Caso 2.]]<br />
---------<br />
*Caso 3<br />
<br />
[[Imagem:Casotres.png|Caso 3.]]<br />
<br />
*Desta forma ficará mais organizado e melhor para o usuário escolher o município.<br />
-----------------<br />
<br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=6618LimeSurvey - Tópicos avançados2022-12-02T18:01:29Z<p>Administrador: /* Reativando Respostas */</p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
=== Modelos de e-mail ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Lime_edit_resposta_2.PNG&diff=6617Arquivo:Lime edit resposta 2.PNG2022-12-02T18:01:05Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Lime edit resposta 2.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Lime_edit_resposta.PNG&diff=6616Arquivo:Lime edit resposta.PNG2022-12-02T17:59:27Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Lime edit resposta.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Lime_edit_participante_2.PNG&diff=6615Arquivo:Lime edit participante 2.PNG2022-12-02T17:57:13Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Lime edit participante 2.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:Lime_edit_participante.PNG&diff=6614Arquivo:Lime edit participante.PNG2022-12-02T17:55:02Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:Lime edit participante.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=6613LimeSurvey - Tópicos avançados2022-12-02T17:51:15Z<p>Administrador: /* Editando formulários fora do LimeSurvey */</p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
=== Modelos de e-mail ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:NovoImagem20.PNG&diff=6611Arquivo:NovoImagem20.PNG2022-12-02T17:46:38Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:NovoImagem20.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=6610LimeSurvey - Tópicos avançados2022-12-02T17:44:15Z<p>Administrador: /* Equações de relevância */</p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
=== Modelos de e-mail ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
[[Arquivo:NovoImagem19.PNG|thumb|direita|Botão de acesso às condições]]<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:NovoImagem19.PNG&diff=6609Arquivo:NovoImagem19.PNG2022-12-02T17:42:25Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:NovoImagem19.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=6608LimeSurvey - Tópicos avançados2022-12-02T17:36:05Z<p>Administrador: /* Modelos de e-mail */</p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
=== Modelos de e-mail ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=Arquivo:NovoPropriedadedoEnquerito.PNG&diff=6607Arquivo:NovoPropriedadedoEnquerito.PNG2022-12-02T17:34:31Z<p>Administrador: Administrador carregada uma nova versão de Arquivo:NovoPropriedadedoEnquerito.PNG</p>
<hr />
<div></div>Administradorhttps://wiki.cgu.gov.br/index.php?title=LimeSurvey_-_T%C3%B3picos_avan%C3%A7ados&diff=6606LimeSurvey - Tópicos avançados2022-12-02T17:32:26Z<p>Administrador: /* Chaves de acesso */</p>
<hr />
<div>== Chaves de acesso ==<br />
<br />
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".<br />
<br />
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}.<br />
<br />
=== Modelos de e-mail ===<br />
<br />
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.<br />
<br />
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.<br />
<br />
== Validação ==<br />
<br />
Cada pergunta contém opcionalmente uma expressão de validação. Trata-se de uma expressão regular, colocada entre barras (“/”), no formato habitualmente usado na programação de computadores. Para validar um número com um tamanho mínimo e um máximo, por exemplo, a expressão seria: /^[0-9]{min,max}$/, onde:<br />
<br />
{| border=1<br />
| Código || Significado <br />
|- <br />
| ^ || Inicio da resposta <br />
|- <br />
| [0-9] || Qualquer caractere compreendido de 0 a 9 (outras opções seriam, por exemplo, [a-z], [A-Z] ou ainda [a-zA-Z\u00c0-\u017F] para permitir qualquer letra, maiúscula, minúscula ou acentuada)<br />
|-<br />
| $ || Fim da resposta <br />
|}<br />
<br />
'''Exemplos de expressões regulares'''<br />
<br />
Algumas expressões regulares comumente utilizadas para validar respostas nos formulários da CFECS:<br />
<br />
{| border=1<br />
| Campo || Expressão regular <br />
|-<br />
| CEP || /^[0-9]{5}-[0-9]{3}$/ <br />
|-<br />
| CNPJ || /^[0-9]{2}\.[0-9]{3}\.[0-9]{3}\/[0-9]{4}-[0-9]{2}$/ <br />
|-<br />
| CPF || /^[0-9]{3}.[0-9]{3}.[0-9]{3}-[0-9]{2}$/ <br />
|-<br />
| Código IBGE de município || /^[0-9]{7}$/ <br />
|-<br />
| INEP || /^[0-9]{8}$/ <br />
|-<br />
| Telefone || /^\([0-9]{2}\) [0-9]{4,5}-[0-9]{4}$/ <br />
|-<br />
| E-mail || /^(\w[-._+\w]*\w@\w[-._\w]*\w\.\w{2,3})$/<br />
|}<br />
<br />
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.<br />
<br />
== Dinamizando um questionário ==<br />
<br />
O expression manager é o nome dado a um mecanismo de automação de formulários utilizado pelo LimeSurvey. Por meio de códigos escritos entre chaves (“{“ e “}”), podem-se dinamizar enunciados, descrições, textos de ajuda e de encerramento, e também definir se uma questão ou um grupo de questões será exibido. No expression manager poderão ser utilizados os códigos das questões (para obter as respectivas respostas) e funções, das quais a mais comum será a de processamento condicional (“if”). A sintaxe da função if é semelhante à do Excel:<br />
<br />
{if(questao1 == ″comparação″, ″Verdadeiro″, ″Falso″)}<br />
<br />
Note bem que deve haver um espaço entre o operador lógico (“==”, neste caso) e os operandos. O primeiro argumento da função é a condição a ser cumprida, o segundo é a ação ou o texto no caso de a comparação ser verdadeira, e o terceiro, no caso de ser falsa.<br />
<br />
Os principais operadores lógicos disponíveis são:<br />
<br />
* (): agrupamento e argumentos de funções.<br />
* !: negação.<br />
* < <= > >= it le gt ge: comparação de valores (menor, menor ou igual, maior, maior ou igual).<br />
* == != eq ne: "igual" ou "não igual".<br />
* and or: "e" e "ou"<br />
<br />
=== Exemplos de expression manager ===<br />
<br />
=== Utilizando uma resposta anterior ===<br />
<br />
{Name}, há quanto tempo você trabalha no(a){instituição}?<br />
<br />
No caso de a resposta á pergunta com o código "Nome" ser "Fulano" e á pergunta com o código "Instituicao" ser "CGU", será exibido: "Fulano, há quanto tempo você trabalha no(a) CGU?"<br />
<br />
=== Texto condicional ===<br />
<br />
{Nome}, há quanto tempo você trabalha {if(TipoInstituicao == “Associacao”, “nessa associação”, if(TipoInstituicao == “OrgaoPublico”, “nesse órgão”, “nessa empresa”))}?<br />
<br />
Neste caso, conforme a resposta à pergunta com o código “TipoInstituicao”, será exibido o texto “nessa associação”, “nesse órgão” ou “nessa empresa”. Note que há duas cláusulas “if”, uma dentro da outra, para o caso de a primeira condição não ser satisfeita.<br />
<br />
=== E-mail exemplificado ===<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: {strtolower(str_replace(" ",".",Responsavel))}@{strtolower(str_replace(" ","",Entidade))}.{if(TipoEntidade == "ONG","org",if(TipoEntidade == "AssMu", "org", if(TipoEntidade == "OrgLe", "leg", if(TipoEntidade == "OrgJu", "jus", "gov"))))}.br)<br />
<br />
Esse exemplo mostra o uso das funções “strtolower” para colocar um texto em caixa baixa e “str_replace” para substituir os espaços nos nomes por ponto ou para excluí-los (substituir por um texto vazio: ″″). Ao final do processamento, o texto ficará como segue:<br />
<br />
Informe preferencialmente o seu endereço de e-mail oficial na entidade (ex.: fulano.de.tal@nomedaentidade.org.br)<br />
<br />
=== Ajuda adicional ===<br />
<br />
* A melhor fonte de informações sobre o expression manager é o manual do LimeSurvey: https://manual.limesurvey.org/Expression_Manager<br />
* A lista de funções suportadas pode ser encontrada em: https://manual.limesurvey.org/Expression_Manager#Access_to_Functions<br />
<br />
== Equações de relevância ==<br />
<br />
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.<br />
<br />
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:<br />
<br />
'''''O expression manager é o mecanismo recomendado para criar equações de relevância.'''''<br />
<br />
Trabalho == “orgaopublico”<br />
<br />
== Adicionando máscaras de formatação automática ==<br />
<br />
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:<br />
<br />
<br />
<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><br />
<br />
É 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.<br />
<br />
== Utilizando de chaves em Javascript("{" e "}") ==<br />
<br />
O uso de chaves (“{“ e “}”) pelo expression manager resulta em uma dificuldade para a inserção de códigos em Javascript no formulário. O Javascript permite acrescentar funcionalidades e dinamizar adicionalmente os formulários, mas também faz uso de chaves. No caso de ser necessário usar essa linguagem (para acrescentar novas máscaras de formatação automática, por exemplo), as chaves do código terão de ser seguidas imediatamente por uma quebra de linha (na abertura) ou precedidas imediatamente de uma quebra de linha (no fechamento). Nas strings, as chaves terão de ser substituídas por “\u007b” na abertura e por “\u007d” no fechamento.<br />
<br />
== Editando formulários fora do LimeSurvey ==<br />
<br />
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.<br />
<br />
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.<br />
<br />
<br />
== Reativando Respostas ==<br />
<br />
Há casos que o participante concluí o preenchimento do formulário mas deseja preencher campos os quais deixou sem preencher. Nestes casos é necessário reativar o participante e a resposta anterior para continuar o preenchimento.<br />
<br />
Para permitir o participante preencher novamente o formulário, em Participantes do questionário, edite o participante e marque a opção '''Concluído''' como '''Não''':<br />
<br />
1- [[Arquivo:Lime_edit_participante.PNG]]<br />
<br />
<br />
2- [[Arquivo:Lime_edit_participante_2.PNG]]<br />
<br />
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''':<br />
<br />
1- [[Arquivo:Lime_edit_resposta.PNG]]<br />
<br />
2- [[Arquivo:Lime_edit_resposta_2.PNG]]<br />
<br />
------------------<br />
<br><br><br />
<center>{{Índice}}</center></div>Administrador