Ir al contenido

AL 与环境简介

Application Language (AL) 的深入基础、底层架构以及 VS Code 和租户的高级配置

0阅读

在我们的 DevSecOps 和数据工程文化中,必须停止将 ERP 系统(如 Dynamics 365 Business Central)视为“黑盒”或简单网页界面。要充分发挥系统性能并进行核心级定制,我们必须深入源代码并理解其底层架构。

1. 什么是 AL (Application Language)?

Sección titulada «1. ¿Qué es AL (Application Language)?»

AL 是一种结构化、声明式且强类型的编程语言。它由 Microsoft 独家设计,用于扩展 Business Central 的业务逻辑和数据模型(取代了旧的 C/AL)。

使用AL进行开发与使用基础设施即代码 (IaC) (如Terraform或Ansible) 非常相似。我们不通过点击界面修改数据库;我们通过纯文本文件(.al)定义数据库的结构 (表)、逻辑 (代码单元)、界面 (页面) 和API (查询)。

随后,此代码会编译为一个包或扩展程序(.app),并部署到服务器上。Microsoft不允许修改其标准核心代码;我们所有的编程工作都作为一层“附加” (扩展) 与ERP系统集成。

为了高效编程,我们必须了解Business Central如何处理我们的指令:

  • 数据层: 所有内容都基于Microsoft SQL Server引擎 (云环境使用Azure SQL)。
  • 应用层 (NST): Navision Server Tier 是“大脑”。它将我们的AL代码转换为SQL查询,并渲染用户看到的HTML/JSON或API使用的数据。理解这一点对于避免过度占用NST内存至关重要。

我们在本地进行开发,但针对云上的Sandbox环境进行编译。这是我们的基础配置:

  1. Visual Studio Code (VS Code): 我们的集成开发环境 (IDE)。
  2. 扩展“AL Language”(Microsoft):提供编译器、自动完成(IntelliSense)、调试工具和与租户的连接。
  3. (推荐可选) 扩展“AL Object Designer”:一个非常有用的可视化浏览器,用于浏览Microsoft的基础表并发现标准字段的名称。

要创建一个新项目,我们打开VS Code的命令面板(Ctrl + Shift + P)并执行AL: Go!。助手将要求我们:

  • 本地保存项目的路径。
  • 部署目标:我们始终选择“Microsoft云沙盒”(开发阶段绝不要选择Production)

这将生成基础结构,包括隐藏文件夹.vscode中的文件launch.json和根文件app.json。

文件.vscode/launch.json是我们与Microsoft服务器的纽带。此处的宽松配置是连接和部署错误的主要原因。

我们必须精确配置,避免使用通用值(如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
}
]
}

文件 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.
}
]
}

在编写我们的第一行代码之前,最后一步是将VS Code与云同步。

  1. 我们验证隐藏文件夹 .alpackages 是否为空(或已创建)。
  2. 我们运行命令:Ctrl + Shift + P -> AL: Download Code(或 AL: Download Symbols)
  3. 系统会通过浏览器中的代码要求我们进行身份验证(设备登录)。我们将使用管理员凭据。
  4. 如果文件 launch.json 和 app.json 正确,我们在控制台中会看到如 Microsoft_Application.app 的包被下载。

现在,我们的本地机器了解了ERP的所有数据库结构。我们准备好编程了。

  • ✓ 连接性: 在VS Code控制台成功下载符号(退出代码 0)。
  • ✓ 版本: runtime 和 application 指令在 app.json 中与NST的当前版本一致。
  • ✓ 认证: 通过OAuth 2.0的设备登录完成登录流程。