---
title: Objeto de Negócio
slug: builder/objeto-de-negocio
description: Learn how to create and configure a business object in a Builder application with this comprehensive guide. Discover the step-by-step process, from filling in identification and database details to defining relationships and assigning business rules. You'
createdAt: 2021-10-01T18:55:10.000Z
---

Objetos de Negócios são os vínculos entre o **Builder&#x20;**&#x65; uma **Entidade de Dados das aplicações**. Desta forma, o Objeto de Negócio representará o modelo de dados e poderá atingir um ou mais formulários.&#x20;

Cada objeto de negócio criado representa uma tabela no banco de dados.

## Antes de começar

- [x] É necessário ter criado a **Conexão de Banco de Dados** e a **Aplicação Builder**.&#x20;

## Dados Gerais

1. Acesse a funcionalidade pelo menu de navegação `Builder > Gerenciamento >    Objeto de Negócio`;
2. Clique em “**Cadastrar**”;
3. Preencha os campos disponíveis na guia “**Identificação**”;
4. Selecione a **Aplicação** para a qual o objeto de negócio é criado, atribua   &#x20;ao Objeto de Negócio um Nome e uma Descrição, também informe a finalidade do   &#x20;Objeto de Negócio.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/vgSkMd_DyPe0oG88AOnBs_image.png "Figura 1 - Identificação")

### Informação do Banco de Dados

Preencha os campos disponíveis para a guia "**Banco de dados**". Essa guia faz&#x20;referência à estrutura do banco de dados da aplicação. Como cada objeto de&#x20;negócio representa uma tabela de banco de dados, essa guia define as colunas&#x20;do banco, bem como seus relacionamentos, regras de negócio e comandos SQL&#x20;(se necessário).

1. Preencha as informações com:
   - A Conexão de Banco criada,
   - O Nome do Esquema de banco de dados,
   - O Tipo, se é tabela ou view, e
   - O Nome no Banco de Dados do objeto de negócio.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-_uw4pZDZ2fH5GLnJsmTu_image.png "Figura 2 - Banco de dados")

### Colunas

1. Adicione as colunas da tabela, indicando:
   1. Informe o **nome da coluna na BD**;
   2. Selecione o **Tipo** **da Coluna**. O sistema fará a correlação      &#x20;automaticamente para o **Tipo no BD**;
   3. Dê o **Nome para atributo de objeto**, se você não mudar, terá o mesmo      &#x20;nome que o nome da coluna;
   4. Configure a **Label** para o formulário e a grid;
   5. Selecione a **Chave primária** se a coluna é a Chave primária para a      &#x20;tabela;
   6. Selecione **Obrigatório** se a coluna for obrigatória;
   7. Clique em “**Salvar**”.

:::hint{type="info"}
🖊 <u>**Nota**</u>**:&#x20;**&#x41;pós o "**Salvar**", você poderá informar a chave do domínio e digitar e atribuir o relacionamento, se necessário.
:::

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/aXpIqA3KmH52pYew7gIiU_image.png "Figura 3 - Lista de colunas")

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/tavQ44g_qdQSnV3KHUQvx_image.png "Figura 4 - Adicionar novas colunas")

:::hint{type="info"}
🖊 <u>**Nota**</u>**:&#x20;**&#x45;m cada mudança de banco de dados ou no momento da criação do objeto de negócio, você deve executar o DDL correspondente para executar a criação/mudança no Banco de Dados.
:::

### Relação

1. Se necessário, você pode adicionar Relações nessa guia;
2. Defina:
   1. **Tipo** (1 x N, N x 1);
   2. Informe o **nome da Relação** e da **Label** (para o formulário);
   3. O **objeto Referenciado** que será vinculado;
   4. A **Coluna para preenchimento automático**;
   5. Configure se é um campo **Obrigatório**;
   6. Uso de **Delegação** quando você quiser usar conceitos de      &#x20;Generalização/Especialização para o Relacionamento;
   7. Configure se a Coluna de objeto de negócio fará parte do relacionamento

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-sR4GWMnSHs_Lj7qte7cZ_image.png "Figura 5 - Relação")

### Regras de Negócio

Selecione a Regra de Negócio atribuída para inserir, alterar ou excluir a ação no Objeto de Negócio

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/YqvIQ7bze53Mq2M8JRY7G_image.png "Figura 6 - Regras de Negócio")

### SQLs

Você pode criar SQL's relacionados ao objeto de negócio a ser usado no&#x20;fluxo, por exemplo:

- Em uma tarefa para solicitação de inscrição em cursos, você pode criar  &#x20;um SQL (será considerado como uma função) para obter o número de alunos  &#x20;matriculados em um curso;
- O SQL será executado sob um fluxo ESI e será chamado pelo Fluxo SM  &#x20;(usando o componente para integração com o fluxo ESI).

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4cJ8FMmnRzx7wLj62bGWL_image.png "Figura 7 - SQL")

### Formulário (CRUD & Personalizável)

Você pode alterar as labels de atributos por meio da guia Labels e editar os campos da grid usando a guia Grid.

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

Ao clicar em "**Editar formulário**" no cabeçalho da tela, gerará um formulário para esse objeto de negócio. Se não houver um formulário para esse objeto de negócio, a barra lateral Campos será exibida. Se já houver um formulário registrado anteriormente vinculado a este formulário, a guia Desenhar Tela para este formulário será aberta.





