Extension de tableaux (TableExtension)
Création d'extensions au niveau de la base de données pour injecter de nouveaux champs physiques et modifier le comportement de l'ERP.
Le principe du développement moderne dans les écosystèmes Cloud est la non-intrusion. Nous n'avons pas accès au code C/AL original de Microsoft, et nous ne le voulons pas (cela casserait les mises à jour automatiques).
Pour modifier la base de données, nous utilisons l'objet tableextension. Au niveau du moteur SQL, ce que Business Central fait en arrière-plan est de créer une nouvelle table supplémentaire avec notre préfixe, et le système orchestre automatiquement un JOIN transparent (1 pour 1) chaque fois qu'un enregistrement est lu ou écrit.
1. Règles et Limites de l'Objet
Sección titulada «1. Reglas y Limitaciones del Objeto»Avant de programmer, nous devons connaître les directives de sécurité et de conception :
- IDs de développement : Nous devons utiliser les plages assignées à notre licence client (généralement de
50000à99999). - Ce que nous POUVONS faire : Ajouter de nouveaux champs, ajouter de nouvelles clés (
keys), modifier certaines propriétés de champs standard (comme leCaption). - Ce que nous NE POUVONS PAS faire : Supprimer des champs standard, changer le type de données d'un champ standard ou supprimer des clés primaires standard.
2. Développement : Structure d'un tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Supposons un scénario réel de notre environnement : Le département des achats doit analyser des métriques basées sur le « Fournisseur Final » de la marchandise, mais la table des réceptions standard n'enregistre que le distributeur logistique.
Nous allons injecter le champ dans la table 121 (Purch. Rcpt. Line).
Nom du fichier : Tab-Ext50100.PurchRcptLineExt.al
// 1. Declaración: ID libre, Nombre de la extensión, y la tabla base que extendemos.tableextension 50100 "Portelcore PurchRcptLine Ext" extends "Purch. Rcpt. Line"{ fields { // 2. Creación del nuevo campo físico. ID libre y Tipo de dato (Texto de 100 caracteres). field(50100; "Proveedor Final"; Text[100]) { // PROPIEDADES DEL CAMPO
// Etiqueta visual que verán los usuarios y sistemas externos Caption = 'Proveedor Final';
// DataClassification (GDPR): Obligatorio declarar qué tipo de información guardamos. // Posibles valores: CustomerContent, EndUserIdentifiableInformation, SystemMetadata, etc. DataClassification = CustomerContent;
// Descripción técnica para otros desarrolladores Description = 'Registra el fabricante real de la materia prima, no el distribuidor intermediario.';
// LÓGICA DE NEGOCIO Y EVENTOS trigger OnValidate() begin // Se ejecuta cada vez que el valor cambia y es aceptado. // Aquí podríamos llamar a funciones de validación compleja o cruzar con otras tablas. if Rec."Proveedor Final" = '' then Message('Aviso DevSecOps: Se recomienda encarecidamente registrar el proveedor final para Power BI.'); end; } }
// 3. OPTIMIZACIÓN (Índices SQL) keys { // Si prevemos que Power BI o el ERP filtrarán masivamente por este campo, // debemos crear una clave secundaria (Non-Clustered Index) en SQL. key(Key_ProvFinal; "Proveedor Final") { } }}3. L'Effet Immédiat (Et ce qu'il manque)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»Dès que nous enregistrons ce code et que nous effectuons un déploiement vers le Sandbox (en appuyant sur F5 ou Ctrl+F5 dans VS Code), le moteur SQL Server modifie le schéma physique.
À partir de cette seconde :
- Le champ
"Proveedor Final"existe. - Il occupe de l'espace disque.
- Il peut être immédiatement consommé par nos API (Objets
Query). - Il peut être utilisé par toute autre extension de logique de code (Codeunits).
⚠️ La donnée clandestine : Cependant, les employés utilisant l'interface web de Business Central ne peuvent ni la voir ni la modifier. Physiquement, elle est là, mais visuellement non. Pour l'exposer aux utilisateurs, nous devons obligatoirement créer une extension de l'interface visuelle (
pageextension).
4. Liste de Contrôle de Validation et de Déploiement
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ Schéma SQL : Mise à jour réussie du schéma sur Azure SQL/SQL Server via la synchronisation automatique du NST.
- ✓ Conformité RGPD : Classification explicite des données
DataClassificationdans tous les nouveaux champs. - ✓ Performance : Création de clés secondaires (
keys) pour les champs indexés d'extraction massive dans ETL/Power BI.>

