Suivre les métadonnées de source et de build sur les extensions

Activé(e) pour	Version préliminaire publique	Disponibilité générale
Administrateurs, créateurs, responsables marketing ou analystes, automatiquement	16 août 2023	2 oct. 2023

Valeur commerciale

Pour faciliter le suivi des extensions créées dans le cadre des pipelines DevOps, nous introduisons les propriétés Source et Build dans le manifeste app.json des extensions. Cela permet de trouver facilement le référentiel source pertinent, l’ID de validation et le système de build utilisé pour créer l’extension.

Détails de la fonctionnalité

Le manifeste des extensions app.json contient désormais deux nouvelles propriétés, Source et Build. Elles peuvent être utilisées pour suivre l’emplacement de la source et le contexte de construction.

Pour la propriété source, nous prenons en charge :

• repositoryUrl, l’URL du référentiel où se trouve le code source du projet.
• commit, un identifiant du code source de la version actuelle du projet, qui permet de revenir au commit qui a déclenché la construction de l’extension.

Pour la propriété build, nous prenons en charge :

• by, utile pour suivre l’agent/système de build qui a orchestré la build ; par exemple, AL-Go for GitHub.
• url, peut être utilisé pour l’URL de l’invocation du système de build où la build peut être trouvée.

Vous pouvez définir ces valeurs directement dans app.json, mais étant donné la nature dynamique, le scénario habituel serait de les définir dans le cadre des pipelines de construction via des paramètres de ligne de commande pour l’exécutable du compilateur alc.exe utilisé. Les valeurs transmises ici remplacent toutes celles du fichier source app.json.

Si vous utilisez BcContainerHelper, les fonctions Compile-AppInBcContainer et Compile-AppWithCompilerFolder prennent désormais les paramètres de « SourceRepositoryUrl », « SourceCommit », « BuildBy » et « BuildUrl ». Ils sont maintenant définis si vous utilisez AL-Go for GitHub pour créer vos extensions.

Dans cette version, aucune de ces valeurs n’apparaît encore sur la page Gestion des extensions, dans TAC ou via des commandes PowerShell comme NAV-AppInfo. Pour lire les valeurs, vous pouvez utiliser le BcContainerHelper « Extract-AppFileToFolder », qui permettra d’obtenir le fichier app.json avec les paramètres.

Voici un exemple de métadonnées de build et de source dans app.json. Ceci est normalement défini par le processus build et non manuellement.

Donnez-nous votre avis

Aidez-nous à améliorer Dynamics 365 Business Central en proposant des idées et en nous transmettant vos suggestions et commentaires. Consultez le forum à l’adresse https://aka.ms/bcideas.

Voir aussi

Fichiers JSON (documents)