Exercice : configurer l’environnement de développement

  • 10 minutes

Scénario

Pour commencer à écrire des extensions pour Business Central, vous aurez besoin d’un abonné Dynamics 365 Business Central, de Visual Studio Code et de l’extension AL Language. Visual Studio Code est un éditeur multiplateforme qui sert pour le codage et le débogage.

Configurer un environnement de bac à sable

Pour configurer un environnement de bac à sable, procédez comme suit :

  1. Inscrivez-vous pour bénéficier d’un bac à sable Dynamics 365 Business Central.

  2. Suivez le processus d’inscription et attendez que l’environnement Business Central soit prêt.

  3. Ouvrez le Centre d’administration en cliquant sur le lien Centre d’administration dans le menu Paramètres lorsque vous êtes connecté à Business Central.

  4. Dans l’onglet Environnements du Centre d’administration Business Central, choisissez l’action Nouveau dans le ruban d’action.

  5. Dans le volet Créer un environnement, spécifiez un nom pour le nouvel environnement, par exemple Bac à sable.

  6. Dans la liste Type d’environnement, choisissez Bac à sable.

  7. Dans la liste Pays, sélectionnez le pays pour l’environnement. Le pays spécifié détermine la localisation de l’environnement et la région Azure dans laquelle l’environnement est créé et stocké.

  8. Dans la liste Version, spécifiez la version de l’application pertinente pour le nouvel environnement si plusieurs versions sont disponibles.

  9. Choisissez l’action Créer.

  10. Le nouvel environnement n’est accessible que lorsque l’État indique Actif.

  11. Lorsque le nouvel environnement de bac à sable est prêt, ouvrez-le.

Pour configurer l’environnement de développement, procédez comme suit :

  1. TéléchargezVisual Studio Code.

  2. Téléchargez l’extension AL Language.

Pour créer une application, procédez comme suit :

  1. Utilisez les raccourcis clavier Alt+A, Alt+L pour déclencher la commande AL Go!, puis choisissez un chemin d’accès à un nouveau dossier vide et la version à exécuter.

  2. Utilisez CustomerRewards comme nom du projet.

  3. Sélectionnez Bac à sable cloud Microsoft comme serveur.

  4. Saisissez les informations d’identification que vous avez fournies lors de l’inscription.

  5. Le système télécharge alors les symboles.

    En cas d’erreur, mettez à jour votre fichier launch.json et assurez-vous que le paramètre EnvironmentName correspond exactement au nom de votre bac à sable, puis téléchargez à nouveau les symboles.

    • Dans un projet AL, il existe deux fichiers JSON : le fichier app.json et le fichier launch.json, qui sont générés automatiquement lorsque vous démarrez un nouveau projet. Le fichier app.json contient des informations sur l’extension que vous créez, comme des informations sur l’éditeur, et indique la version minimale des objets d’application de base sur laquelle s’appuie l’extension. Le fichier app.json est souvent appelé manifeste. Le fichier launch.json contient des informations sur le serveur sur lequel l’extension est lancée.

  6. Utilisez le raccourci clavierF5 ou Ctrl+F5pour déployer et exécuter l’extension sur votre abonné de bac à sable en ligne.

Vous obtenez un exemple HelloWorld qui est compilé et s’exécute.

Dans une extension, les fichiers .al doivent être stockés dans un dossier nommé src. Par conséquent, nous allons d’abord supprimer le fichier HelloWorld.al et créer le dossier src.

Pour préparer les dossiers, procédez comme suit :

  1. Supprimez le fichier HelloWorld.al.

  2. Créez un dossier nommé src.