Ir al contenido

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.

0vues

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).

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.

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 Sum de tous ses mouvements comptables.
  • Impact : Les FlowFields sont fatals pour les performances s'ils sont extraits massivement sans précautions.

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.

  • 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.

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.';
}
}
}
}
}

Comprendre cette séparation dicte comment nous devons structurer nos développements :

  1. 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.
  2. 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).

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 Table et Codeunit ; interface confinée dans les objets Page.
  • ✓ Performance ETL : Exposition exclusive d'objets Query de 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 (tableextension et pageextension).