Ir al contenido

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.

0vues

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.

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 le Caption).
  • 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 DataClassification dans tous les nouveaux champs.
  • ✓ Performance : Création de clés secondaires (keys) pour les champs indexés d'extraction massive dans ETL/Power BI.>