Ir al contenido

Introduction à l'AL et à l'environnement

Fondamentaux approfondis de l'Application Language (AL), architecture sous-jacente et configuration avancée de VS Code et du tenant.

0vues

Dans notre culture DevSecOps et d'ingénierie des données, il est impératif de cesser de traiter les systèmes ERP (comme Dynamics 365 Business Central) comme des « boîtes noires » ou de simples interfaces web. Pour en tirer les meilleures performances et personnaliser le système au niveau du cœur, nous devons descendre au niveau du code source et comprendre son architecture sous-jacente.

1. Qu'est-ce que AL (Application Language) ?

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

AL est un langage de programmation structuré, déclaratif et fortement typé. Il a été conçu exclusivement par Microsoft pour étendre la logique métier et le modèle de données de Business Central (en remplacement de l'ancien C/AL).

Travailler avec AL est très similaire à travailler avec l'Infrastructure en tant que Code (IaC) (comme Terraform ou Ansible). Nous ne modifions pas la base de données en cliquant sur une interface ; nous définissons dans des fichiers texte brut (.al) la manière dont nous voulons que la base de données (Tables), la logique (Codeunits), l'interface (Pages) et les API (Queries) soient configurées.

Par la suite, ce code est compilé en un package ou une extension (.app) et est déployé sur le serveur. Microsoft ne permet pas de modifier son code source standard ; toute notre programmation agit comme une « couche supplémentaire » (Extension) qui se greffe à l'ERP.

2. Architecture sous-jacente (Le NST et SQL Server)

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

Pour programmer efficacement, nous devons comprendre comment Business Central traite nos instructions :

  • Couche de données : Sous-jacente, tout repose sur un moteur Microsoft SQL Server (sur Azure SQL pour les environnements Cloud).
  • Couche applicative (NST) : Le Navision Server Tier est le « cerveau ». Il traduit notre code AL en requêtes SQL et génère le HTML/JSON que les utilisateurs voient ou que les API consomment. Comprendre cela est essentiel pour éviter de surcharger la mémoire du NST.

3. Préparation de l'environnement de développement local

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

Nous développons localement, mais nous compilons par rapport à un environnement Sandbox dans le cloud. Voici notre configuration de base :

  1. Visual Studio Code (VS Code) : Notre environnement de développement intégré (IDE).
  2. Extension « AL Language » (Microsoft) : Fournit le compilateur, l'autocomplétion (IntelliSense), les outils de débogage et la connexion au tenant.
  3. (Optionnel recommandé) Extension « AL Object Designer » : Un explorateur visuel très utile pour naviguer dans les tables de base de Microsoft et découvrir le nom des champs standards.

3.2. Initialisation du projet (Le « Scaffolding »)

Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»

Pour créer un nouveau projet, nous ouvrons la Palette de commandes de VS Code (Ctrl + Shift + P) et exécutons AL: Go!. L'assistant nous demandera :

  • Un chemin local pour enregistrer le projet.
  • Destination du déploiement : nous choisirons toujours “Microsoft cloud sandbox” (JAMAIS la Production pour les phases de développement).

Cela générera la structure de base, incluant le dossier caché .vscode avec le fichier launch.json, et le fichier racine app.json.

Le fichier .vscode/launch.json est notre cordon ombilical avec le serveur Microsoft. Une configuration laxiste ici est la principale cause d'erreurs de connexion et de déploiement.

Nous devons le configurer avec une extrême précision, en évitant les valeurs génériques (comme 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. Gestion des métadonnées et des dépendances (app.json)

Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»

Le fichier app.json est le manifeste de notre extension. Il définit qui nous sommes, quelle version nous publions et, plus important encore, de quoi nous dépendons.

Dans l'écosystème AL, nous ne pouvons pas compiler sans avoir préalablement téléchargé les « Symboles » (les bibliothèques précompilées de l'ERP). Le app.json indique à VS Code quelle version exacte des symboles il doit aller chercher sur le serveur.

{
"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. Synchronisation de l'environnement (Le « Pull » de symboles)

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

La dernière étape avant d'écrire notre première ligne de code est de synchroniser notre VS Code avec le cloud.

  1. Nous vérifions que notre dossier caché .alpackages est vide (ou créé).
  2. Nous lançons la commande : Ctrl + Shift + P -> AL: Download Code (ou AL: Download Symbols).
  3. Le système nous demandera une authentification (Device Login) via un code dans le navigateur. Nous utiliserons nos identifiants d'administrateur.
  4. Si les fichiers launch.json et app.json sont corrects, nous verrons dans la console que des paquets comme Microsoft_Application.app sont téléchargés.

Notre machine locale connaît maintenant toute la structure de base de données de l'ERP. Nous sommes prêts à programmer.

7. Checklist de synchronisation et de validation

Sección titulada «7. Checklist de Sincronización y Validación»
  • ✓ Connectivité : Téléchargement réussi des symboles dans la console VS Code (code de sortie 0).
  • ✓ Version : Cohérence de la directive runtime et application dans app.json avec la version active du NST.
  • ✓ Authentification : Flux de connexion terminé via Device Login par OAuth 2.0.