Расширение таблиц (TableExtension)
Создание расширений на уровне базы данных для внедрения новых физических полей и изменения поведения ERP.
Принцип современной разработки в облачных экосистемах — отсутствие вторжения. У нас нет доступа к исходному коду C/AL от Microsoft, и мы не хотим его иметь (это бы нарушило автоматические обновления).
Чтобы изменить базу данных, мы используем объект tableextension. На уровне движка SQL то, что делает Business Central на заднем плане, - это создание новой вспомогательной таблицы с нашим префиксом, и система автоматически оркестрирует прозрачное сопоставление (1 к 1) каждый раз, когда читается или записывается запись.
1. Правила и ограничения объекта
Sección titulada «1. Reglas y Limitaciones del Objeto»Перед программированием мы должны знать руководящие принципы безопасности и проектирования:
- Идентификаторы разработки: Мы должны использовать диапазоны, назначенные нашей лицензии клиента (обычно от
50000до99999). - То, что мы МОЖЕМ делать: Добавлять новые поля, добавлять новые ключи (
keys), изменять определенные свойства стандартных полей (например,Caption). - То, что мы НЕ можем делать: Удалять стандартные поля, изменять тип данных стандартного поля или удалять стандартные первичные ключи.
2. Разработка: Структура tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Предположим, что у нас есть реальный сценарий в нашей среде: департамент закупок требует анализа метрик на основе «Финального поставщика» товаров, но стандартная таблица регистраций поставок учитывает только логистического дистрибьютора.
Мы собираемся внедрить поле в таблицу 121 (Purch. Rcpt. Line).
Имя файла: 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. Немедленный эффект (и то, что осталось)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»В момент сохранения этого кода и его развертывания в песочнице (нажав F5 или Ctrl+F5 в VS Code) движок SQL Server изменяет физическую схему.
С этого момента:
- Поле
"Proveedor Final"существует. - Оно занимает место на диске.
- Может быть немедленно потреблено нашими API (Объекты
Query). - Оно может быть использовано любой другой расширением логики кода (Codeunits).
⚠️ Секретные Данные: Однако, работники, которые используют веб-интерфейс Business Central не могут видеть и редактировать. Физически он есть, но визуально нет. Чтобы раскрыть его пользователям, нам необходимо создать обязательное расширение визуального интерфейса (
pageextension).
4. Контрольный список проверки и развертывания
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ Схема SQL: Успешное обновление схемы в Azure SQL/SQL Server с помощью автоматической синхронизации NST.
- ✓ Соблюдение GDPR: Явная классификация данных
DataClassificationво всех новых полях. - ✓ Производительность: Создание вторичных ключей (
keys) для индексированных полей массового извлечения в ETL/Power BI.

