Conceito de integração

O conceito de Integração refere-se à faculdade de aplicações terceiras poderem através da API consultar, modificar ou inserir dados sobre as várias entidades dos vários módulos. Esta integração beneficia por sua vez do conceito de extensibilidade.

Por exemplo, se através da tecnologia de extensibilidade for adicionada uma regra que valida que o código postal de um cliente tem de estar obrigatoriamente no formato “####-##”, essa regra será executada ao criar a entidade tanto pelo ERP como pela API.

Assim arquitetura da API garante que as regras de negócio associadas a qualquer entidade são executadas independente do cliente que a está a consumir.

Entidades (Business Entities)

Todos os objetos de negócio (ou entidades) geridos por cada modulo são disponibilizados através de objetos simples com um conjunto de propriedades. Assim, estes objetos correspondem ou personificam as várias entidades de negócio do ERP, no limite as tabelas que esta manipula.

A nomenclatura de todos os objetos que representam as entidades é a seguinte {APL}BE{Entidade} onde:

• APL representa a abreviatura do módulo;
• BE representa a abreviatura de Business Entity;
• Entidade representa o nome da entidade.

Por exemplo, a entidade que representa um documento de venda está caracterizada na classe VndBEDocumentoVenda que, por sua vez, tem a sua implementação concreta na assembly VndBEXXX.DLL

Serviços (Business Serviçes)

Os business services correspondem aos objetos que publicam os serviços e métodos disponibilizados por cada entidade. A assembly ErpBSXXX.dll (onde XXX representa a versão) é o ponto de acesso a todos os módulos disponibilizados pela API, pelo que este será o componente a utilizar para aceder à API do ERP a partir de uma aplicação externa.

A nomenclatura de todos os objetos que publicam os serviços é a seguinte I{APL}BS{Entidade} onde:

• APL representa a abreviatura do módulo;
• BS representa a abreviatura de Business Service;
• Entidade representa o nome da entidade.

Por exemplo, a classe IVndBSDocumentoVenda publica todos os serviços associados ao documento de venda, que por sua vez tem a sua implementação concreta na assembly VndBSXXX.DLL