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.
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)»Symptôme
Sección titulada «Síntoma»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.Diagnostic racine (Sensibilité des versions)
Sección titulada «Diagnóstico Raíz (Sensibilidad de Versiones)»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.
Résolution étape par étape
Sección titulada «Resolución Paso a Paso»- 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.
- Assouplir le
app.json: Nous ouvrons le fichierapp.jsondans notre projet local. - 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). - Nous abaissons le moteur d'exécution
"runtime"vers une version compatible (ex.13.0ou16.0). - Vider le cache : Nous supprimons physiquement le contenu du dossier caché
.alpackages. - Nouvelle tentative : Nous exécutons à nouveau
AL: Download Symbols. Le terminal devrait afficherAll 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”)»Symptôme
Sección titulada «Síntoma»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.
Diagnostic racine
Sección titulada «Diagnóstico Raíz»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.
Résolution
Sección titulada «Resolución»Nous devons assainir les dépendances de notre projet.
- Nous ouvrons
app.json. - Nous recherchons le tableau
"dependencies": [ ... ]. - 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. - Vider le cache de
.alpackageset 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/Doute fréquent
Sección titulada «Consulta/Duda Frecuente»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 ? »
Clarification technique DevSecOps
Sección titulada «Aclaración Técnica DevSecOps»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.
- Système de fichiers (SO) : Visual Studio Code et Windows ne font aucune distinction si le chemin est
C:/Proyectos/Consulta_Datosouc:/proyectos/cOnSuLtAdAtOs. - 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.
4. Critères de réussite du triage
Sección titulada «4. Criterios de Éxito de Triage»- ✓ Nettoyage : Vidage préventif du dossier
.alpackageslors de changements structurels dansapp.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.

