Spåra källa och skapa metadata i tillägg

Viktigt

Detta innehåll är arkiverat och uppdateras inte. Den senaste dokumentationen finns i Nyheter och ändringar i Business Central. De senaste utgivningsplanerna finns i Utgivningsplaner för Dynamics 365 och Power Platform och Cloud for Industry.

Aktiverat för	Allmänt tillgänglig förhandsversion	Allmän tillgänglighet
Administratörer, utvecklare, marknadsförare eller analytiker, automatiskt	16 aug. 2023	2 okt. 2023

Affärsvärde

För att spåra tillägg som skapas som en del av DevOps-pipelines, introducerar vi egenskaperna Source och Build i app.json-manifestet för tillägg. Det här gör det enkelt att hitta relevant källagringsplats, inchecknings-ID och versionssystem som användes till att skapa tillägget.

Information om funktionen

Tilläggens app.json-manifest innehåller nu två nya egenskaper, Source och Build. De går att använda till att spåra källplats och versionssammanhang.

För source stöder vi:

• repositoryUrl, som är lagringsplatsens URL där projektets källkod finns.
• commit, som är ID för källkoden för den aktuella projektversionen som gör det möjligt att gå tillbaka till commit som utlöste att tillägget skapades.

För build stöder vi:

• by, vilket är användbart för att spåra byggets handläggare/system som skapade bygget. Till exempel AL-Go for GitHub.
• url, som kan användas som URL till versionssystemanropet där build finns.

Det går att definiera dessa värden direkt i app.json, men med tanke på den dynamiska karaktären är det vanliga scenariot att ställa in dessa som en del av bygg-pipelines genom kommandoradsparametrar för den använda alc.exe-kompilatorns körbara fil. Värdena som skickas här skriver över alla värden i källfilen app.json.

Om du använder BcContainerHelper tar funktionerna Compile-AppInBcContainer och Compile-AppWithCompilerFolder nu parametrar för SourceRepositoryUrl, SourceCommit, BuildBy och BuildUrl. Dessa ställs nu in om du använder AL:Go för GitHub till att skapa tillägg.

I den här utgåvan dyker inga av dessa värden ännu upp på sidan Tilläggshantering, i TAC eller genom PowerShell-kommandon såsom NAV-AppInfo. Om du vill läsa värdena är alternativet för närvarande att använda BcContainerHelper Extract-AppFileToFolder, som gör det möjligt att hämta app.json-filen med inställningarna.

Här är ett exempel på metadata för build och source i app.json. Det här ställs normalt in av byggprocessen och inte manuellt.

Berätta vad du tycker

Hjälp oss förbättra Dynamics 365 Business Central genom att diskutera idéer, ge förslag och lämna feedback. Använd forumet på https://aka.ms/bcideas.

Se även

JSON-filer (dokument)