# LimeSurvey



# Criação de Usuário no LimeSurvey

### Pesquisa/Enquete Prefeitura de Sorocaba

Este manual descreve o passo a passo para cadastrar um novo usuário na plataforma LimeSurvey utilizada pela Prefeitura de Sorocaba, incluindo a configuração de permissões e vinculação à Secretaria responsável.

---

## 1. Acessar a Gestão de Usuários

1. Faça login na plataforma com seu usuário administrativo.
2. No menu superior, clique em **Configuração**.
3. Selecione a opção **Gestão de usuários**.

[![tela 1.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/scaled-1680-/tela-1.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/tela-1.png)

Na tela inicial de configurações, também é possível visualizar um resumo do sistema (usuários ativos, questionários, etc.) na caixa **"Visão geral do sistema"**.

---

## 2. Iniciar o cadastro do novo usuário

1. Na tela **Gestão de usuários**, clique no botão verde **"➕ Adicionar usuário"**, localizado no topo da listagem.

[![tela 2.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/scaled-1680-/tela-2.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/tela-2.png)

1. Será aberta a janela **"Adicionar usuário"** com os seguintes campos:

<table id="bkmrk-campo-obrigat%C3%B3rio-de"><thead><tr><th>Campo</th><th>Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td>**Usuário**</td><td>Sim</td><td>Login de acesso (ex.: `nome.sobrenome`). Somente em letras minúsculas.</td></tr><tr><td>**Nome completo**</td><td>Não</td><td>Nome exibido do usuário</td></tr><tr><td>**E-mail**</td><td>Sim</td><td>E-mail institucional (ex.: `nome.sobrenome@sorocaba.sp.gov.br`)</td></tr><tr><td>**Data/hora de expiração**</td><td>Não</td><td>Define prazo de validade do acesso, NÃO deve ser preenchido</td></tr><tr><td>**Definir senha agora?**</td><td>Não</td><td>Deixar sempre em 'NÃO', pois a senha será via LDAP</td></tr></tbody></table>

3. Preencha os campos obrigatórios e clique em **"Adicionar"**.

[![tela3.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/scaled-1680-/tela3.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/tela3.png)

> 💡 Após criado, o usuário aparece na listagem principal com um **ID Usuário** único, exibindo colunas como Usuário, E-mail, Nome completo, Data de criação, Criado por e Número de questionários.

---

## 3. Configurar Permissões do Usuário

Após o cadastro básico, é necessário definir as permissões de acesso. Acesse a opção de edição do usuário (botão **"..."** na coluna **Ação**) para abrir a tela de permissões.

As permissões são organizadas em uma tabela com colunas de ações (Criar, Visualizar, Atualizar, Excluir, etc.) por módulo do sistema. Os grupos em que são necessários editar as permissões são:

### 3.1 Questionários

- Permissão para criar questionários (o autor recebe automaticamente todas as permissões sobre os próprios questionários criados), selecionando todas as colunas, EXCETO excluir.

---

## 4. Definir Método de Autenticação

Ainda na tela de permissões, configure o método de login do usuário:

- **Usar autenticação do banco de dados interno** — login e senha gerenciados pelo próprio LimeSurvey.
- **Usar autenticação LDAP** — login integrado ao diretório LDAP da Prefeitura.

---

## 5. Vincular a Secretaria do Usuário

1. No final da tela de permissões, localize o campo **"Secretaria do usuário"**.
2. No menu suspenso, selecione a Secretaria responsável pelo usuário (ex.: *Secretaria de Administração*).
3. Esse campo define qual Secretaria o usuário representa dentro do sistema.

---

## 6. Salvar as Configurações

1. Após revisar as permissões e a Secretaria vinculada, clique no botão verde **"Salvar"**, no canto inferior direito da janela.
2. Caso deseje descartar as alterações, clique em **"Cancelar"**.

[![tela4.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/scaled-1680-/tela4.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-09/tela4.png)

---

## 7. Verificar o Usuário Criado

Volte à tela **Gestão de usuários** para confirmar que o novo usuário aparece corretamente na listagem, com:

- ID Usuário
- Login (Usuário)
- E-mail
- Nome completo
- Data de criação
- Usuário responsável pela criação ("Criado por")
- Número de questionários vinculados

---

## Resumo do Fluxo

```
Configuração → Gestão de usuários → Adicionar usuário
      ↓
Preencher dados (usuário, nome, e-mail, senha)
      ↓
Configurar permissões por módulo
      ↓
Definir método de autenticação (interno / LDAP)
      ↓
Selecionar Secretaria do usuário
      ↓
Salvar

```

# Padrões em Formulários do LimeSurvey

<p class="callout warning">É necessário incluir "/" antes de depois das expressões regulares a fim de funcionarem no LimeSurvey  
</p>

### Configurações para o Formulário

- Sempre altere o tema para PMS-extends\_fruity\_twentythree 
    - Vá em Configurações &gt; Configurações Gerais &gt; Tema &gt; PMS-extends\_fruity\_twentythree;
- Sempre inclua como Administrador a Secretaria cliente ou o servidor que solicitou o serviço, inclua o nome e o telefone no campo "Administrador"
- Sempre inclua o email da secretaria ou do servidor que solicitou o formulário no campo "endereço de e-mail do administrador"

##### Campo Nome Completo

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-info" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 21.0495%;"></col><col style="width: 79.0742%;"></col></colgroup><tbody><tr><td>Título do Campo</td><td>Nome Completo</td></tr><tr><td>Ajuda do Campo</td><td>Informe seu nome completo. Caso utilize nome social pode informá-lo.</td></tr><tr><td>Tipo de Campo</td><td>Texto Livre Curto</td></tr><tr><td>Validação</td><td><div class="row"><div class="col-10">/^[A-Za-zÀ-ÖØ-öø-ÿ]+([ '-][A-Za-zÀ-ÖØ-öø-ÿ]+)+ ?$/</div></div></td></tr></tbody></table>

##### Campo Número do CPF, RNE ou RNM

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-info-0" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 21.0495%;"></col><col style="width: 79.0742%;"></col></colgroup><tbody><tr><td>Título do Campo</td><td>Número do CPF, RNE ou RNM</td></tr><tr><td>Ajuda do Campo</td><td>Informe seu número de CPF. Ex: 999.999.999-99  
  
Para estrangeiros é necessário informar o Registro Nacional de Estrangeiro ou Registro Nacional de Migrante  
</td></tr><tr><td>Tipo de Campo</td><td>Texto Livre Curto</td></tr><tr><td>Validação</td><td>/^(?:\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}|\[A-Za-z\]\\d{6}-?\\d)$/  
</td></tr></tbody></table>

##### Campo Endereço de E-mail

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-info-1" style="border-collapse: collapse; width: 100%; height: 135.984px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Título do Campo</td><td style="height: 29.7969px;">Endereço de E-mail</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Ajuda do Campo</td><td style="height: 46.5938px;">Informe o seu Endereço de E-mail. Pode ser necessário entrar em contato com você para confirmar sua inscrição.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Tipo de Campo</td><td style="height: 29.7969px;">Texto Livre Curto</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Validação</td><td style="height: 29.7969px;">/^\[A-Za-z0-9\]+(\[.\_%+-\]?\[A-Za-z0-9\]+)\*@\[A-Za-z0-9\](?:\[A-Za-z0-9-\]\*\[A-Za-z0-9\])?(?:\\.\[A-Za-z0-9\](?:\[A-Za-z0-9-\]\*\[A-Za-z0-9\])?)+$/  
</td></tr></tbody></table>

##### Campo Telefone

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-n%C3%BAme" style="border-collapse: collapse; width: 100%; height: 135.984px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Título do Campo</td><td style="height: 29.7969px;">Número de Telefone com WhatsApp</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Ajuda do Campo</td><td style="height: 46.5938px;">Informe o seu Número de Telefone para contato através do WhatsApp ou ligação. Ex: 1599999999

Pode ser necessário entrar em contato com você para confirmar sua inscrição.

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Tipo de Campo</td><td style="height: 29.7969px;">Texto Livre Curto</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Validação</td><td style="height: 29.7969px;">/^\\(?\\d{2}\\)?\[\\s-\]?\\d{4,5}-?\\d{4}$/</td></tr></tbody></table>

##### Campo Idade

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-info-2" style="border-collapse: collapse; width: 100%; height: 117.833px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Título do Campo</td><td style="height: 29.4583px;">Idade</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Ajuda do Campo</td><td style="height: 29.4583px;">Informe a sua idade</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Tipo de Campo</td><td style="height: 29.4583px;">Texto Livre Curto</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Validação</td><td style="height: 29.4583px;">/^(?:\[1-9\]|\[1-9\]\\d|1\[01\]\\d|120)$/  
</td></tr></tbody></table>

##### Campo Data de Nascimento

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-info-3" style="border-collapse: collapse; width: 100%; height: 117.833px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Título do Campo</td><td style="height: 29.4583px;">Data de Nascimento</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Ajuda do Campo</td><td style="height: 29.4583px;">Informe a sua Data de Nascimento. Ex: dd/mm/aaaa</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Tipo de Campo</td><td style="height: 29.4583px;">Texto Livre Curto</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Validação</td><td style="height: 29.4583px;">/^(0\[1-9\]|\[12\]\[0-9\]|3\[01\])\\/(0\[1-9\]|1\[0-2\])\\/(19|20)\\d{2}$/</td></tr></tbody></table>

##### Campo Gênero

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-g%C3%AAne" style="border-collapse: collapse; width: 100%; height: 117.833px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Título do Campo</td><td style="height: 29.4583px;">Gênero</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Ajuda do Campo</td><td style="height: 29.4583px;">Informe o Gênero com que você se identifica</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Tipo de Campo</td><td style="height: 29.4583px;">Lista com comentários</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Validação</td><td style="height: 29.4583px;">/^(0\[1-9\]|\[12\]\[0-9\]|3\[01\])/(0\[1-9\]|1\[0-2\])/(19|20)\\d{2}$/</td></tr><tr><td>Opções</td><td>Masculino

Feminino

Não Binárie

Outro

</td></tr><tr><td>Referência Legal</td><td>[https://www.gov.br/mdh/pt-br/assuntos/noticias/2024/dezembro/ministerio-disponibiliza-formulario-padrao-para-uniformizar-coleta-de-dados-da-populacao-lgbtqia](https://www.gov.br/mdh/pt-br/assuntos/noticias/2024/dezembro/ministerio-disponibiliza-formulario-padrao-para-uniformizar-coleta-de-dados-da-populacao-lgbtqia)

\- https://www.gov.br/mdh/pt-br/navegue-por-temas/lgbt/ApresentaodoPowerPoint.pdf

</td></tr></tbody></table>

##### Campo Termo de Autorização de Participação para Menor de Idade

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-term" style="border-collapse: collapse; width: 100%; height: 324.312px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Título do Campo</td><td style="height: 29.7969px;">Termo de Autorização de Participação para Menor de Idade</td></tr><tr style="height: 124.953px;"><td style="height: 124.953px;">Ajuda do Campo</td><td style="height: 124.953px;">Menores de idade precisam encaminhar Autorização manuscrita para participação do evento.

Modelo:  
Eu, \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ responsável legal de \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ portador do RG \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ e CPF\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ residente no endereço \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ autorizo a participar do evento Patinação no Gelo que ocorrerá {G1Q00005.shown}. Assinatura\_\_\_\_\_\_\_

</td></tr><tr><td>Observação</td><td>Substitua "G1Q00005" em {G1Q00005.shown} pelo id da Pergunta que contem o agendamento

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Tipo de Campo</td><td style="height: 29.7969px;">Envio de Arquivo</td></tr></tbody></table>

### Padrão de Formulário

#### Comportamentos Personalizados

Caso seja necessário algum comportamento personalizado no Formulário os scripts de cada campo estão no repositório: [http://ti.sorocaba.sp.gov.br/gitlab/laferreira/limesurvey-scripts](http://ti.sorocaba.sp.gov.br/gitlab/laferreira/limesurvey-scripts)

<p class="callout warning">Sempre faça a atualização dos scripts no repositório a fim de compartilhar as soluções.</p>

#### Grupo "Informações sobre o Evento"

Este grupo de informações deve conter o limite de inscrições e também os campos para escolha de Data e Horário caso seja necessário agendamento.

##### Limite de Inscrição

É opcional o limite de inscrições para um evento contudo esta deve ser a primeira pergunta que o Munícipe deve ter contato.

<table border="1" id="bkmrk-t%C3%ADtulo-do-campo-veri" style="border-collapse: collapse; width: 100%; height: 117.833px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Título do Campo</td><td style="height: 29.4583px;"><div class="row"><div class="col-10">Verificar se há vagas disponíveis para este evento</div></div></td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Ajuda do Campo</td><td style="height: 29.4583px;">  
</td></tr><tr><td>Texto da Pergunta</td><td>Verificar</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Tipo de Campo</td><td style="height: 29.4583px;">Múltipla escolha (Type: M)</td></tr><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Validação</td><td style="height: 29.4583px;">  
</td></tr></tbody></table>

<table border="1" id="bkmrk-nome-da-quota%3A-limit" style="border-collapse: collapse; width: 100%; height: 109.312px;"><colgroup><col style="width: 21.0049%;"></col><col style="width: 78.9539%;"></col></colgroup><tbody><tr style="height: 29.4583px;"><td style="height: 29.4583px;">Nome da quota:</td><td style="height: 29.4583px;"><div class="row"><div class="col-10">Limite de Inscrições</div></div></td></tr><tr style="height: 79.8542px;"><td style="height: 79.8542px;">Mensagem da quota:</td><td style="height: 79.8542px;">&lt;h1&gt;O limite de inscrições foi atingido!&lt;/h1&gt;

&lt;p&gt;Infelizmente atingimos o limite de inscrições para este evento.&lt;br /&gt;&lt;br /&gt;Sua inscrição não poderá ser realizada.&lt;/p&gt;

</td></tr></tbody></table>

#### Grupo "Informações sobre a Inscrição"

Este grupo de informações deve as Informações Pessoas sobre o Munícipe.

##### Agendamento de Data e Hora

Sempre que um evento exigir a escolha de agendamento em que há muitas opções de data e horário, resultando numa lista muito grande de escolhas para o usuário o agendamento deve ser Personalizado através da adaptação do script

Referência:

- Casamento Comunitário

##### Agendamento Progressivo (Semanal ou Mensal)

Sempre que um evento exigir a escolha de agendamento em que há muitas opções préviamente cadastradas em que precisam ser liberadas periódicamente o agendamento deve ser Personalizado através de adaptação do script

Referência:

- City Tour

### Elementos de Texto

#### Mensagem de Boas-Vindas

- Sempre inclua uma imagem. A largura deve ser 100% e a altura deve permanecer em branco. Em avançado adicione a classe CSS "arredondar-tudo"
- Sempre adicione um bloco de texto com Informações Importantes, é um resumo das informações presentes no texto 
    - Audiência do Evento;
    - Limitações;
    - Documentos necessários;
    - Local do Evento;
    - Data do Evento.
- Sempre adicione informações de contato para dúvidas: 
    - Nome do contato;
    - Telefone;
    - E-mail.

#### Mensagem Final

- Sempre inclua a informação que a inscrição foi concluída
- Sempre inclua o botão para direcionar a pessoa de volta ao Site da Prefeitura
- Sempre adicione informações de contato para dúvidas: 
    - Nome do contato;
    - Telefone;
    - E-mail.
- 

Exemplo:

```
<h1>Sua inscrição foi concluída</h1>

<p>O seu número de protocolo é {SID * 100000 + SAVEDID}.</p>
<a class="btn btn-primary" href="https://sorocaba.sp.gov.br" width="">Voltar para o Site da Prefeitura de Sorocaba </a>
```

##### Padrão para Emitir Protocolo ao Usuário

Multiplicar o Número do Formulário {SID} por 100.000 e somar o ID da Resposta do Usuário {SAVEDID}

`O seu número de protocolo é {SID * 100000 + SAVEDID}.`

####   


##### Padrão para Exibir Resposta do Usuário a uma Lista em Botão de Radio

Utilizar o ID da Pergunta, exemplo {G1Q00002}, e usar o método shown

`Data e Horário: {G1Q00002.shown}`

# Exportar respostas de um formulário

Este Tutorial explica como fazer a exportação das respostas de um formulário no Lime Survey

<iframe allowfullscreen="allowfullscreen" height="314" src="https://www.youtube.com/embed/IGHIRjadRwI" width="560"></iframe>

# Manutenção de Opções de Agendamento com datas pré-cadastradas

Este Tutorial explica como fazer a manutenção das datas disponíveis um formulário caso elas tenha sido pré-cadastradas num formulário no Lime Survey

<iframe allowfullscreen="allowfullscreen" height="314" src="https://www.youtube.com/embed/s4nIuU-azBA" width="560"></iframe>

# Adicionar ou Editar Limite de Respostas

Este Tutorial explica como isnerir um limite de respostas a uma pergunta de um formulário no Lime Survey

<iframe allowfullscreen="allowfullscreen" frameborder="0" height="315" src="https://www.youtube.com/embed/I9XnMFjpbbM?si=8KYL61RXrlyn1Wpp" title="YouTube video player" width="560"></iframe>

# Criar Formulário no LimeSurvey

<iframe allowfullscreen="allowfullscreen" height="314" src="https://www.youtube.com/embed/9ATAd3PRJYE" width="560"></iframe>

# Baixar anexos de um formulário

Este manual explica como baixar os anexos enviados pelos usuários em um formulário no sistema limesurvey

<iframe allowfullscreen="allowfullscreen" height="314" src="https://www.youtube.com/embed/PW0Xbzgo08Q" width="560"></iframe>

# Criar novo usuário no LimeSurvey

Link do módulo administrativo: https://survey.sorocaba.sp.gov.br/admin

1\) Acessar a tela de **Gestão de Usuários** -&gt; **Adicionar Usuário** e preencher os campos: *Usuário, Nome Completo* e *E-mail* com os mesmos dados de login da rede da Prefeitura.

[![image.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/scaled-1680-/Xtmimage.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/Xtmimage.png)

Obs.: Ignore a mensagem de falha no envio do e-mail para o usuário criado.

[![image.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/scaled-1680-/Rsnimage.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/Rsnimage.png)

2\) Localize o novo usuário na lista de usuários e clique no botão **"..."** da coluna **Ação** para ir na tela de **Editar Permissões**:

Marque as seguintes permissões:  
\- Questionários (exceto coluna Apagar)  
\- Usar autenticação LDAP

[![image.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/scaled-1680-/K89image.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/K89image.png)

Salvar em seguida.

3\) Acesse a tela de **Secretarias**, localize a Secretaria à qual o novo usuário será vinculado (lista à esquerda) e localize o usuário na coluna de usuários **Disponíveis** (conforme destaque na imagem abaixo):

Em seguida, selecione o novo usuário e clique no botão **Adicionar Selecionados** para que o nome do usuário conste na coluna de usuários **Na Secretaria**:

[![image.png](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/scaled-1680-/E8gimage.png)](https://consultic.sorocaba.sp.gov.br/uploads/images/gallery/2026-08/E8gimage.png)