Ir al contenido

Расширение таблиц (TableExtension)

Создание расширений на уровне базы данных для внедрения новых физических полей и изменения поведения ERP.

0просмотры

Принцип современной разработки в облачных экосистемах — отсутствие вторжения. У нас нет доступа к исходному коду 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.