Arquitectura Base - Tablas vs Páginas
Anàlisi exhaustiu del patró MVC en Business Central, diferenciando el model físico de la capa visual y su impacto en datos.
Per intervenir l'ERP i crear fluxos de dades eficients, hem de comprendre íntimament la separació estricta que Microsoft estableix entre l'emmagatzematge de dades (Backend) i la seva presentació (Frontend).
Business Central opera sota un model molt similar al patró MVC (Model-View-Controller). En la nostra terminologia, parlarem del Cerebro (Tablas) i les Ventanas (Pàgines).
1. El “Cerebro”: El Objecte Tabla (Table)
Sección titulada «1. El “Cerebro”: El Objeto Tabla (Table)»Les Taules representen l'estructura física i real de la base de dades (Azure SQL). És l'únic lloc on la informació persisteix. Si una dada no existeix en una Taula, senzillament no existeix al sistema.
1.1. Anatomia d'una Taula
Sección titulada «1.1. Anatomía de una Tabla»En AL, una taula no és només un conjunt de columnes; conté molta lògica de negoci incrustada:
- Campos (fields
): Definen el tipus de dada forta (Text, Code, Decimal, Date, Boolean). - Claves Primàries e Índexs (keys
): Optimitzen les búsquedas SQL. La primera clau (Key) definida en una taula és automàticament la Clau Primària (Clustered Index). - Disparadores (triggers): Lógica que se ejecuta automáticamente a nivel de base de datos (OnInsert, OnModify, OnDelete, OnRename).
- Validaciones de Campo (OnValidate): Lógica que se ejecuta cuando un campo específico cambia de valor. Por ejemplo, al cambiar el “Cód. Cliente”, el sistema busca automáticamente su nombre y lo rellena.
1.2. El concepte de "FlowFields" (Camps Calculats)
Sección titulada «1.2. El concepto de “FlowFields” (Campos Calculados)»Aquest és un concepte crític per a l'Enginyeria de Dades. Alguns camps a les taules NO emmagatzemen dades reals. Són fórmules SQL dinàmiques (FlowFields).
- Ejemplo: El campo “Saldo” del Cliente. No existe en la base de datos como un número fijo. Es un Sum de todos sus movimientos contables.
- Impacto: Los FlowFields son letales para el rendimiento si se extraen masivamente sin precauciones.
2. Las “Ventanas”: El Objeto Página (Page)
Sección titulada «2. Las “Ventanas”: El Objeto Página (Page)»Les Pàgines conformen la capa d'Interfície d'Usuari (UI). No emmagatzemen dades; "treuen el cap" a una taula específica, la llegeixen i renderitzen l'HTML dinàmic al navegador de l'usuari.
2.1. Anatomia d'una Pàgina
Sección titulada «2.1. Anatomía de una Página»- Layout (Diseño visual): Define en qué orden se muestran las columnas, si se agrupan en pestañas (FastTabs), y si son editables o de solo lectura.
- Actions (Botones): La cinta de opciones superior (Ribbon) que permite ejecutar procesos (ej. “Registrar Albarán”, “Imprimir PDF”).
- Disparadores visuales: Acciones de Frontend (OnOpenPage, OnAfterGetRecord) que alteran colores, ocultan campos o dan mensajes emergentes.
2.2. El Paradigma de Múltiples Finestres ("One-to-Many")
Sección titulada «2.2. El Paradigma de Múltiples Ventanas (“One-to-Many”)»Una regla de oro en nuestra arquitectura es que una única Tabla puede tener infinitas Páginas apuntando hacia ella.
- El Origen (Tabla): Tabla 121 (Purch. Rcpt. Line - Líneas de Albarán de Compra).
- Ventana 1 (Estándar): Página 528. Usada por el departamento de Administración, muestra 40 columnas incluyendo cuentas contables y dimensiones.
- Ventana 2 (Custom): Página 50017. Creada a medida para el personal del Almacén, que solo muestra 4 columnas (Artículo, Cantidad, Almacén y Proveedor).
Totes dues llegeixen i escriuen al mateix lloc físic. Modificar una fila a la Finestra 2 actualitza instantàniament el que es veu a la Finestra 1.
2.3. Exemple Pràctic de Codi AL (Model i Vista)
Sección titulada «2.3. Ejemplo Práctico de Código AL (Modelo y Vista)»Aquí podemos ver el contraste directo en código AL entre la definición física de un modelo de datos (table) y su representación visual en 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. Impacte Arquitectònic per a DevSecOps i Data
Sección titulada «3. Impacto Arquitectónico para DevSecOps y Data»Comprendre aquesta separació dicta com hem d'estructurar els nostres desenvolupaments:
- Regla de Extracción de Datos (ETL): Cuando construyamos APIs para Power BI, JAMÁS expondremos una Página. Las Páginas fuerzan al servidor a ejecutar triggers visuales y calcular FlowFields innecesarios, saturando el hilo de ejecución y causando el clásico error “Timeout”. Siempre debemos apuntar a las Tablas directamente usando objetos Query API.
- Regla d'Expansió de l'ERP: Si el negoci ens demana un nou punt d'informació (ex. afegir un camp “Proveïdor Final”), el nostre flux de treball constarà obligatòriament de dos passos separats:
- Ampliar el Cerebro (mediante tableextension).
- Abrir hueco en las Ventanas (mediante pageextension).
4. Criteris d'Arquitectura i Bones Pràctiques
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).

