Inicio de un Proyecto AL

Antes de escribir una sola línea de código AL necesitas preparar el entorno de desarrollo. En esta guía verás paso a paso cómo instalar las extensiones necesarias en VS Code y arrancar tu primer proyecto desde cero.

Abre VS Code y ve al panel de extensiones con Ctrl + Shift + X. Necesitarás instalar las siguientes dos extensiones oficiales de Microsoft:

Con la extensión AL instalada, abre la Paleta de comandos con Ctrl + Shift + P y escribe:

AL: Go!

VS Code te pedirá:

1. Una carpeta de destino donde se creará el proyecto.
2. La versión del servidor (elige la que coincida con tu contenedor, normalmente 6.0 para BC22+ o Latest).

Esto genera automáticamente la estructura base del proyecto:

📁 MiProyectoAL/
   ├── .vscode/
   │   └── launch.json        // configuración de conexión al servidor BC
   ├── app.json               // metadatos del proyecto (ID, nombre, versión, dependencias)
   └── HelloWorld.al          // fichero de ejemplo con una Page de prueba

El fichero app.json

Es el manifiesto del proyecto. Define su identidad y dependencias. Los campos más importantes:

{
    "id":                "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",  // GUID único del proyecto (no tocar)
    "name":              "MiProyecto",
    "publisher":         "TuNombre",
    "version":           "1.0.0.0",
    "idRanges": [{ "from": 50100, "to": 50999 }],   // rango de IDs que puedes usar
    "runtime":           "12.0",
    "platform":          "22.0.0.0",
    "application":       "22.0.0.0",
    "dependencies":      []
}

El fichero launch.json

Indica a VS Code cómo y dónde publicar la extensión. Debes configurarlo para que apunte a tu contenedor local:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name":          "Publicar en contenedor local",
            "request":       "launch",
            "type":          "al",
            "environmentType": "OnPrem",
            "server":        "http://bccontainer",               // nombre del contenedor
            "serverInstance": "BC",
            "authentication": "UserPassword",
            "startupObjectId": 22,
            "startupObjectType": "Page"
        }
    ]
}

Los símbolos son los metadatos de todas las tablas, páginas y codeunits base de Business Central. Sin ellos, IntelliSense no puede sugerirte nombres de tabla ni propiedades. Es el paso más importante antes de empezar a escribir código.

Abre la Paleta de comandos con Ctrl + Shift + P y escribe:

AL: Download Symbols

VS Code se conectará al contenedor y descargará los símbolos en la carpeta .alpackages/ del proyecto. Cuando termine verás los ficheros .app de las librerías base de BC:

📁 .alpackages/
   ├── Microsoft_Application_22.0.0.0.app
   ├── Microsoft_Base Application_22.0.0.0.app
   └── Microsoft_System_22.0.0.0.app

La extensión AL incluye snippets (plantillas de código) que te generan la estructura completa de cualquier objeto con solo escribir su prefijo y pulsar Tab. Los más usados:

Una vez tienes código escrito, puedes compilar y publicar la extensión en el contenedor con:

AL: Publish          // equivalente a F5
AL: Publish Without Debugging  // equivalente a Ctrl+F5

Flujo de trabajo típico

Este es el orden habitual al empezar o reanudar el trabajo en cualquier sesión:

1. Arrancar el contenedor si no está corriendo:
   Administrador: PowerShell

   Start-BcContainer bccontainer

2. Abrir la carpeta del proyecto en VS Code: Ctrl + K, Ctrl + O
3. Descargar símbolos si es la primera vez o si BC se actualizó: Ctrl + Shift + P → AL: Download Symbols
4. Escribir código usando snippets (ttable, tpage…)
5. Publicar y probar con F5
6. Iterar: corregir errores → publicar de nuevo con Ctrl + F5

Resumen de comandos AL en la Paleta