# Aba Tabelas Relacionadas

### Pré-Requisitos

***

O acesso à Camada de Personalização é 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**.\
Esta aba será habilitada se no momento do acesso for selecionada a opção *A Partir de uma Tabela (Relacionamento)*

### Acesso

***

Módulo: Componentes\
Grupo: Camada de Personalização\
[Painel de Consultas (CSW1CUSTOM100)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/painel-de-consultas.md)\
Botão **+Criar Nova Consulta** - Opção *A Partir de uma Tabela (Relacionamento)* ou *A Partir de uma Query SQL Existente*\
[Configuração da Consulta (CSW1CUSTOM601)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta.md)

### Visão Geral

***

O objetivo deste programa é permitir ao usuário definir as amarrações com outras tabelas. Cada relacionamento que é habilitado carrega novas colunas [Aba Colunas (CSW1CUSTOM601TAB1)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/configuracao-da-consulta/aba-colunas.md). Com isso, vários relacionamentos são adicionados de forma automática, mas o usuário pode adicionar manualmente um relacionamento clicando no **Adicionar Tabela**.

### Colunas do Grid

***

#### Relacionamento

Exibe a ordem de relacionamento vinculado a outras tabelas do sistema e suas amarrações. É possível acessar as informações acionando o botão do [TreeView](/glossario/treeview.md).

#### Habilitado

Marcar a opção para selecionar qual a tabela terá relacionamento apresentado na consulta.

#### Editar

Apresenta o programa [Inclusão de Tabela (CSW1CUSTOM603)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/inclusao-de-tabela603.md) para inclusão e relacionamento de nova tabela.

#### Descrição

Exibe a descrição da tabela.

#### Tabela

Exibe a tabela/classe que foi criada a consulta. o hiperlink apresenta o programa [Revisão da Tabela (CSW1CUSTOM080)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/revisao-da-tabela.md) para revisão da tabela.

#### Campo

Exibe o nome do campo na tabela principal/relacionada usado para a ligação.

#### Descrição do Campo

Exibe a descrição do campo utilizado no relacionamento.

#### Global

Exibe a global e as chaves (IdKey) da global.

#### Origem

Exibe a origem do relacionamento se é automático ou manual.

#### Obrigatório

Permite indicar se o sistema vai trazer apenas os registros que existem em abas de tabelas.

{% hint style="success" %} <mark style="color:green;">**Exemplo**</mark>

Na tabela de pedidos, caso tenha relacionamento com a tabela de usuários do cancelamento, se essa relação for definida como obrigatória, apenas os pedidos que foram cancelados aparecerão. Se, por outro lado, a relação não for obrigatória, todos os pedidos serão exibidos, mas a coluna correspondente ao usuário responsável pelo cancelamento permanecerá vazia nos casos em que não houver cancelamento.
{% endhint %}

\### Botões

***

#### Adicionar Tabela

Apresenta o programa [Inclusão de Tabela (CSW1CUSTOM603)](/modulos/componentes/manuais-de-telas/camada-de-personalizacao/inclusao-de-tabela603.md) para inclusão de nova tabela.

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

O sistema pedirá a tabela necessária para estabelecer o relacionamento e, em seguida, solicitará os campos para a comparação de dados. Embora o sistema possa sugerir relacionamentos entre os campos, isso não acontece sempre, nessa situação, o usuário deverá fazê-lo manualmente.
{% endhint %}

\*\*\*

{% 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/configuracao-da-consulta/aba-tabelas-relacionadas.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.