Extendiendo Tablas (TableExtension)
Creació d'extensions a nivell de base de dades per injectar nous camps físics i modificar el comportament de l'ERP.
El principi de desenvolupament modern en ecosistemes Cloud és la no intrusió. No tenim accés al codi C/AL original de Microsoft, ni volem tenir-lo (trencaria les actualitzacions automàtiques).
Per alterar la base de dades, utilitzem l'objecte tableextension. A nivell del motor SQL, el que Business Central fa per sota és crear una nova taula suplementària amb el nostre prefixe, i el sistema orquestra automàticament un JOIN transparent (1 a 1) cada vegada que es llegeix o escriu un registre.
1. Regles i Limitacions de l'Objecte
Sección titulada «1. Reglas y Limitaciones del Objeto»Abans de programar, hem de conèixer les directrius de seguretat i disseny:
- IDs de Desarrollo: Debemos usar los rangos asignados a nuestra licencia de cliente (normalmente del 50000
al 99999). - Lo que SÍ podemos hacer: Añadir campos nuevos, añadir nuevas claves (keys
), modificar ciertas propiedades de campos estándar (como el Caption). - Lo que NO podemos hacer: Eliminar campos estándar, cambiar el tipo de dato de un campo estándar, o eliminar claves primarias estándar.
2. Desarrollo: Estructura de un tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Suposem un escenari real del nostre entorn: El departament de compres requereix analitzar mètriques basades en el “Proveïdor Final” de la mercaderia, però la taula de recepcions estàndard només registra el distribuïdor logístic.
Vamos a inyectar el campo en la tabla 121 (Purch. Rcpt. Line).
Nombre del archivo: 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'Efecte Immediat (I el que falta)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»En el momento en que guardamos este código y hacemos un despliegue al Sandbox (pulsando F5 o Ctrl+F5 en VS Code), el motor SQL Server altera el esquema físico.
A partir d'aquest segon:
- El campo "Proveedor Final"
existe. - Ocupa espai en disc.
- Puede ser consumido inmediatamente por nuestras APIs (Objetos Query
). - Pot ser utilitzat per qualsevol altra extensió de lògica de codi (Codeunits).
⚠️ La Dada Clandestina: Tanmateix, els treballadors que utilitzen la interfície web de Business Central NO la poden veure ni editar. Físicament hi ha, però visualment no. Per exposar-la als usuaris, hem de crear obligatòriament una extensió de la interfície visual (
pageextension).
4. Checklist de Validació i Desplegament
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ Esquema SQL: Actualización exitosa del esquema en Azure SQL/SQL Server mediante sincronización automática del NST.
- ✓ Cumplimiento GDPR: Clasificación de datos DataClassification
explícita en todos los campos nuevos. - ✓ Rendimiento: Creación de claves secundarias (keys
) para campos indexados de extracción masiva en ETL/Power BI.

