# Inclusão de Tabela

### Pré-Requisitos

***

O acesso é concedido no programa [Configuração de Permissão de Perfil e Usuário (CSWMEN070)](/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracao-de-permissao-de-perfil-e-usuario.md), onde se deve marcar a opção *Permitir Acesso a Camada de Personalização de Programas* na coluna **Configuração**. Este acesso é automaticamente liberado para **Usuários Administradores** e **Usuários Consistem**

### Acesso

***

Programa do ERP (com grid)\
Rodapé do grid\
[Personalizar Dados](https://ajuda.consistem.com.br/tecnologia/erp/componentes7/funcionalidades/grid/ferramentas-do-grid#id-9.-personalizar-dados)\
[Personalização da Consulta (CSW1CUSTOM060)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/personalizacao-da-consulta.md)\
Botão **Adicionar Tabela**

### Visão Geral

***

O objetivo deste programa é relacionar colunas ou variáveis de contexto do programa de consulta, possibilitando a inclusão de uma nova coluna no grid por meio de relacionamento das colunas que já estão disponíveis. Para isso, é necessário indicar a classe da nova coluna e vincular suas chaves de acesso (idKey) com os dados da consulta que já foi realizada.

### Campos

***

*Campos assinalados com* <mark style="color:red;">**|**</mark> *são de preenchimento obrigatório.*

#### Tabela<mark style="color:red;">**|**</mark>

Informe a tabela/classe para relacionar a coluna do grid.

{% hint style="info" %} <mark style="color:blue;">**Botão F7**</mark>

Apresenta a tela que permite a busca da tabela por global, parte do nome, tabela com log de alteração, tabela já revisada. O resultado será o mesmo (classe).
{% endhint %}

\### Colunas do Grid

***

#### Coluna Destino

Apresenta as propriedades chaves necessárias para vincular com os dados das colunas no grid, para fazer o relacionamento entre a consulta e a nova coluna.

#### Descrição Coluna Destino

Apresenta a descrição das propriedades chaves da coluna destino.

#### Coluna Origem

Informar a coluna relacionada na consulta, ou a variável de contexto da rotina de consulta para fazer o relacionamento entre a consulta e a nova coluna.

### Botões

***

#### Salvar

Salva as informações da tela.

#### Cancelar

Limpa as informações descritas na tela.

#### Manutenção

A coluna **Coluna Origem** é habilitada para alteração dos dados.

#### Revisar Tabela

Apresenta o programa [Revisão da Tabela (CSW1CUSTOM080)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/revisao-da-tabela.md), que permite visualizar o resumo da estrutura da tabela. Além disso, possibilita ajustar ou liberar as propriedades da tabela de acordo com a necessidade do usuário.

#### Testar

Apresenta o programa \_ (CSW1CUSTOM066)\_ para realizar um teste de relacionamento na tabela especificada.

{% hint style="warning" %} <mark style="color:orange;">**Importante**</mark>

Este teste valida se as chaves (keys) informadas no grid encontram correspondência e dados válidos dentro do sistema.
{% endhint %}

\#### Visualizar Query

Apresenta tela para a visualização da instrução SQL (query) gerada. Esta query é responsável pelo relacionamento dos dados e será executada para popular a nova coluna no grid de consulta.

\*\*\*

{% hint style="danger" %} <mark style="color:red;">**Atenção**</mark>

As descrições das principais funcionalidades do sistema estão disponíveis na documentação de [Componentes](/tecnologia/erp/componentes.md).\
A utilização incorreta deste programa pode ocasionar problemas no funcionamento do sistema e nas integrações entre módulos.
{% endhint %}

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# Agent Instructions: 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://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/camada-de-personalizacao/inclusao-de-tabela065.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.
