Formulário

1. Geral

No Mitra, é possível criar formulários a partir das tabelas criadas no banco de dados. Esses formulários podem ser utilizados para adicionar ou editar registros e podem ser vinculados a diversos componentes da interface, como botões, tabelas ou listas, proporcionando interações dinâmicas e automatizadas.

2. Como criar um formulário

• Acesse a tela de “Interfaces” no Mitra.

• Clique no botão “Novo” para iniciar a criação de um novo formulário.

• Selecione o cadastro ao qual o formulário será vinculado. Isso definirá a fonte de dados que o formulário utilizará, permitindo adicionar, editar ou visualizar registros associados a esse cadastro.

3. IDs e Descrição

Toda tabela criada no Mitra já recebe dois atributos nativos: ID e Descrição.

• ID: Pode ser autoincremental, numérico ou texto. Se o ID for autoincremental, ele será tratado como tal também no formulário, o que significa que o usuário não precisará interagir com ele, já que será gerado automaticamente. Se ele não for autoincremental, ele aparecerá no formulário para o usuário adicionar.

• Descrição: É um atributo nativo que aparece por padrão no formulário. Se o usuário desejar, pode renomear o campo “Descrição” ou, caso não queira utilizá-lo, pode marcar a descrição como autoincremental, o que a tornará praticamente ignorada no processo de inserção de dados.

4. Campos FK (Foreign Keys)

Os campos FK oferecem várias opções de configuração que controlam como os dados relacionados serão manipulados.

• Fixo: Use essa opção quando você quer que um campo tenha sempre o mesmo valor. Exemplo: ao criar uma tarefa, você quer que o status da tarefa seja automaticamente definido como "pendente", sem que o usuário precise selecionar manualmente.

• Seleção: Ideal para quando um formulário precisa pegar um valor baseado no contexto da tela. Por exemplo, ao clicar em uma negociação dentro de uma lista de negociações, você pode abrir um formulário de "item de negociação", onde o campo "negociação" será preenchido automaticamente com a negociação selecionada na tela.

• Busca: Permite que o usuário selecione valores de um drop-down, como quando você quer que o campo "Cidade" do vendedor seja preenchido a partir de uma lista de cidades.

• Busca e Adição: Além de selecionar um valor existente, o usuário pode adicionar um novo valor no momento do cadastro. Por exemplo, ao cadastrar um vendedor, se a cidade desejada não estiver na lista, o usuário pode adicionar a nova cidade na hora.

5. Atributos Comuns (Texto, Número, Data)

Para campos comuns como texto, número e data, há opções de configuração que controlam sua exibição e comportamento:

• Editável: O campo pode ser preenchido ou alterado pelo usuário.

• Bloqueado: O campo estará visível, mas não poderá ser editado.

• Obrigatório: O preenchimento do campo será obrigatório.

• Oculto: O campo não será exibido no formulário.

6. Anexos

Se precisar anexar arquivos, como fotos ou documentos, no formulário, use um atributo do tipo texto e marque a opção de “Anexo”. Por exemplo, ao cadastrar um vendedor, você pode criar um campo "foto" do tipo texto, marcar a opção “anexo” e, ao preencher o formulário, anexar uma foto do vendedor. A imagem (ex: foto_do_josé.jpg) será enviada para o Mitra Drive, e o link da imagem será armazenado no registro do vendedor.

7. Máscaras

Campos do tipo texto e número podem ter máscaras aplicadas para garantir que o formato dos dados siga padrões predefinidos, como CPF, CNPJ, CEP, telefone ou tempo.

8. Atributos Numéricos

Os atributos numéricos têm configurações específicas:

• Prefixo e Sufixo: Você pode adicionar caracteres antes (prefixo) ou depois (sufixo) do valor numérico.

• Permitir Valores Iguais: Em situações onde valores únicos são necessários (como CNPJ), essa opção pode ser desmarcada para garantir que o valor não seja duplicado no banco de dados. Por exemplo, se você não quiser que dois registros tenham o mesmo CNPJ, o formulário irá validar isso automaticamente.

9. Reordenar Colunas

A ordem dos campos no formulário pode ser ajustada facilmente arrastando-os pela interface de configuração. Isso permite que você personalize a disposição dos campos no formulário de acordo com a necessidade.

10. Configurações Avançadas

• Formulário Público: É possível gerar um link público que permita o acesso ao formulário sem a necessidade de login.

• Mensagem Pós-Submissão: Você pode configurar uma mensagem de confirmação para o usuário após o envio do formulário.

• Ação Pós-Adição/Edição: Essa opção permite que ações automáticas sejam realizadas após o envio do formulário. Exemplo: ao criar um projeto, você pode configurar uma ação para que várias tarefas sejam criadas automaticamente.

11. Uso do Formulário sem Ações No-Code ou de Database

Ao utilizar o componente de formulário, não é necessário configurar ações no-code nem ações de banco de dados para a inserção ou edição de registros. O formulário já realiza essas operações automaticamente:

• Adicionar Registros: O formulário insere os dados diretamente na tabela associada, sem a necessidade de ações extras de banco de dados ou no-code.

• Editar Registros: Da mesma forma, ao utilizar um formulário para editar registros, não é necessário configurar uma ação de "UPDATE" no banco de dados. O formulário já edita os registros automaticamente, sem precisar de nenhuma ação adicional.

12. Interação com Views SQL

Se você deseja usar um formulário de edição dentro de uma view SQL, é importante mapear o campo de ID corretamente. O Mitra precisa identificar a qual cadastro o ID corresponde para que o formulário funcione corretamente. Por exemplo, se você está utilizando uma view de clientes, é necessário mapear a coluna de ID do cliente com o cadastro correspondente.