Uso dei file di configurazione JSON
JSON è l'acronimo di JavaScript Object Notation, il formato leggero per l'interscambio dei dati usato spesso per l'archiviazione e il trasporto dei dati. Un'estensione AL include due file JSON: app.json e launch.json. Questi file vengono creati automaticamente quando si avvia una nuova estensione AL e sono usati per l'archiviazione dei dati di configurazione.
File launch.json
Il file di configurazione launch.json contiene informazioni sul server in cui l'estensione verrà distribuita per il test e il debug. È possibile usare due configurazioni, a seconda che l'estensione venga pubblicata in un server locale o nel cloud.
La tabella di seguito illustra le principali proprietà obbligatorie per il file launch.json. Innanzitutto, è importante comprendere la funzione delle proprietà startupObjectId e startupObjectType nel file launch.json.
Ogni volta che si avvia l'estensione da Visual Studio Code, il programma cerca automaticamente nel file launch.json l'oggetto da avviare come primo. Nell'esempio della figura precedente, il primo oggetto da avviare è la pagina 22, ovvero Customer List. Se si sviluppano pagine personalizzate e si desidera avviarle come prime, è necessario sostituire la proprietà startupObjectId con il numero di pagina relativo.
Di seguito è riportato un collegamento in cui si possono trovare ulteriori informazioni su tutte le impostazioni del file Launch.json: File launch.json.
File app.json
Il file app.json contiene informazioni sull'estensione che si sta creando, ad esempio: editore, nome dell'estensione e versione minima supportata. Spesso il file app.json viene indicato anche come file manifest.
Di seguito è riportato un collegamento in cui si possono trovare ulteriori informazioni su tutte le impostazioni del file App.json: File app.json.
Identità dell'app
Le app create con AL estendono le funzionalità di Business Central. Il file app.json viene generato automaticamente, insieme al file launch.json, quando si crea un nuovo progetto AL. Il file app.json contiene informazioni sull'app che si sta creando, ad esempio informazioni sull'editore e specifica la versione minima degli oggetti applicativi di base su cui si basa l'estensione. Spesso il file app.json viene indicato anche come file manifest. Il file app.json contiene numerose impostazioni del progetto, ma alcune di esse costituiscono l'identità effettiva dell'app che si sta creando.
Con il secondo ciclo di rilascio di Business Central 2021, nome ed editore non sono più considerati parte dell'identità dell'app ed è quindi possibile modificarli per riflettere, ad esempio, il marchio o l'acquisizione. Se si modificano le informazioni relative a nome e/o editore, è necessario incrementare anche la versione. Se si usano aree di lavoro con più progetti e si modifica il nome o l'editore di un'estensione nell'area di lavoro, è necessario aggiornare le dipendenze nel file app.json in base al nuovo nome ed editore o si potrebbero riscontrare problemi con la risoluzione dei riferimenti.
L'ID di un'app viene generato automaticamente dall'estensione AL Language quando si crea una nuova app o se si usa il comando AL: Genera manifesto.
Se si sono copiati l'app o il manifesto da un'altra app, è necessario modificare l'ID prima di pubblicarlo nel servizio online come estensione per tenant o app AppSource.
Dopo che l'app è stata pubblicata, è necessario cambiare solo l'ID se si intende usare la base di codice per sviluppare una nuova app. Non è possibile eseguire l'aggiornamento dall'app con l'ID precedente all'app con il nuovo ID perché il sistema non sa della corrispondenza.
Se si è pubblicata l'app come estensione per tenant, ma si sta considerando la possibilità di pubblicarla in AppSource, è necessario assegnare un nuovo ID all'app AppSource, nonché assicurarsi che soddisfi tutti i requisiti tecnici per la pubblicazione in AppSource.
Si consiglia di usare un altro ID per l'app che si pubblica da Visual Studio Code o in un container. Una volta che si è soddisfatti della qualità dell'app e si è pronti per pubblicarla in AppSource, si consiglia di usare un altro ID. Se non si segue questo approccio, la pubblicazione dell'app da Visual Studio Code in un sandbox per sviluppatori viene automaticamente annullata se un altro utente tenta di installare l'app AppSource.
Se si punta solo al secondo ciclo di rilascio di Business Central 2021 o ai cicli successivi, è possibile cambiare il nome di un'app in qualsiasi momento anche dopo che è stata pubblicata. Se si è cambiato il nome, è necessario incrementare anche la versione.
Se si punta alle versioni di Business Central precedenti il secondo ciclo di rilascio 2021, non è possibile cambiare il nome di un'app dopo che è stata pubblicata.
Se si punta solo al secondo ciclo di rilascio di Business Central 2021 o ai cicli successivi, è possibile cambiare l'editore di un'app in qualsiasi momento anche dopo che è stata pubblicata. Se si è cambiato l'editore, è necessario incrementare anche la versione.
Se si punta alle versioni di Business Central precedenti il secondo ciclo di rilascio 2021, non è possibile cambiare l'editore di un'app dopo che è stata pubblicata.
È necessario incrementare le versione ogni volta che una nuova versione dell'app viene caricata in AppSource o come estensione per tenant. Durante lo sviluppo in Visual Studio Code è possibile continuare a usare la stessa versione e iterare il codice.