> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/entrega/formularios.md).

# Formulários

<figure><img src="/files/dk5BoBq5uYEzkwtzRn2G" alt=""><figcaption></figcaption></figure>

O recurso **Form Card** no Gaio DataOS permite incorporar formulários interativos diretamente em dashboards, facilitando a coleta de dados dos usuários. É ideal para aplicar filtros, enviar parâmetros ou criar experiências dinâmicas.

Um dashboard pode ter mais de um formulário, incluindo diferentes formas de apresentação, como:

* Botão que abre o formulário
* Formulário visível diretamente no dashboard
* Formulário oculto no menu lateral direito do dashboard

***

### Como Utilizar

#### 1. Adicionar o Formulário ao Fluxo

Vá em **Entrega > Formulário** no menu de tarefas.\
Arraste o **Formulário** para o seu fluxo de processo.

***

#### 2. Configurar o Card

**Rótulo:**\
Defina um nome para o card (ex.: “Sales Filter”).

**Formulário:**\
Selecione o formulário que deseja utilizar (ele deve ter sido previamente criado no [Formulário](https://docs.gaiodataos.com/gaio-dataos-portuguese/~/revisions/SEPgoonnJKaRz3oL2duP/tools/formularios)).

***

#### 3. Opções de Exibição

**Formulário aberto pelo botão:**\
O formulário aparecerá apenas quando o usuário clicar no botão.

**Formulário dentro do Painel:**\
O formulário ficará sempre visível na visualização do dashboard.

***

#### 4. Opções Avançadas

**Comportamento do filtro (opcional):**\
Quando habilitado, os valores selecionados atuarão automaticamente como filtros.

**Remover cartão (opcional):**\
Remove fundo e padding para integrar o formulário de forma mais fluida ao layout.

***

#### 5. Estilização do Botão

**Título do botão:**\
Defina o texto do botão (ex.: “Apply Filter”, “Search”, “Save”).

**Tema do botão:**\
Escolha uma cor personalizada utilizando código hexadecimal (ex.: `#FE8533`).

***

#### 6. Salvar

Clique em **Salvar** para aplicar as configurações e ativar o componente.

***

### Dicas

* Utilize formulários como ferramentas de entrada para tarefas de ETL, queries SQL ou chamadas de API REST.
* Combine com dashboards dinâmicos para oferecer interatividade em tempo real.
* Personalize o estilo para manter alinhamento com a identidade visual do ambiente.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/entrega/formularios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
