AL 및 환경 소개
Application Language (AL)의 심층적 기초, 하부 아키텍처, 그리고 VS Code 및 테넌트의 고급 설정.
우리의 DevSecOps 및 데이터 엔지니어링 문화에서는 ERP 시스템(Dynamics 365 Business Central과 같은)을 “블랙박스”나 단순한 웹 인터페이스로 취급하는 것을 멈추는 것이 필수적입니다. 최대 성능을 끌어내고 핵심 수준에서 시스템을 맞춤 설정하려면, 소스 코드 수준으로 내려가 그 하부 아키텍처를 이해해야 합니다.
1. AL (Application Language)이란 무엇인가?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL은 구조적이고 선언적이며 강력한 타입(strongly typed)을 가진 프로그래밍 언어입니다. Microsoft에서 Business Central의 비즈니스 로직과 데이터 모델을 확장하기 위해 독점적으로 설계했습니다(기존의 C/AL을 대체).
AL을 사용하는 작업은 인프라스트럭처 오브 코드(IaC) (Terraform이나 Ansible과 같은)와 매우 유사합니다. 우리는 인터페이스에서 데이터베이스를 클릭하여 수정하지 않고, 텍스트 파일 (.al)에서 데이터베이스(테이블), 논리(코드 유닛), 인터페이스(페이지), API(쿼리)를 정의합니다.
이러한 코드는 나중에 패키지 또는 확장 (.app)로 컴파일되고 서버에 배포됩니다. 마이크로소프트는 표준 코드베이스를 변경하는 것을 허용하지 않습니다. 모든 프로그램은 ERP에 대한 "추가 계층"(확장)로 작동하여 계층 구조에 결합됩니다.
2. 하부 아키텍처 (NST 및 SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»효율적으로 프로그래밍하려면 Business Central이 우리의 명령을 어떻게 처리하는지 이해해야 합니다:
- 데이터 계층: 아래에는 마이크로소프트 SQL Server (Azure SQL로 클라우드 환경에서 사용)가 있습니다.
- 애플리케이션 계층 (NST): Navision Server Tier는 "마인드"입니다. AL 코드를 SQL 쿼리로 변환하고 사용자에게 보이는 HTML/JSON 또는 API로 렌더링하는 "마인드"입니다. 이것을 이해하는 것은 NST의 메모리 오버로드를 피하기 위한 것입니다.
로컬에서 개발하지만, 클라우드의 Sandbox 환경과 컴파일합니다. 이는 우리의 기본 설정입니다:
- Visual Studio Code (VS Code): 우리의 통합 개발 환경(IDE)입니다.
- 확장 기능 “AL Language” (Microsoft): 컴파일러, 자동 완성(IntelliSense), 디버깅 도구 및 테넌트 연결을 제공합니다.
- (추천되는 선택 사항) 확장 기능 “AL Object Designer”: Microsoft의 기본 테이블을 탐색하고 표준 필드 이름을 확인하는 데 매우 유용한 시각적 탐색기입니다.
3.2. 프로젝트 초기화 ("스캐폴딩")
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»새로운 프로젝트를 만들려면 VS Code의 명령 팔레트(Ctrl + Shift + P)를 열고 AL: Go!을 실행합니다. 설치 프로그램이 다음을 요청할 것입니다:
- 프로젝트를 저장할 로컬 경로.
- 배포 목적지: 항상 “Microsoft cloud sandbox”를 선택할 것입니다 (개발 단계에서는 절대 Production 사용하지 마세요).
이것은 .vscode 폴더와 launch.json 파일을 포함한 기본 구조를 생성할 것입니다. 그리고 루트 파일 app.json도 포함됩니다.
4. 경로 설정 및 연결 (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»파일 .vscode/launch.json는 우리와 마이크로소프트 서버 사이의 연결고리입니다. 여기서 느슨한 설정은 연결 및 배포 오류의 주요 원인입니다.
우리는 극도로 정확하게 설정해야 하며, default와 같은 일반적인 값은 피해야 합니다.
{ "version": "0.2.0", "configurations": [ { "name": "Conexión a Sandbox PORTELCORE", "request": "launch", "type": "al", "environmentType": "Sandbox", // 1. Nombre EXACTO del entorno (Sensible a mayúsculas y minúsculas) // Esto se obtiene del Admin Center de Business Central. "environmentName": "Sandbox-Dev", // 2. Tenant ID: Usar el GUID alfanumérico garantiza que evitamos fallos de DNS o redirección. "tenant": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d", // 3. Objeto de inicio: 22 es la lista de clientes. Cuando pulsemos F5, se abrirá esta pantalla. "startupObjectId": 22, "startupObjectType": "Page", "breakOnError": "Default", "launchBrowser": true, // 4. Parámetros de Telemetría y Debugging avanzados "enableLongRunningSqlStatements": true, "enableSqlInformationDebugger": true } ]}5. 메타데이터 및 의존성 관리 (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»파일 app.json는 우리의 확장에 대한 명세서입니다. 우리는 누구인지, 어떤 버전을 발표하고 있는지, 그리고 가장 중요한 것은 무엇에 의존하는지 정의합니다.
AL 생태계에서는 ERP의 사전 컴파일 라이브러리인 '심볼'을 먼저 다운로드하지 않으면 컴파일할 수 없습니다. app.json는 VS Code에게 서버에서 어떤 정확한 버전의 심볼을 찾아야 하는지 지시합니다.
{ "id": "56a4f575-efca-45f3-8a35-43c3ab4c9adf", "name": "Entradas_Salidas_AL", "publisher": "Portelcore DevSecOps", "version": "1.0.0.0", "brief": "Gestión optimizada de datos y extensiones.",
// Dependencias de otras apps. Si no usamos módulos raros, dejar vacío o con lo básico. "dependencies": [],
// EL PUNTO DE RUPTURA: La versión de "application" debe coincidir con la de nuestro Sandbox. // Si pedimos la 27.0 y el server tiene la 25.0, todo el proyecto fallará. "application": "25.0.0.0", "platform": "25.0.0.0", "runtime": "15.0", // Versión del motor de ejecución (NST).
"idRanges": [ { "from": 50100, "to": 50149 // Nuestro bloque de IDs reservados. } ]}6. 환경 동기화(기호 “Pull”)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»첫 번째 코드 줄을 작성하기 전 마지막 단계는 VS Code를 클라우드와 동기화하는 것입니다.
- 우리의 숨은 폴더
.alpackages가 비어 있거나 생성되었는지 확인합니다. - 명령어를 실행합니다:
Ctrl + Shift + P->AL: Download Code(또는AL: Download Symbols) - 시스템은 브라우저의 코드를 통해 인증(디바이스 로그인)을 요청합니다. 관리자 자격 증명을 사용합니다.
- 파일
launch.json와app.json가 올바르다면, 콘솔에서Microsoft_Application.app와 같은 패키지가 다운로드되는 것을 볼 수 있습니다.
이제 로컬 머신은 ERP 데이터베이스의 전체 구조를 알고 있습니다. 프로그래밍할 준비가 되었습니다.
7. 동기화 및 검증 체크리스트
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ 접속성: VS Code 콘솔에서 심볼 다운로드 성공 (출구 코드
0). - ✓ 버전:
runtime및application의 직접 지침이app.json에서 NST의 활성 버전과 일관됩니다. - ✓ 인증: OAuth 2.0을 통한 디바이스 로그인을 통한 로그인 흐름 완료.

