---
title: Formulário
slug: lowcode-new/formulario
description: Learn how to interact with an application using a drag and drop form in this comprehensive document. Discover how to create a form using CSS features, JavaScript, and AngularJS code, and explore the possibilities of multiple-page forms. With pre-configure
createdAt: 2023-08-24T13:00:14.265Z
---

É através do formulário que o usuário interage com a aplicação. Ele é criado combinando componentes “drag and drop” de interface de usuário, recursos CSS e código JavaScript e AngularJS.

- Cada formulário pode conter uma ou mais páginas e cada uma possui código HTML, um controlador AngularJS e uma coleção de dependências;
- O layout da tela é comum a todas as páginas de formulário e é construído arrastando e soltando componentes da interface do usuário;
- O layout da tela, desenhado na guia Desenho da tela, contém uma coleção de linhas, em que cada linha pode ter um ou mais componentes da interface do usuário;
- Ao adicionar qualquer campo, pode-se adicionar no mesmo as opções de ocultação, obrigatoriedade, edição, regras de negócio, ações de click, textos de ajuda, eventos do Java Script e de renderização.
- Páginas previamente configuradas no sistema:
  - **Página de CRUD** – Página configurada automaticamente pelo sistema, durante a criação do Objeto de Negócios, que fornece a funcionalidade CRUD (criar, ler, atualizar e excluir) ao Objeto de Negócios;
  - **Página padrão** – Página usada para fornecer dados do usuário durante a criação de um incidente, requisição, problemas ou mudança do Workflow e ESM;
  - **Página de processo** – Página usada para iniciar um Processo de Negócios do Low Code;
  - **Página de tarefa** – Página que renderiza um formulário do Low Code na tela de ticket de incidente, requisição, problemas ou mudança de um workflow do Workflow e ESM;
  - **Página de relatório** – Página para integração do formulário com os relatórios gerados pelo sistema, incluindo dependências específicas para a execução de um relatório JASPER.

Os Formulários também podem ser disponibilizados em Tickets de Requisição ou incidente, Problemas e Mudanças.

# Antes de começar

- [x] É necessário ter criado um projeto Low Code

# Passo a passo

:::::WorkflowBlock
:::WorkflowBlockItem
Acesse a funcionalidade pelo menu de navegação `Low Code > Gerenciamento > Formulário;`
:::

:::WorkflowBlockItem
Clique em "**Criar**";&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RUblss18ZnoPM-265XjEI_image.png)
:::

::::WorkflowBlockItem
Complete os campos disponíveis na aba "**Identificação**":

- Nome do **Projeto&#x20;**&#x4C;ow Code a qual o formulário pertence
- **Nome&#x20;**&#x64;o formulário
- **Descrição&#x20;**&#x64;o formulário
- **Pasta&#x20;**&#x6F;nde as configurações do formulário serão armazenadas
- **Regra de negócio&#x20;**&#x64;e validação, se necessário
- Selecione a caix&#x61;**&#x20;Exibe no Centro de Experiência&#x20;**&#x63;aso deseje que o formulário seja exibido no centro de experiência.



:::hint{type="info"}
✏️ <u>**Nota:**</u> No sistema interno da empresa há a página **Centro de Experiência**. &#xC9;*&#x20;intranet* da empresa, uma página central onde se publicam notícias e informações relevantes. Marcando esta opção, este formulário será exibido dentro do **Centro de Experiência**.
:::



![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/pL0ejybB1xFC30ecf1DdO_image.png)
::::
:::::

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/F9UZgePKWw8FDsUtDusVr_image.png)

:::hint{type="warning"}
⚠️ <u>**Atenção!**</u> A versão é incrementada automaticamente pelo sistema sempre que uma nova versão do formulário é criada.
:::

## Adicionar Página ao formulário&#x20;

Os tipos de páginas que você pode adicionar, vai depender do tipo de projeto que você está desenvolvendo. Se for um cadastro a página de CRUD deve ser adicionada. Se for um formulário customizado as páginas de form padrão e de tarefa devem ser adicionados. Se for um relatório ou filtros, a mesma lógica se aplica.&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/xnyQsFFywbX2g9DzFnSeS_image.png)

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bbXyGkEeUPnpqfU8ORD0M_image.png" size="52" width="800" height="490" position="center" showCaption="false"}

# Guias do formulário

### Identificação

Dados gerais do formulário.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/tuz6xafT9She0vzfFc5SV_image.png)

### Objetos de Negócio

Local onde estão declarados os Objetos de Negócios.&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/uJPhy1fBxJPea83X8hp5X_image.png)

### Código Compartilhado

Local onde é inserido as linhas de códigos que são utilizadas por todas as páginas de forma comum e onde é possível incluir dependências que são trechos de códigos customizados (CSS e JavaScript)

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ULwgVgqkuApx2aE25bsAR_image.png)

### Desenho de tela

Local onde são inseridos os componentes e objetos relativos aos desenhos da tela do formulário com inputs, selects, grids, botões, checkbox, options, html customizado, entre outros. para mais informações veja [Desenho de Tela](docId\:k0HOXaJ7X8tpnmtQt1VMR).

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/6cwKNqK_FXa-r8JUOjm0d_image.png)

### JS para teste&#x20;

Local para execução de teste de um trecho de código JavaScript.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/caT_JuKlm0ZY-vxf902AF_image.png)

### Páginas do formulário&#x20;

Exibição das páginas de CRUD, Padrão, Tarefa e Relatório que fazem parte do projeto e possuem um tipo de utilização específico, dependendo do objetivo do projeto como visto anteriormente.

Neste exemplo temos as guias de configuração dos elementos de uma página de CRUD.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/_KTaO_CnsUuD6rqruthbz_image.png)

As abas disponibilizadas para as páginas de CRUD, form Padrão, tarefa, relatórios e filtros terão sempre a mesma estrutura: URL, Propriedades, Ações, HTML, Controller e Dependências.

**URL do menu:&#x20;**&#x45;ndereço para chamada do tipo do formulário;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/N4LqbZpMGUuLqbIsdojGy_image.png)

**Propriedades:&#x20;**&#x64;ados gerais do repositório;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ZvdKK6uockncTlQiUwZ-y_image.png)

**Ações:** Selecionamos o Objeto de Negócios e ações que queremos no formulário:

- Restore do objeto no carregamento da página;
- Gravar dados antes do submit da página;
- Gravar dados após o submit da página.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Sv2pQBqfaFc1_7oB5nIFY_image.png)

**HTML:&#x20;**&#x65;strutura de página HTML;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/lqKfi8PSvdWsQsxiSrJXf_image.png)

**Controller:&#x20;**&#x63;ódigo do controlador referente ao formulário. Os códigos inseridos aqui só serão executados nesta página;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/CnR27qA-1ZMQBI_BL3Rbz_image.png)

**Dependências:&#x20;**&#x53;e o formulário precisar de código externo, esse código deverá ser registrado como uma dependência. O nome da dependência, caminho em que está localizada e se deve ser injetada no controlador também deve ser informado.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/zq7ztUlsn1SneveczN3dh_image.png)

**Desenhando uma tela**. Para criar o design da tela, clique em "**Editar**" ou navegue até a guia do sistema Desenho da Tela, que se abre automaticamente.

Arraste os componentes localizados na paleta do lado esquerdo e solte-os no centro da tela. Os componentes são organizados em linhas e colunas, cada linha tendo uma largura de 12 colunas, seguindo o padrão bootstrap.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Vxwe_JtRUH-6KSiBA7nAA_image.png)

Você pode criar Abas (guias) para os formulários. Para fazer isso, vá para o menu da guia e escolha as guias na organização horizontal ou vertical. Arraste e solte componentes nas guias, conforme explicado acima.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ABB2715pX41Nuj_Lyej2Z_image.png)

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-7KROcoS479jKfxRpt24u_image.png)

