Como Utilizar Formulários Customizados (`local_middag`)

Este guia mostra como criar, configurar e usar formulários personalizados com o plugin local_middag no Moodle.

1. 📍 Acesso ao Criador de Formulários

Acesse o painel administrativo do Moodle.
Vá até: Administração do site → MIDDAG → Formulários Customizados.

2. 📄 Listagem de Formulários

Ao acessar Formulários Customizados, será exibida a lista de formulários existentes (caso já tenha um ou mais formulários criados).

Cada item da lista mostra:

Título do formulário
ID Number
Ações disponíveis (editar, excluir, visualizar, etc.)

3. ➕ Criar um Novo Formulário

A criação de formulário é dividida em 2 passos:

🔹 Passo 1 — Definição do Formulário

Preencha os seguintes campos:

Nome do formulário: Nome visível para o usuário.
ID Number: Código único de identificação interna.
Importar CSV (opcional): Envie um arquivo CSV com dados que poderão ser usados como fonte para campos do tipo Select ou Multiple Select.
Logo do formulário (opcional): Imagem que será exibida no topo do formulário.

Clique em "Próximo" para avançar.

🔹 Passo 2 — Configuração dos Campos

Neste passo, você define os campos que farão parte do formulário.

⚙️ Opções Iniciais

Formulário em múltiplos passos (checkbox): define se os campos serão divididos por etapas ou exibidos em um único bloco.

➕ Adicionar Campos

Para cada campo, configure:

Campo	Descrição

Campo	Descrição
Código do campo	Identificador único (usado em ações e dependências).
Nome do campo	Nome visível no formulário.
Tipo do campo	Tipo de dado (Texto, CPF, Header, Número, Multiple Select, Select, Checkbox).
Fonte de dados (se aplicável)	Para campos do tipo Select/Multiple Select: Manual: insira opções manualmente (uma por linha). CSV: selecione a coluna do CSV importado no passo 1.
Máscara do campo (opcional)	Máscara de preenchimento (ex: RG: `99.999.999-X`).
Campo obrigatório	Marque se o preenchimento é obrigatório.

🔗 Adicionar Dependências

Você pode criar dependências entre os campos. Clique em "Adicionar dependência" para configurar:

Campo	Função

Campo

Função

Depende do campo

Campo anterior do qual este campo depende.

Tipo de dependência

🔸 *Filtrar por valor*: filtra as opções com base no valor do campo pai.
🔸 *Exibir se preenchido*: mostra este campo apenas se o campo pai for preenchido.
🔸 *Exibir se*: mostra este campo apenas se o campo pai tiver um valor específico que pode ser configurado no campo que vai exibir ao selecionar esse tipo. OBSERVAÇÃO: Caso seja adicionar vários valores cada valor deve ser separado utilizando pipeline ‘|’

🪜 Múltiplos Passos

Se o formulário estiver marcado como "múltiplos passos":

Antes de adicionar campos, crie os Passos (etapas) usando o botão "Adicionar passo".
Cada campo adicionado deverá estar vinculado a um passo específico.

✅ Finalizando

Após configurar os campos:

Clique em "Adicionar campo".
Os campos adicionados aparecerão na seção "Campos configurados", onde é possível:
- Editar
- Reordenar
- Excluir

Repita o processo até concluir a estrutura do formulário.

4. ⚙️ Ações do Formulário

As Ações do Formulário permitem executar tarefas automáticas com os dados submetidos, como criar usuários, grupos, cohorts, enviar e-mails e mais.

🧭 Como funciona

Ao acessar a aba de Ações dentro de um formulário, você verá duas seções:

Ações Disponíveis (esquerda): lista de ações que podem ser utilizadas.
Fluxo de Ações (direita): onde você monta o fluxo de execução do formulário.

➕ Adicionando Ações

Arraste uma ação da lista da esquerda para o Fluxo de Ações.
Clique sobre a ação no fluxo para abrir o modal de configuração.
Preencha os parâmetros da ação conforme necessário.
Para seguir o fluxo é necessário fazer a ligação de uma ação a outra.

🧩 Parâmetros e Variáveis

Cada parâmetro pode ser configurado de duas formas:

Padrão: você digita manualmente o valor. Se quiser usar um campo do formulário ou o resultado de uma ação anterior no texto digitado, utilize colchetes exemplo: [código_do_campo_ou_código_da_ação]
Utilizar campo do formulário ou ações anteriores: marque o checkbox correspondente. Um seletor será exibido com os campos disponíveis e os resultados das ações anteriores.

📌 Importante: para usar o resultado de uma ação anterior, a ação que fornece o dado deve estar posicionada antes no fluxo.

⚙️ Ações Disponíveis

🔹 Criar Usuário

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único (para uso em ações futuras).
Nome	Nome completo do usuário.
E-mail	E-mail do novo usuário.
Campos de perfil	Campos adicionais do Moodle (mapeáveis com valores personalizados ou campos do formulário).

🔹 Criar Cohort

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único.
Nome da cohort	Nome visível da cohort.
Categoria	Categoria do sistema onde a cohort será criada.

🔹 Adicionar Usuário em uma Cohort

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único.
Usuário	ID do usuário (campo do formulário ou resultado de ação).
Cohort	ID da cohort desejada.

🔹 Criar Grupo de Curso

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único.
Nome do grupo	Nome do novo grupo.
Cursos	Selecione os cursos onde o grupo será criado.

🔹 Adicionar Usuário em um Grupo

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único.
Usuário	ID do usuário.
Grupo	ID do grupo.

🔹 Criar Método de Inscrição por Cohort

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único.
Cohort	ID da cohort associada.
Cursos	Cursos onde o método será criado.
Grupo	ID do grupo vinculado ao método.
Papel	Papel que o usuário terá ao ser inscrito (estudante, professor, etc).

🔹 Enviar E-mail

Parâmetro	Descrição

Parâmetro	Descrição
Código da ação	Identificador único.
ID do usuário	Destinatário do e-mail.
Assunto do e-mail	Assunto da mensagem.
Conteúdo do e-mail	Corpo da mensagem em texto.

🔀 Condicional IF/ELSE

A ação IF/ELSE permite criar condições que controlam o fluxo de execução das ações subsequentes.

➕ Como configurar:

Clique em "Adicionar Condição".
Preencha os campos:

Campo	Descrição