--- title: Objeto de Negócio slug: low-code/objeto-de-negocio description: This document provides a comprehensive guide on creating and utilizing Business Objects as database resources. Learn how to connect with the database, perform CRUD operations, and communicate through database connections and API REST calls. Explore step-b createdAt: 2023-08-24T13:00:46.891Z --- O Objeto de Negócio é um recurso de abstração do Banco de Dados. O Objeto de Negócio representará o modelo de dados e poderá atingir um ou mais formulários. Cada objeto de negócio criado representa uma tabela no banco de dados. Essa é a camada da aplicação é responsável em se conectar com o Banco de Dados, que irá consultar, gravar, alterar e deletar dados (CRUD). A comunicação do OBJETO DE NEGÓCIO se dá pela CONEXÃO DE BASE DE DADOS e a comunicação com o formulário se dá pelas chamadas do tipo API REST, enviando e recebendo dados no formato JSON ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/cKvKHbXs_8gg6-4XaCeFJ_image.png) A criação de um **OBJETO DE NEGÓCIO** possui três grupos informações: **Identificação, Banco de Dados e Formulário.** ## Passo a passo ::::WorkflowBlock :::WorkflowBlockItem Acesse a funcionalidade pelo menu de navegação `Low Code > Gerenciamento > Objeto de Negócio`; ::: :::WorkflowBlockItem Clique em “**Criar**”; ::: :::WorkflowBlockItem Preencha os campos disponíveis na guia “**Identificação**”; ::: :::WorkflowBlockItem Selecione o **Projeto **para a qual o objeto de negócio é criado, atribua ao Objeto de Negócio um **Nome **e uma **Descrição**, também informe o **Propósito** do Objeto de Negócio. ::: :::: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/sjwxpLKIshNAZBccUneQ8_image.png) ### Informação do Banco de Dados ::::WorkflowBlock :::WorkflowBlockItem Preencha os campos disponíveis para a guia "**Banco de dados**". Essa guia faz referência à estrutura do banco de dados da aplicação. Como cada objeto de negócio representa uma tabela de banco de dados, essa guia define as colunas do banco, bem como seus relacionamentos, regras de negócio e comandos SQL (se necessário). ::: :::WorkflowBlockItem Na guia **Banco de Dados** é obrigatório selecionar a **CONEXÃO DE BANCO**, o tipo (nesse exemplo é uma tabela) e nome que irá se chamar a tabela no banco de dados. ::: :::WorkflowBlockItem Preencha as informações com: 1. A Conexão de Banco criada, 2. O Tipo, se é tabela ou view, e 3. O Nome no Banco de Dados do objeto de negócio (**O nome da tabela**). ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/5_NYVDVFEXTOQ2b-CUNRw_image.png) ::: :::: ### Colunas :::::WorkflowBlock :::WorkflowBlockItem Ainda no **Banco de Dados **é importante adicionar campos. Caso a tabela já exista no banco de dados, pode-se utilizar a opção: **Buscar colunas do BD**. Nesse caso tem que fornecer o nome da tabela no banco de dados. ::: ::::WorkflowBlockItem 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 automaticamente para o **Tipo no BD**; 3. Dê o **Nome para atributo de objeto**, se você não mudar, terá o mesmo 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 tabela; 6. Selecione **Obrigatório** se a coluna for obrigatória; 7. Clique em “**Salvar**”. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/8dN_XwgFqHBcJzYPw0hfZ_image.png) :::hint{type="info"} 🖊 **Nota****: **Após o "**Salvar**", você poderá informar a chave do domínio, se houver e digitar e atribuir o relacionamento, se necessário. ::: :::: ::::WorkflowBlockItem Após criados os campos é só salvar e executar o DDL para que a tabela seja criada no banco de dados, caso ainda ela não exista no Banco de Dados. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/C9k9Y4n07iMEo_6d8qwQz_image.png) :::hint{type="info"} 🖊 **Nota****: **Após a execução da DDL para criação da tabela e campos, a cada inclusão/exclusão pontual de campos, você deve executar o DDL correspondente para executar a criação/mudança no Banco de Dados. ::: :::: ::::: ### Relacionamentos ::::::WorkflowBlock :::WorkflowBlockItem Se necessário, você pode adicionar Relações nessa guia; ::: :::::WorkflowBlockItem Cique em** “Adicionar”** e 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 Generalização/Especialização para o Relacionamento; ::::LinkArray :::LinkArrayItem ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/yYyHl3Dx40C9o1NH19I70_image.png) ::: :::LinkArrayItem ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/xyA94K5PFpNYJL81wEw4G_image.png) ::: :::: ::::: :::::: ## Regras de Negócio Você também adicionar **REGRAS DE NEGÓCIO** nas ações de inclusão, atualização ou exclusão de registros na entidade de dados. Você poderá vincular essas Regras ao Objeto de Negócio, através da inclusão de Dependências disponível no Formulário. Selecione a Regra de Negócio para o tipo de ação que deseja atribuir. A regra pode existir na Inclusão, na Alteração ou exclusão na ação no Objeto de Negócio. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/lSbi-pynfiG1Vg_f-e8YZ_image.png) ### Criando Regras de Negócio Para criação de uma Regra de Negócio é obrigatório fornecer um Nome, uma Descrição, Tipo e o nome do Projeto. Exemplo de uma regra de negócio que valida uma informação: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/KaeWd5iKEp8AmFKDPpIlk_image.png) ### SQLs Você pode criar SQL's relacionados ao objeto de negócio a ser usado no projeto, por exemplo: Em uma situação para consultar um grupo de registros, você pode criar um SQL (será considerado como uma função) para obter esses conjuntos de registros que necessita, passando paramentos na consulta ${valor}. Para incluir um SQL clique em “**Adicionar**” ::::LinkArray :::LinkArrayItem ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/OptTCpCwM79AoEMI9qRjf_image.png) ::: :::LinkArrayItem ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/3iP7IiU4XYQJylyt0iUdb_image.png) ::: :::: ## Formulário (CRUD & Personalizável) Na guia formulários temos várias opções: Labels, Grid, Desenho de Tela, Html, Controler e Dependências, que tratam exclusivamente dos recursos utilizados no formulário. Cada item pode ser explorado em cursos específicos de manipulação da ferramenta. Vamos abordar apenas a Grid e o Desenho de tela. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Xlggrad2cUWJ5jfbdqr6W_image.png) Em Grid podemos adicionar os campos que queremos que seja exibido. Selecione os campos e clique em **“Incluir selecionados”**. É possível adicionar todos os campos de uma vez ou selecionar itens que serão inclusos. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/6rqS4UYhHe097QCikBgdg_image.png) No Desenho de tela é onde vamos escolher os campos para serem adicionados no formulário, como objeto do tipo input, por exemplo. Igual à grid, podemos adicionar todos ou selecionar itens que serão incluídos. ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bOJjhjDqLFVB6ocmAciDb_image.png) A cada etapa clique em **Salvar **e por último **Salvar **no** OBJETO DE NEGÓCIO**.