Arquitetura Base - Tablas vs Páginas
Análise exaustiva do patrôn MVC em Business Central, diferenciando o modelo físico da capa visual e seu impacto em dados.
Para intervir no ERP e criar fluxos de dados eficientes, devemos compreender intimamente a separação estrita que a Microsoft estabelece entre o armazenamento de dados (Backend) e a sua apresentação (Frontend).
Business Central opera sob um modelo muito semelhante ao patrôn MVC (Model-View-Controller). Em nossa terminologia, falaremos do Cerebro (Tablas) e as Ventanas (Páginas).
1. O "Cerebro": O Objeto Tabela (Table)
Sección titulada «1. El “Cerebro”: El Objeto Tabla (Table)»As Tabelas representam a estrutura física e real da base de dados (Azure SQL). É o único lugar onde a informação persiste. Se um dado não existe numa Tabela, simplesmente não existe no sistema.
1.1. Anatomia de uma Tabela
Sección titulada «1.1. Anatomía de una Tabla»Em AL, uma tabela não é apenas um conjunto de colunas; contém muita lógica de negócio embutida:
- Campos (fields
): Definem o tipo de dado forte (Text, Code, Decimal, Date, Boolean). - Chaves Primárias e Índices (keys
): Optimizam as buscas SQL. A primeira chave (Key) definida em uma tabela é automaticamente a Chave Primária (Clustered Index). - Disparadores (triggers
): Lógica que se executa automaticamente a nível de base de dados (OnInsert, OnModify, OnDelete, OnRename). - Validações de Campo (OnValidate
): Lógica que se executa quando um campo específico muda de valor. Por exemplo, ao mudar o "Cód. Cliente", o sistema busca automaticamente seu nome e o preenche.
1.2. O conceito de "FlowFields" (Campos Calculados)
Sección titulada «1.2. El concepto de “FlowFields” (Campos Calculados)»Este é um conceito crítico para a Engenharia de Dados. Alguns campos nas tabelas NÃO armazenam dados reais. São fórmulas SQL dinâmicas (FlowFields).
- Ejemplo: O campo "Saldo" do Cliente. Não existe na base de dados como um número fijo. É um Sum
de todos seus movimentos contáveis. - Impacto: Os FlowFields são letais para o desempenho se forem extraídos massivamente sem precauções.
2. As "Ventanas": O Objeto Página (Page)
Sección titulada «2. Las “Ventanas”: El Objeto Página (Page)»As Páginas formam a camada de Interface de Utilizador (UI). Não armazenam dados; "espreitam" para uma tabela específica, leem-na e renderizam o HTML dinâmico no navegador do utilizador.
2.1. Anatomia de uma Página
Sección titulada «2.1. Anatomía de una Página»- Layout (Diseño visual): Define em que ordem se mostram as colunas, se se agrupam em pestañas (FastTabs), e se são editáveis ou de só leitura.
- Actions (Botões): A cinta de opções superior (Ribbon) que permite executar processos (ej. "Registrar Albarán", "Imprimir PDF").
- Disparadores visuais: Ações de Frontend (OnOpenPage
, OnAfterGetRecord) que alteram cores, ocultam campos ou dão mensagens emergentes.
2.2. O Paradigma de Múltiplas Janelas ("One-to-Many")
Sección titulada «2.2. El Paradigma de Múltiples Ventanas (“One-to-Many”)»Uma regra de ouro em nossa arquitetura é que uma única Tabela pode ter infinitas Páginas apontando para ela.
- O Origen (Tabela): Tabela 121 (Purch. Rcpt. Line
- Líneas de Albarán de Compra). - Ventana 1 (Estándar): Página 528. Usada pelo departamento de Administração, mostra 40 colunas incluindo contas contábeis e dimensões.
- Ventana 2 (Custom): Página 50017. Criada a medida para o pessoal do Almacém, que só mostra 4 colunas (Artigo, Cantidad, Almacém e Provedor).
Ambas leem e escrevem no mesmo lugar físico. Modificar uma linha na Janela 2 atualiza instantaneamente o que se vê na Janela 1.
2.3. Exemplo Prático de Código AL (Modelo e Vista)
Sección titulada «2.3. Ejemplo Práctico de Código AL (Modelo y Vista)»Aqui podemos ver o contraste direto em código AL entre a definição física de um modelo de dados (table) e sua representação visual em lista (page):
// Definición física en Azure SQL (Model)table 50100 "Portelcore Custom Table"{ Caption = 'Tabla Personalizada Portelcore'; DataClassification = CustomerContent;
fields { field(1; "Id Registro"; Code[20]) { Caption = 'Id Registro'; } field(2; Descripcion; Text[100]) { Caption = 'Descripción'; } }
keys { key(PK; "Id Registro") { Clustered = true; } }}
// Representación visual en la UI (View)page 50100 "Portelcore Custom Page"{ PageType = List; SourceTable = "Portelcore Custom Table"; Caption = 'Lista Personalizada Portelcore'; ApplicationArea = All; UsageCategory = Lists;
layout { area(content) { repeater(Group) { field("Id Registro"; Rec."Id Registro") { ApplicationArea = All; ToolTip = 'Identificador único del registro.'; } field(Descripcion; Rec.Descripcion) { ApplicationArea = All; ToolTip = 'Descripción detallada.'; } } } }}3. Impacto Arquitetônico para DevSecOps e Data
Sección titulada «3. Impacto Arquitectónico para DevSecOps y Data»Compreender esta separação dita como devemos estruturar os nossos desenvolvimentos:
- Regra de Extração de Dados (ETL): Quando construirmos APIs para Power BI, JAMÁS exporemos uma Página. As Páginas forçam o servidor a executar disparadores visuais e calcular FlowFields innecesários, saturando o hilo de execução e causando o clássico erro "Timeout". Se sempre devemos apontar para as Tablas diretamente usando objetos Query API
. - Regra de Expansão do ERP: Se o negócio nos pedir um novo ponto de informação (por exemplo, adicionar um campo 'Fornecedor Final'), nosso fluxo de trabalho constará obrigatoriamente de dois passos separados:
- Ampliar el Cerebro (mediante tableextension).
- Abrir hueco en las Ventanas (mediante pageextension).
4. Critérios de Arquitetura e Boas Práticas
Sección titulada «4. Criterios de Arquitectura y Buenas Prácticas»- ✓ Separación Estricta: Lógica de negocio encapsulada en objetos Table y Codeunit; interfaz confinada en objetos Page.
- ✓ Rendimiento ETL: Exposición exclusiva de objetos Query de tipo API para extracciones hacia Power BI, evitando las penalizaciones de los FlowFields de páginas.
- ✓ Extensibilidad: Modificación del modelo estándar de Microsoft mediante extensiones desacopladas (tableextension y pageextension).

