테이블 확장(TableExtension)
데이터베이스 수준의 확장을 생성하여 새로운 물리적 필드를 삽입하고 ERP의 동작을 수정하는 방법입니다.
클라우드 생태계에서 현대적인 개발 원칙은 비침습성입니다. Microsoft의 원본 C/AL 코드에 접근할 수 없으며, 접근하고 싶지도 않습니다(자동 업데이트가 중단될 것입니다).
데이터베이스를 수정하기 위해 tableextension 객체를 사용합니다. SQL 엔진 수준에서 Business Central은 뒤에서 우리 접두사를 사용하는 새로운 보조 테이블을 생성하고, 시스템은 자동으로 JOIN을 투명하게 조율합니다 (1:1).
1. 개체 규칙 및 제한 사항
Sección titulada «1. Reglas y Limitaciones del Objeto»코딩을 시작하기 전에 보안 및 디자인 지침을 알아야 합니다:
- 개발 ID: 고객 라이선스에 할당된 범위를 사용해야 합니다 (보통
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)»이 코드를 저장하고 Sandbox에 배포(Visual Studio Code에서 F5 또는 Ctrl+F5 클릭)하면 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가 명시적으로 설정됨. - ✓ 성능: 대량 추출 ETL/Power BI의 인덱스 필드에 2차 키(
keys) 생성.

