Introdução a AL e Ambiente
Fundamentos profundos de Application Language (AL), arquitetura subjacente e configuração avançada de VS Code e o tenant.
Na nossa cultura DevSecOps e de Engenharia de Dados, é imperativo deixar de tratar os sistemas ERP (como o Dynamics 365 Business Central) como “caixas pretas” ou simples interfaces web. Para extrair o máximo desempenho e personalizar o sistema a nível core, devemos descer ao nível do código-fonte e compreender a sua arquitetura subjacente.
1. O que é AL (Application Language)?
Sección titulada «1. ¿Qué es AL (Application Language)?»AL é uma linguagem de programação estruturada, declarativa e fortemente tipada. Foi concebida exclusivamente pela Microsoft para estender a lógica de negócio e o modelo de dados do Business Central (substituindo o antigo C/AL).
Trabalhar com AL é muito semelhante a trabalhar com Infraestrutura como Código (IaC) (como Terraform ou Ansible). Nós não modificamos a base de dados clicando numa interface; nós definimos em arquivos de texto simples (.al) como queremos que seja a base de dados (Tabelas), a lógica (Codeunits), a interface (Páginas) e as APIs (Consultas).
Posteriormente, este código se compila en un paquete o extensión (.app) y se despliega en el servidor. Microsoft no permite alterar su código base estándar; toda nuestra programación actúa como una “capa adicional” (Extensión) que se acopla al ERP.
2. Arquitetura Subjacente (O NST e SQL Server)
Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»Para programar com eficiência, devemos entender como o Business Central processa as nossas instruções:
- Capa de Datos: Por debajo, todo reside en un motor Microsoft SQL Server (en Azure SQL para entornos Cloud).
- Capa de Aplicación (NST): El Navision Server Tier es el “cerebro”. Traduce nuestro código AL a consultas SQL y renderiza el HTML/JSON que ven los usuarios o consumen las APIs. Entender esto es vital para evitar sobrecargar la memoria del NST.
3. Preparação do Ambiente de Desenvolvimento Local
Sección titulada «3. Preparación del Entorno de Desarrollo Local»Desarrollamos en local, pero compilamos contra un entorno Sandbox en la nube. Esta es nuestra configuración base:
3.1. Ferramentas Obrigatórias
Sección titulada «3.1. Herramientas Obligatorias»- Visual Studio Code (VS Code): Nuestro entorno de desarrollo integrado (IDE).
- Extensión “AL Language” (Microsoft): Proporciona el compilador, el autocompletado (IntelliSense), las herramientas de depuración y la conexión al tenant.
- (Opcional recomendado) Extensión “AL Object Designer”: Un explorador visual muy útil para navegar por las tablas base de Microsoft y descubrir cómo se llaman los campos estándar.
3.2. Inicialização do Projeto (O “Scaffolding”)
Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»Para crear un nuevo proyecto, abrimos la Paleta de Comandos de VS Code (Ctrl + Shift + P) y ejecutamos AL: Go!. El asistente nos pedirá:
- Um caminho local para guardar o projeto.
- El destino del despliegue: Elegiremos siempre “Microsoft cloud sandbox” (NUNCA Production para fases de desarrollo).
Esto nos generará la estructura base, incluyendo la carpeta oculta .vscode con el archivo launch.json, y el archivo raíz app.json.
4. Enrutamiento y Conexión (launch.json)
Sección titulada «4. Enrutamiento y Conexión (launch.json)»El archivo .vscode/launch.json es nuestro cordón umbilical con el servidor de Microsoft. Una configuración laxa aquí es la principal causa de errores de conexión y de despliegue.
Devemos configurá-lo com extrema precisão, evitando os valores genéricos (como 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. Gestión de Metadata y Dependencias (app.json)
Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»El archivo app.json es el manifiesto de nuestra extensión. Define quiénes somos, qué versión estamos publicando y, lo más crítico, de qué dependemos.
En el ecosistema AL, no podemos compilar si no descargamos previamente los “Símbolos” (las librerías precompiladas del ERP). El app.json le dice a VS Code qué versión exacta de los símbolos debe ir a buscar al servidor.
{ "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. Sincronização do Ambiente (O “Pull” de Símbolos)
Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»O passo final antes de escrever a nossa primeira linha de código é sincronizar o nosso VS Code com a nuvem.
- Verificamos que nuestra carpeta oculta .alpackages esté vacía (o creada).
- Lanzamos el comando: Ctrl + Shift + P -> AL: Download Code (o AL: Download Symbols).
- O sistema solicitará autenticação (Device Login) através de um código no navegador. Usaremos as nossas credenciais de administrador.
- Si los archivos launch.json y app.json son correctos, veremos en la consola que se descargan paquetes como Microsoft_Application.app.
Nossa máquina local agora conhece toda a estrutura de banco de dados do ERP. Estamos prontos para programar.
7. Checklist de Sincronização e Validação
Sección titulada «7. Checklist de Sincronización y Validación»- ✓ Conectividad: Descarga exitosa de símbolos en la consola de VS Code (código de salida 0).
- ✓ Versión: Coherencia de la directiva runtime y application en app.json con la versión activa del NST.
- ✓ Autenticación: Flujo de inicio de sesión completado vía Device Login mediante OAuth 2.0.

