Tenere traccia dei metadati di origine e compilazione sulle estensioni
Importante
Questo contenuto è archiviato e non viene aggiornato. Per la documentazione più recente, vai a Novità o modifiche in Business Central. Per i piani di rilascio più recenti, vai a Piani di rilascio di Dynamics 365, Power Platform e Cloud per le soluzioni di settore.
Abilitata per | Anteprima pubblica | Disponibilità generale |
---|---|---|
Amministratori, autori, responsabili del marketing o analisti, automaticamente | 16 ag. 2023 | 2 Ott. 2023 |
Valore aziendale
Per tenere traccia delle estensioni create come parte delle pipeline DevOps, stiamo introducendo le proprietà Source e Build nel manifesto app.json delle estensioni. In questo modo viene semplificata la ricerca del repository di origine, l'ID commit e il sistema di compilazione pertinenti utilizzati per creare l'estensione.
Dettagli sulla funzionalità
Il manifesto delle estensioni app.json ora contiene due nuove proprietà, Source e Build. Queste possono essere utilizzate per tener traccia della posizione di origine e del contesto di compilazione.
Per l'origine vengono supportati:
- repositoryUrl, che è l'URL del repository dove si trova il codice sorgente del progetto.
- commit, che è un ID del codice sorgente per la versione corrente del progetto, che consente di tornare al commit che ha attivato la creazione dell'estensione.
Per la compilazione vengono supportati:
- by, utile per tener traccia dell'agente/sistema di compilazione che ha orchestrato la compilazione; ad esempio, AL-Go for GitHub.
- url, che può essere utilizzato per l'URL alla chiamata del sistema di compilazione in cui è possibile trovare la compilazione.
Puoi definire questi valori direttamente in app.json, ma data la natura dinamica, lo scenario abituale prevede l'impostazione degli stessi come parte delle pipeline di compilazione tramite parametri della riga di comando per l'eseguibile di compilazione alc.exe utilizzato. I valori passati qui sovrascriveranno tutti i valori nel file di origine app.json.
Se si utilizza BcContainerHelper, le funzioni Compile-AppInBcContainer e Compile-AppWithCompilerFolder acquisiscono ora i parametri per "SourceRepositoryUrl", "SourceCommit", "BuildBy" e "BuildUrl". Questi vengono ora impostati se utilizzi AL:Go for GitHub per compilare le tue estensioni.
In questa versione nessuno di questi valori viene ancora presentato nella pagina Gestione estensioni, in TAC o tramite comandi PowerShell come NAV-AppInfo. Se vuoi leggere i valori, l'opzione è attualmente quella di utilizzare BcContainerHelper "Extract-AppFileToFolder", che consente di recuperare il file app.json con le impostazioni.
Ecco un esempio di metadati di origine e compilazione in app.json. Questo viene normalmente impostato dal processo di compilazione e non manualmente.
Comunicaci la tua opinione
Aiutaci a migliorare Dynamics 365 Business Central condividendo idee, fornendo suggerimenti e inviando feedback. Utilizza il forum all'indirizzo https://aka.ms/bcideas.
Vedi anche
File JSON (documenti)