Ir al contenido

テーブルの拡張(TableExtension)

ERPの動作を変更し、新しい物理フィールドを挿入するためのデータベースレベルの拡張の作成。

0閲覧数

クラウドエコシステムにおける現代開発の原則は非侵襲性です。私たちはマイクロソフトのオリジナルC/ALコードにアクセスしていませんし、それを望んでいません(自動アップデートを破損させるため)

データベースを変更するには、tableextensionオブジェクトを使用します。SQLエンジンレベルでは、Business Centralは私たちの接頭辞を使用して新しい補助テーブルを作成し、システムは自動的にJOINを透過的に実行します(1対1)

1. オブジェクトのルールと制限

Sección titulada «1. Reglas y Limitaciones del Objeto»

プログラミングを行う前に、セキュリティおよびデザインガイドラインを理解する必要があります:

  • 開発ID: 私たちのクライアントライセンスに割り当てられた範囲(通常は50000から99999)を使用する必要があります
  • できること: 新しいフィールドを追加し、新しいキー(keys)を追加し、標準フィールドの特定のプロパティ(例えばCaption)を変更できます
  • できないこと: 標準フィールドを削除し、標準フィールドのデータ型を変更し、または標準プライマリキーを削除することはできません

我々の環境で現実的なシナリオを仮定してみましょう。購買部門は、商品の「最終請負業者」に基づくメトリクスを分析する必要がありますが、標準の受領テーブルにはロジスティクスの請負業者のみが記録されています。

テーブル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)»

このコードを保存し、Sandboxにデプロイする(VS CodeでF5またはCtrl+F5をクリックすると)、SQL Serverのエンジンが物理的なスキーマを変更します。

その瞬間から:

  • フィールド"最終請負業者"が存在します。
  • ディスク容量を占有します。
  • このフィールドはすぐに我々のAPI(Queryオブジェクト)によって利用できます。
  • 他の任意のコードロジック拡張(Codeunits)によって使用できます。

⚠️ 隠れたデータ: ただし、Business CentralのWebインターフェースを使用する従業員は表示や編集ができません。物理的には存在しますが、視覚的には表示されません。ユーザーに表示させるには、必ずしもpageextensionのインターフェース拡張を作成する必要があります。

4. 検証およびデプロイチェックリスト

Sección titulada «4. Checklist de Validación y Despliegue»
  • ✓ SQLスキーマ: NSTの自動同期により、Azure SQL/SQL Serverでスキーマが正常に更新されました。
  • ✓ GDPR準拠: 新規フィールドのデータ分類DataClassificationが明示的に設定されています。
  • ✓ パフォーマンス: ETL/Power BIでの大規模抽出用に、インデックス付きフィールドにセカンダリキー(keys)が作成されています。>