Ir al contenido

Introducción a AL y Entorno

Fundamentos profundos de Application Language (AL), arquitectura subyacente, y configuración avanzada de VS Code y el tenant.

0lecturas

En nuestra cultura DevSecOps y de Ingeniería de Datos, es imperativo dejar de tratar a los sistemas ERP (como Dynamics 365 Business Central) como “cajas negras” o simples interfaces web. Para extraer el máximo rendimiento y personalizar el sistema a nivel core, debemos descender al nivel del código fuente y comprender su arquitectura subyacente.

AL es un lenguaje de programación estructurado, declarativo y fuertemente tipado. Fue diseñado exclusivamente por Microsoft para extender la lógica de negocio y el modelo de datos de Business Central (sustituyendo al antiguo C/AL).

Trabajar con AL es muy similar a trabajar con Infraestructura como Código (IaC) (como Terraform o Ansible). Nosotros no modificamos la base de datos haciendo clics en una interfaz; nosotros definimos en archivos de texto plano (.al) cómo queremos que sea la base de datos (Tablas), la lógica (Codeunits), la interfaz (Páginas) y las 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. Arquitectura Subyacente (El NST y SQL Server)

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

Para programar con eficiencia, debemos entender cómo procesa Business Central nuestras instrucciones:

  • 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. Preparación del Entorno de Desarrollo 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:

  1. Visual Studio Code (VS Code): Nuestro entorno de desarrollo integrado (IDE).
  2. Extensión “AL Language” (Microsoft): Proporciona el compilador, el autocompletado (IntelliSense), las herramientas de depuración y la conexión al tenant.
  3. (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. Inicialización del Proyecto (El “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á:

  • Una ruta local para guardar el proyecto.
  • 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.

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.

Debemos configurarlo con extrema precisión, evitando los 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. Sincronización del Entorno (El “Pull” de Símbolos)

Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»

El paso final antes de escribir nuestra primera línea de código es sincronizar nuestro VS Code con la nube.

  1. Verificamos que nuestra carpeta oculta .alpackages esté vacía (o creada).
  2. Lanzamos el comando: Ctrl + Shift + P -> AL: Download Code (o AL: Download Symbols).
  3. El sistema nos pedirá autenticación (Device Login) mediante un código en el navegador. Usaremos nuestras credenciales de administrador.
  4. Si los archivos launch.json y app.json son correctos, veremos en la consola que se descargan paquetes como Microsoft_Application.app.

Nuestra máquina local ahora conoce toda la estructura de bases de datos del ERP. Estamos listos para programar.

7. Checklist de Sincronización y Validación

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.