Esercizio - Impostazione dell'ambiente di sviluppo

  • 10 minuti

Scenario

Per iniziare a scrivere estensioni per Business Central, sono necessari un tenant Dynamics 365 Business Central, Visual Studio Code e l'estensione AL Language. Visual Studio Code è un editor multipiattaforma che si utilizza per la codifica e il debug.

Impostazione di un ambiente sandbox

Per impostare un ambiente sandbox, effettuare i seguenti passaggi:

  1. Iscriversi a una sandbox Dynamics 365 Business Central.

  2. Seguire il processo di registrazione e attendere che l'ambiente Business Central sia pronto.

  3. Aprire l'interfaccia di amministrazione scegliendo il collegamento Interfaccia di amministrazione nel menu Impostazioni una volta effettuato l'accesso a Business Central.

  4. Nella scheda Ambienti dell'interfaccia di amministrazione di Business Central scegliere l'azione Nuovo sulla barra multifunzione delle azioni.

  5. Nel riquadro Crea ambiente specificare un nome per il nuovo ambiente, ad esempio Sandbox.

  6. Nell'elenco Tipo di ambiente scegliere Sandbox.

  7. Dall'elenco Paese selezionare il Paese per l'ambiente. Il Paese specificato determina la localizzazione per l'ambiente e l'area di Azure in cui l'ambiente viene creato e memorizzato.

  8. Nell'elenco Versione specificare la versione dell'applicazione pertinente per il nuovo ambiente, se è disponibile più di una versione.

  9. Scegliere l'azione Crea.

  10. Il nuovo ambiente sandbox non sarà accessibile fino a quando il campo Stato non viene visualizzato come Attivo.

  11. Una volta creato, aprire il nuovo ambiente sandbox.

Per impostare l'ambiente di sviluppo, effettuare i seguenti passaggi:

  1. ScaricareVisual Studio Code.

  2. Scaricare l'estensione AL Language.

Per creare una nuova app, effettuare i seguenti passaggi:

  1. Premere i tasti di scelta rapida ALT+A, ALT+L per attivare il comando AL Go!. quindi scegliere un percorso per una nuova cartella vuota e la versione da eseguire.

  2. Usare CustomerRewards come nome del progetto

  3. Selezionare Microsoft cloud sandbox come server.

  4. Inserire le credenziali fornite durante l'iscrizione.

  5. Il sistema ora scarica i simboli.

    In caso di errori, aggiornare il file launch.json e assicurarsi che il parametro EnvironmentName corrisponda esattamente al nome della sandbox, quindi scaricare nuovamente i simboli.

    • In un progetto AL ci sono due file JSON, il file app.json e il file launch.json che vengono generati automaticamente all'avvio di un nuovo progetto. Il file app.json contiene informazioni sull'estensione 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 launch.json contiene informazioni sul server su cui viene avviata l'estensione.

  6. Premere il tastoF5 o CTRL+F5per distribuire ed eseguire l'estensione sul tenant sandbox online.

Ora si ha un esempio di HelloWorld per la compilazione e l'esecuzione.

In un'estensione, i file .al devono essere archiviati in una cartella denominata src. Pertanto si procederà come prima cosa alla rimozione del file HelloWorld.al e alla creazione della cartella src.

Per preparare le cartelle, attenersi ai seguenti passaggi:

  1. Eliminare il file HelloWorld.al

  2. Creare una nuova cartella denominata src