Ir al contenido

Dépannage en développement AL

Guide de résolution des erreurs courantes de déploiement, de dépendances et de téléchargement de symboles dans les environnements Business Central.

0vues

Dans nos opérations DevSecOps, la plupart des blocages ne proviennent pas d'erreurs de logique dans notre code, mais de défauts de configuration d'environnement, de décalages de versions ou de problèmes de communication réseau entre notre IDE local (VS Code) et le locataire (tenant) dans le cloud.

Il s'agit de notre base de connaissances pour résoudre instantanément les incidents enregistrés lors des phases de développement et d'intégration.

Incident 1 : Erreur 404 Not Found (Téléchargement de symboles)

Sección titulada «Incidente 1: Error 404 Not Found (Descarga de Símbolos)»

En exécutant la commande AL: Download Symbols (ou en tentant de faire un Build avec F5), le terminal (Output -> AL) renvoie des blocs massifs d'erreurs similaires à celui-ci :

[2026-03-24 10:15:23] Sending request to https://api.businesscentral.../v2.0/sandbox/dev/packages?publisher=Microsoft&appName=Application&versionText=27.4.45366
[2026-03-24 10:15:24] Error: Not Found
[2026-03-24 10:15:24] The request for path ... failed with code NotFound.
error AL1022: A package with publisher 'Microsoft', name 'Application', and a version compatible with '27.4.45366' could not be found.

Il s'agit d'une erreur de désynchronisation de versions dans le Manifeste. Business Central est extrêmement strict (version-sensitive). L'erreur indique que notre fichier local app.json exige du serveur qu'il nous envoie les bibliothèques du core dans sa version 27.4.45366. Cependant, le Sandbox vers lequel nous pointons (configuré dans launch.json) possède une version antérieure installée (par exemple, la 25.0.0.0). Comme le serveur ne possède pas la version exigée, il renvoie une erreur 404.

  1. Identifier la version du serveur : Nous pouvons vérifier la version réelle en accédant au site web de Business Central -> Aide et support -> À propos.
  2. Assouplir le app.json : Nous ouvrons le fichier app.json dans notre projet local.
  3. Nous abaissons la version minimale requise. Nous modifions "application" et "platform" vers une version que nous savons être sûre et universelle (ex. 25.0.0.0).
  4. Nous abaissons le moteur d'exécution "runtime" vers une version compatible (ex. 13.0 ou 16.0).
  5. Vider le cache : Nous supprimons physiquement le contenu du dossier caché .alpackages.
  6. Nouvelle tentative : Nous exécutons à nouveau AL: Download Symbols. Le terminal devrait afficher All reference symbols have been downloaded.

Incident 2 : Erreur due à des dépendances fantômes (« API Reports »)

Sección titulada «Incidente 2: Error por Dependencias Fantasma (“API Reports”)»

Lors d'une tentative de téléchargement de symboles ou de compilation, le système indique qu'une dépendance spécifique est manquante et que nous ne parvenons pas à localiser, comme par exemple : A package with publisher 'Microsoft', name 'API Reports - Finance', could not be found.

VS Code, lors de l'initialisation de projets via AL: Go!, injecte parfois des dépendances de modules très spécifiques (comme des modules financiers avancés) dans le bloc "dependencies" du app.json. Si notre serveur Sandbox n'a pas cette application Microsoft particulière installée, l'empaquetage global échouera en cascade.

Nous devons assainir les dépendances de notre projet.

  1. Nous ouvrons app.json.
  2. Nous recherchons le tableau "dependencies": [ ... ].
  3. Si nous développons des intégrations génériques ou des API simples, nous supprimons complètement les blocs de dépendances étrangères (comme API Reports - Finance), laissant le tableau vide [] ou ne conservant que les dépendances critiques de notre propre entreprise.
  4. Vider le cache de .alpackages et retélécharger les symboles.

Incident 3 : Mythe des dossiers et de la nomenclature (CamelCase vs Snake_case)

Sección titulada «Incidente 3: Mito de las Carpetas y Nomenclatura (CamelCase vs Snake_case)»

Question de l'équipe : « Le compilateur AL échoue-t-il si les dossiers racines du projet sur mon disque dur (ex. Consulta_Datos_Comercial) ne sont pas écrits en camelSensitive / CamelCase ? »

La réponse est un NON catégorique. Le compilateur AL n'est pas sensible à la casse ou aux formats dans les noms physiques des dossiers Windows.

  1. Système de fichiers (SO) : Visual Studio Code et Windows ne font aucune distinction si le chemin est C:/Proyectos/Consulta_Datos ou c:/proyectos/cOnSuLtAdAtOs.
  2. Comportement du compilateur : Une fois la commande de compilation (Build) lancée, le moteur package le contenu en se basant exclusivement sur les métadonnées déclarées dans le app.json (Propriétés "name" et "publisher"). Le nom de votre répertoire local est ignoré et est sans importance pour le serveur Cloud.

Recommandation de nommage : Nous utilisons la convention Snake_Case (tirets bas) dans les répertoires (Entradas_Salidas_AL) strictement pour une lisibilité humaine et un ordre visuel dans nos dépôts Git, et non par contrainte technique du compilateur.

  • ✓ Nettoyage : Vidage préventif du dossier .alpackages lors de changements structurels dans app.json.
  • ✓ Validation : Cohérence absolue entre la suite de dépendances déclarées dans le manifeste et les extensions installées dans le cloud.
  • ✓ Suivi : Surveillance du canal de sortie de « AL Language » de VS Code pour un diagnostic précis des erreurs réseau.