Ir al contenido

Введение в AL и среду

Глубокие основы языка приложения (AL), базовая архитектура и расширенная настройка VS Code и аренда.

0просмотры

В нашей культуре DevSecOps и инженерии данных крайне важно перестать относиться к системам ERP (таким как Dynamics 365 Business Central) как к «черным ящикам» или простым веб-интерфейсам. Чтобы получить максимальную производительность и адаптировать систему на уровне ядра, мы должны спуститься на уровень исходного кода и понять его базовую архитектуру.

1. Что такое AL (язык приложения)?

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

AL - это структурированный, декларативный и строго типизированный язык программирования. Он был разработан исключительно Microsoft для расширения бизнес-логики и модели данных Business Central (заменив старый C/AL).

Работа с AL очень похожа на работу с инфраструктурой как кодом (IaC) (как Terraform или Ansible). Мы не изменяем базу данных, щелкая на интерфейсе; мы определяем в файлах простого текста (.al) то, каким мы хотим видеть базу данных (таблицы), логику (Codeunits), интерфейс (страницы) и API (запросы).

Позже этот код компилируется в пакет или расширение (.app) и развертывается на сервере. Microsoft не позволяет изменять свой базовый стандартный код; вся наша программирование действует как „дополнительный слой“ (расширение), который подключается к ERP.

2. Базовая архитектура (NST и SQL Server)

Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»

Чтобы программировать эффективно, мы должны понимать, как Business Central обрабатывает наши инструкции:

  • Слой данных: В основе всего лежит движок Microsoft SQL Server (в Azure SQL для облачных сред).
  • Слой приложения (NST): Navision Server Tier - это "мозг". Он переводит наш код AL в SQL-запросы и отображает HTML/JSON, которые видят пользователи или используют API. Понимание этого имеет решающее значение для избежания перегрузки памяти NST.

3. Подготовка локальной среды разработки

Sección titulada «3. Preparación del Entorno de Desarrollo Local»

Мы разрабатываем локально, но компилируем против песочницы в облаке. Это наша базовая конфигурация:

3.1. Обязательные инструменты

Sección titulada «3.1. Herramientas Obligatorias»
  1. Visual Studio Code (VS Code): Наша интегрированная среда разработки (IDE).
  2. Расширение "AL Language" (Microsoft): Предоставляет компилятор, автозаполнение (IntelliSense), инструменты отладки и подключение к арендателю.
  3. (Рекомендуется опционально) Расширение "AL Object Designer": Очень полезный визуальный браузер для навигации по базовым таблицам Microsoft и открытия стандартных полей.

3.2. Инициализация проекта (”Scaffolding”)

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 является нашим пуповинным соединением с сервером 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
}
]
}

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 с облаком.

  1. Мы проверяем, что наша скрытая папка .alpackages пуста (или создана).
  2. Мы запускаем команду: Ctrl + Shift + P -> AL: Download Code (или AL: Download Symbols).
  3. Система попросит нас аутентификации (Device Login) с помощью кода в браузере. Мы используем наши учетные данные администратора.
  4. Если файлы 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.
  • ✓ Аутентификация: Поток входа в систему завершен через Device Login с использованием OAuth 2.0.