Architecture de base - Tables vs Pages
Analyse approfondie du modèle MVC dans Business Central, différenciant le modèle physique de la couche visuelle et son impact sur les données.
Pour intervenir sur l'ERP et créer des flux de données efficaces, nous devons comprendre intimement la séparation stricte que Microsoft établit entre le stockage des données (Backend) et leur présentation (Frontend).
Business Central fonctionne selon un modèle très similaire au pattern MVC (Modèle-Vue-Contrôleur). Dans notre terminologie, nous parlerons du Cerveau (Tables) et des Fenêtres (Pages).
1. Le « Cerveau » : l'objet Table (Table)
Sección titulada «1. El “Cerebro”: El Objeto Tabla (Table)»Les Tables représentent la structure physique et réelle de la base de données (Azure SQL). C'est le seul endroit où l'information persiste. Si une donnée n'existe pas dans une Table, elle n'existe tout simplement pas dans le système.
1.1. Anatomie d'une Table
Sección titulada «1.1. Anatomía de una Tabla»En AL, une table n'est pas seulement un ensemble de colonnes ; elle contient beaucoup de logique métier intégrée :
- Champs (
fields): Définissent le type de données fort (Texte, Code, Décimal, Date, Booléen). - Clés primaires et index (
keys): Optimisent les recherches SQL. La première clé (Key) définie dans une table est automatiquement la clé primaire (Clustered Index). - Déclencheurs (
triggers): Logique qui s'exécute automatiquement au niveau de la base de données (OnInsert,OnModify,OnDelete,OnRename). - Validations de champ (
OnValidate): Logique qui s'exécute lorsqu'un champ spécifique change de valeur. Par exemple, en modifiant le « Code client », le système recherche automatiquement son nom et le remplit.
1.2. Le concept de « FlowFields » (Champs Calculés)
Sección titulada «1.2. El concepto de “FlowFields” (Campos Calculados)»C'est un concept critique pour l'Ingénierie des Données. Certains champs dans les tables NE stockent PAS de données réelles. Ce sont des formules SQL dynamiques (FlowFields).
- Exemple : Le champ « Solde » du client. Il n'existe pas dans la base de données comme un nombre fixe. C'est un
Sumde tous ses mouvements comptables. - Impact : Les FlowFields sont fatals pour les performances s'ils sont extraits massivement sans précautions.
2. Les « Fenêtres » : L'objet Page (Page)
Sección titulada «2. Las “Ventanas”: El Objeto Página (Page)»Les Pages constituent la couche d'Interface Utilisateur (UI). Elles ne stockent pas de données ; elles « regardent » une table spécifique, la lisent et rendent le HTML dynamique dans le navigateur de l'utilisateur.
2.1. Anatomie d'une Page
Sección titulada «2.1. Anatomía de una Página»- Layout (Mise en page visuelle) : Définit l'ordre dans lequel les colonnes sont affichées, si elles sont regroupées en onglets (FastTabs), et si elles sont modifiables ou en lecture seule.
- Actions (Boutons) : Le ruban supérieur (Ribbon) qui permet d'exécuter des processus (ex. « Enregistrer le bon de livraison », « Imprimer PDF »).
- Déclencheurs visuels : Actions Frontend (
OnOpenPage,OnAfterGetRecord) qui modifient les couleurs, masquent des champs ou affichent des messages contextuels.
2.2. Le Paradigme des Fenêtres Multiples (« One-to-Many »)
Sección titulada «2.2. El Paradigma de Múltiples Ventanas (“One-to-Many”)»Une règle d'or de notre architecture est qu'une seule Table peut avoir une infinité de Pages pointant vers elle.
- La Source (Table) : Table 121 (
Purch. Rcpt. Line- Lignes de bon de réception d'achat). - Fenêtre 1 (Standard) : Page 528. Utilisée par le département Administration, elle affiche 40 colonnes, y compris les comptes comptables et les dimensions.
- Fenêtre 2 (Personnalisée) : Page 50017. Créée sur mesure pour le personnel de l'entrepôt, elle n'affiche que 4 colonnes (Article, Quantité, Entrepôt et Fournisseur).
Les deux lisent et écrivent au même endroit physique. Modifier une ligne dans la Fenêtre 2 met à jour instantanément ce qui est visible dans la Fenêtre 1.
2.3. Exemple Pratique de Code AL (Modèle et Vue)
Sección titulada «2.3. Ejemplo Práctico de Código AL (Modelo y Vista)»Ici, nous pouvons voir le contraste direct en code AL entre la définition physique d'un modèle de données (table) et sa représentation visuelle sous forme de liste (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. Impact Architectural pour DevSecOps et Data
Sección titulada «3. Impacto Arquitectónico para DevSecOps y Data»Comprendre cette séparation dicte comment nous devons structurer nos développements :
- Règle d'extraction de données (ETL) : Lorsque nous construisons des API pour Power BI, nous n'exposerons JAMAIS une Page. Les Pages forcent le serveur à exécuter des déclencheurs visuels et à calculer des FlowFields inutiles, saturant le thread d'exécution et provoquant l'erreur classique de « Timeout ». Nous devons toujours pointer directement vers les Tables en utilisant les objets
Query API. - Règle d'expansion de l'ERP : Si l'entreprise nous demande un nouveau point d'information (par exemple, ajouter un champ « Fournisseur final »), notre flux de travail comportera obligatoirement deux étapes distinctes :
- Étendre le Cerveau (via
tableextension). - Créer de l'espace dans les Fenêtres (via
pageextension).
- Étendre le Cerveau (via
4. Critères d'architecture et bonnes pratiques
Sección titulada «4. Criterios de Arquitectura y Buenas Prácticas»- ✓ Séparation Stricte : Logique métier encapsulée dans les objets
TableetCodeunit; interface confinée dans les objetsPage. - ✓ Performance ETL : Exposition exclusive d'objets
Queryde type API pour les extractions vers Power BI, évitant les pénalités des FlowFields de pages. - ✓ Extensibilité : Modification du modèle standard de Microsoft via des extensions découplées (
tableextensionetpageextension).

