> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/setorizacao/gestao-de-grids.md).

# Gestão de Grids

### Visão Geral

**Gestão de Grids** é o módulo do Orquestrador que permite criar e administrar grids personalizadas para armazenar dados gerados pelos robôs — como logs, dados de monitoramento, parâmetros de execução e itens a serem aprovados. Cada grid é definida pelo usuário com nome, título, tipo, colunas e regras de acesso.

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

<p align="center">Tela <strong>Gestão de Grids</strong> com a listagem de grids cadastradas</p>

***

### Pré-requisitos

* Acesso ao Orquestrador
* (Opcional) Usuários cadastrados na empresa para configurar acesso à grid

***

### Como usar

#### Passo 1 — Acessar Gestão de Grids

No menu do Orquestrador, acesse **Início > Gestão de Grids**. A listagem exibirá todas as grids já cadastradas com as colunas **Nome do Grid**, **Título do Grid**, **Colunas** e **Tipo**.

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

<p align="center">Listagem de grids cadastradas</p>

#### Passo 2 — Criar uma nova grid

Clique no botão **ADICIONAR** no canto superior esquerdo da listagem. A tela **Novo Grid** será aberta.

<figure><img src="/files/0hyIpicqy1iPvvYLiPCb" alt=""><figcaption></figcaption></figure>

<p align="center">Tela <strong>Novo Grid</strong> em branco</p>

#### Passo 3 — Preencher os dados da grid

Preencha os campos:

* **Nome do Grid** — identificador único da grid (usado pelo robô para referenciá-la)
* **Título do Grid** — nome de exibição mostrado na interface
* **Tipo** — finalidade da grid (Log, Monitoramento, Parâmetro ou Aprovação)

#### Passo 4 — Definir as colunas

Na seção **Colunas**, adicione cada coluna da grid:

* Clique no botão **+** à direita para adicionar uma nova coluna
* Digite o nome da coluna no campo
* Use as setas **↑ / ↓** para reordenar
* Use o ícone de **lixeira (🗑)** para remover uma coluna

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

<p align="center">Formulário <strong>Novo Grid</strong> preenchido com três colunas configuradas</p>

#### Passo 5 — Configurar opções de comportamento

Marque as opções de acordo com o comportamento desejado:

* **Limpar grid a cada execução?** — apaga todos os dados da grid no início de cada execução do robô
* **Habilitar edição?** — permite que os usuários editem os registros da grid pela interface

#### Passo 6 — Configurar acesso

Na seção **Configurar acesso**, defina quem pode visualizar e gerenciar a grid:

* **E-mail do Usuário** — adicione usuários individuais clicando no botão **+**
* **Setor** — vincule a grid a um setor
* **Público** — marcado por padrão; ao desmarcar, a grid ficará restrita aos usuários/setores vinculados

#### Passo 7 — Salvar

Clique em **SALVAR** para criar a grid. Ela passará a aparecer na listagem de **Gestão de Grids**.

***

### Tipos de grid

<figure><img src="/files/4BeMBKjgHw8sfZjHBlZW" alt=""><figcaption></figcaption></figure>

<p align="center">Caixa de seleção <strong>Tipo</strong> com as opções disponíveis</p>

| Tipo          | Uso                                                                   |
| ------------- | --------------------------------------------------------------------- |
| Log           | Armazena registros de log gerados pelo robô durante a execução        |
| Monitoramento | Armazena dados de acompanhamento da execução do robô (padrão da tela) |
| Parâmetro     | Armazena parâmetros que alimentam ou configuram a execução do robô    |
| Aprovação     | Armazena itens que requerem aprovação manual antes de seguir no fluxo |

***

### Campos e opções

#### Formulário Novo Grid

| Campo                        | Descrição                                                   | Valores aceitos                          |
| ---------------------------- | ----------------------------------------------------------- | ---------------------------------------- |
| Nome do Grid                 | Identificador único usado pelo robô para referenciar a grid | Texto                                    |
| Título do Grid               | Nome de exibição da grid na interface                       | Texto                                    |
| Tipo                         | Finalidade da grid                                          | Log, Monitoramento, Parâmetro, Aprovação |
| Colunas                      | Lista de colunas da grid (adicionar, reordenar, remover)    | Texto por coluna                         |
| Limpar grid a cada execução? | Apaga os dados da grid no início de cada execução do robô   | Marcado / Desmarcado                     |
| Habilitar edição?            | Permite que usuários editem os registros pela interface     | Marcado / Desmarcado                     |
| E-mail do Usuário            | Adiciona um usuário específico ao acesso da grid            | E-mail cadastrado na empresa             |
| Setor                        | Vincula a grid a um setor                                   | Setor cadastrado                         |
| Público                      | Torna a grid visível para toda a empresa                    | Marcado / Desmarcado                     |

#### Controles da seção Colunas

| Controle | Função                            |
| -------- | --------------------------------- |
| +        | Adiciona uma nova coluna          |
| ↑        | Move a coluna para cima na ordem  |
| ↓        | Move a coluna para baixo na ordem |
| 🗑       | Remove a coluna da grid           |

#### Colunas da listagem Gestão de Grids

| Coluna         | Descrição                                               |
| -------------- | ------------------------------------------------------- |
| Nome do Grid   | Identificador da grid                                   |
| Título do Grid | Nome de exibição                                        |
| Colunas        | Lista das colunas configuradas (separadas por vírgula)  |
| Tipo           | Tipo da grid (Log, Monitoramento, Parâmetro, Aprovação) |

***

### Observações e dicas

* 💡 Use **Nome do Grid** sem espaços ou caracteres especiais — ele é o identificador técnico que o robô usa para gravar dados na grid.
* 💡 O **Título do Grid** é o nome amigável e pode conter espaços e acentos — é o que aparece para os usuários na interface.
* 💡 Escolha o **Tipo** conforme a finalidade da grid: use **Log** para auditoria, **Monitoramento** para acompanhamento operacional, **Parâmetro** para dados de entrada e **Aprovação** para fluxos que exigem validação humana.
* 💡 Marque **Limpar grid a cada execução?** em grids que armazenam dados efêmeros (ex: fila de processamento) — evita acúmulo desnecessário de registros.
* 💡 **Habilitar edição?** é útil em grids de **Parâmetro** e **Aprovação**, onde o usuário precisa intervir nos dados. Em grids de **Log** e **Monitoramento**, normalmente fica desmarcado.
* ⚠️ Só é possível adicionar **usuários já cadastrados na empresa** — e-mails externos serão rejeitados no salvamento.
* ⚠️ Desmarcar **Público** sem adicionar nenhum usuário ou setor deixa a grid acessível **somente para quem a criou**.
