Ir al contenido

테이블 확장(TableExtension)

데이터베이스 수준의 확장을 생성하여 새로운 물리적 필드를 삽입하고 ERP의 동작을 수정하는 방법입니다.

0조회

클라우드 생태계에서 현대적인 개발 원칙은 비침습성입니다. Microsoft의 원본 C/AL 코드에 접근할 수 없으며, 접근하고 싶지도 않습니다(자동 업데이트가 중단될 것입니다).

데이터베이스를 수정하기 위해 tableextension 객체를 사용합니다. SQL 엔진 수준에서 Business Central은 뒤에서 우리 접두사를 사용하는 새로운 보조 테이블을 생성하고, 시스템은 자동으로 JOIN을 투명하게 조율합니다 (1:1).

코딩을 시작하기 전에 보안 및 디자인 지침을 알아야 합니다:

  • 개발 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에 배포(Visual Studio Code에서 F5 또는 Ctrl+F5 클릭)하면 SQL Server 엔진이 물리적 스키마를 변경합니다.

그 순간부터:

  • 필드 "Proveedor Final"가 존재합니다.
  • 디스크 공간을 차지합니다.
  • 즉시 우리의 API(객체 Query)에 의해 사용될 수 있습니다.
  • 다른 모든 코드 논리 확장(Codeunits)에서 사용할 수 있습니다.

⚠️ 은밀한 데이터: 그러나 Business Central 웹 인터페이스를 사용하는 작업자들은 보거나 편집할 수 없습니다. 물리적으로 존재하지만, 시각적으로는 존재하지 않습니다. 사용자에게 노출시키려면 반드시 시각적 인터페이스 확장(pageextension)을 생성해야 합니다.

  • ✓ SQL 스키마: Azure SQL/SQL Server에서 NST의 자동 동기화를 통해 스키마 업데이트 성공.
  • ✓ GDPR 준수: 새로운 모든 필드에서 데이터 분류 DataClassification가 명시적으로 설정됨.
  • ✓ 성능: 대량 추출 ETL/Power BI의 인덱스 필드에 2차 키(keys) 생성.