Delen via

Bron- en build-metagegevens bijhouden in extensies

  • Artikel

Belangrijk

Deze inhoud is gearchiveerd en wordt niet bijgewerkt. Ga voor de meest recente documentatie naar Nieuwe of gewijzigde functies in Business Central. Ga voor de meest recente releaseplannen naar de pagina Releaseplannen voor Dynamics 365, Power Platform en Cloud for Industry.

Geactiveerd voor Openbare preview Algemene beschikbaarheid
Beheerders, makers, marketeers of analisten, automatisch 16 aug. 2023 2 okt. 2023

Zakelijke waarde

Om gemakkelijker extensies bij te houden die zijn gemaakt als onderdeel van DevOps-pijplijnen, introduceren we de eigenschappen Source en Build in het app.json-manifest van extensies. Hierdoor kunt u eenvoudig de relevante bronopslagplaats, commit-id en build-systeem vinden waarmee de extensie is gemaakt.

Functiedetails

Het app.json-manifest van extensies bevat nu twee nieuwe eigenschappen: Source en Build. Deze kunnen worden gebruikt om de bronlocatie en de build-context bij te houden.

Voor Source wordt het volgende ondersteund:

  • repositoryUrl: dit is de URL van de opslagplaats waar de broncode van het project kan worden gevonden.
  • commit: dit is een id van de broncode voor de huidige versie van het project, waarmee u kunt terugkeren naar de commit waarmee het bouwen van de extensie is geactiveerd.

Voor Build wordt het volgende ondersteund:

  • by: dit is handig voor het bijhouden van build-agent/-systeem waarmee de build is ingedeeld, bijvoorbeeld, AL-Go for GitHub.
  • url: dit kan worden gebruikt voor de URL naar de aanroep van het build-systeem waar de build kan worden gevonden.

U kunt deze waarden rechtstreeks in app.json definiëren, maar gezien de dynamische aard is het gebruikelijke scenario om deze in te stellen als onderdeel van build-pijplijnen via opdrachtregelparameters voor het gebruikte uitvoerbare compilerbestand alc.exe. Met de hier doorgegeven waarden worden alle waarden in het bronbestand app.json overschreven.

Als BcContainerHelper wordt gebruikt, worden voor de functies Compile-AppInBcContainer en Compile-AppWithCompilerFolder nu parameters voor "SourceRepositoryUrl", "SourceCommit", "BuildBy" en "BuildUrl" gebruikt. Deze worden nu ingesteld als u AL-Go for GitHub gebruikt om uw extensies te bouwen.

In deze release worden deze waarden niet meer weergegeven op de pagina Extensiebeheer in TAC of via PowerShell-opdrachten zoals NAV-AppInfo. Als u de waarden wilt lezen, is er momenteel de mogelijkheid om de "Extract-AppFileToFolder" van BcContainerHelper te gebruiken. Hiermee kan het bestand app.json met de instellingen worden opgehaald.

Hier is een voorbeeld van build- en bronmetagegevens in app.json. Dit wordt normaal gesproken ingesteld tijdens het build-proces en niet handmatig.

Voorbeeld van build- en bronmetagegevens in app.json

Geef ons uw mening

Help ons Dynamics 365 Business Central te verbeteren door ideeën te bespreken, suggesties te doen en feedback te geven. Gebruik het forum op https://aka.ms/bcideas.

Zie ook

JSON-bestanden (docs)