Utiliser l’association et déboguer à l’aide de configurations d’association

  • 5 minutes

Comme avec le débogueur d’instantané, associez le débogueur AL à une session existante en cours d’exécution ou à la session suivante pour l’utilisateur concerné. Dans les deux cas, il est configuré en spécifiant un ID de session ou un ID utilisateur dans la configuration d’association launch.json.

De plus, un nouvel ensemble d’autorisations Débogage d’association est disponible pour permettre le débogage entre utilisateurs.

Si vous ne souhaitez pas publier et appeler la fonctionnalité pour la déboguer, vous pouvez plutôt associer une session à un serveur spécifié. Attendez ensuite qu’un processus déclenche le point d’arrêt que vous avez défini. Le débogage démarre alors lorsque le code sur lequel le point d’arrêt est défini est atteint.

Pour utiliser la fonctionnalité d’association, vous devez d’abord vous assurer que votre application est publiée avec Ctrl + F5 ou Alt + Ctrl + F5 pour la publication RAD avant de démarrer la session de débogage avec F5. La création d’une session serveur à partir du client peut être réalisée, par exemple en lançant une nouvelle session client. Appuyer sur F5 (Actualiser) dans un navigateur peut ne pas créer de session serveur, car elle est mise en cache, mais si une session est arrivée à expiration et actualisée, une session est alors créée.

Seul l’utilisateur qui démarre une session d’association Visual Studio Code peut émettre la requête web sur le serveur.

Vous pouvez activer la fonctionnalité d’association en créant une configuration dans le fichier launch.json. La configuration offre deux options :

  • Associer au client sur le bac à sable cloud

  • Associer au client sur votre serveur

La première option vous permet d’effectuer l’association à une session cloud et la deuxième, l’association à un serveur local.

Avec la première vague de lancement 2023 de Business Central, deux nouvelles propriétés sont ajoutées à la configuration de lancement : sessionId et userId, qui permettent l’association à une session en cours et le débogage pour le compte d’un autre utilisateur.

Dans la configuration d’association, le paramètre breakOnNext, qui n’autorise qu’une seule option, spécifie le prochain client sur lequel s’effectuera l’arrêt lors du démarrage de la session de débogage. Voici les options disponibles :

  • WebServiceClient

  • WebClient

  • Contexte

Deux autres propriétés importantes sont sessionId et userId. sessionId indique une session en cours de type spécifié dans breakOnNext. Cette session doit appartenir à l’utilisateur dans la propriété userId si spécifiée.

Si sessionId n’est pas spécifiée, mais que userId l’est, le débogueur s’associe à la prochaine session de type spécifié dans breakOnNext pour l’utilisateur donné.

Si userId est un utilisateur différent de l’utilisateur connecté à Visual Studio Code, l’utilisateur connecté à Visual Studio Code doit faire partie de l’ensemble d’autorisations DÉBOGAGE D’ASSOCIATION D365.

Le débogueur peut se connecter à des sessions en arrière-plan, et non à des tâches en arrière-plan.

Cet exemple illustre une configuration pour un serveur local :

{
            "name": "My attach to local server",
            "type": "al",
            "request": "attach",
            "server": "https://localhost",
            "serverInstance": "BC200",
            "authentication": "Windows",
            "breakOnError": true,
            "breakOnRecordWrite": false,
            "enableSqlInformationDebugger": true,
            "enableLongRunningSqlStatements": true,
            "longRunningSqlStatementsThreshold": 500,
            "numberOfSqlStatements": 10,
            "breakOnNext": "WebClient"
        }

Démarrer une session d’association

Pour démarrer une session d’association, procédez comme suit :

  1. Dans Visual Studio Code, cliquez sur Ajouter une configuration sous Exécuter.

  2. Choisissez d’effectuer l’association à une session cloud ou locale. Le fichier launch.json est maintenant renseigné avec les paramètres de configuration d’association appropriés. Si vous avez sélectionné une session locale, modifiez les paramètres par défaut pour pointer vers votre serveur local dans les paramètres server et serverInstance.

  3. Définissez la propriété breakOnNext pour spécifier le type de client sur lequel s’effectue l’arrêt.

  4. Dans votre code, définissez au moins un point d’arrêt à l’aide de l’icône Exécuter dans la barre d’outils, cliquez sur Nouveau point d’arrêt, puis choisissez le type de point d’arrêt à ajouter. Vous pouvez ajouter des points d’arrêt supplémentaires lors du débogage.

  5. Si votre application la plus récente n’est pas encore publiée, veillez à la publier en appuyant sur Ctrl + F5 ou Alt + Ctrl + F5 pour la publication RAD. Ensuite, appuyez sur F5 pour démarrer la session d’association. Si vous modifiez le code de l’application pendant la session de débogage, veillez à republier l’application à l’aide de Ctrl + F5.

  6. Après avoir publié l’application, appuyez sur F5 pour démarrer une session de débogage. Si vous avez plusieurs paramètres de configuration d’association, vous devez d’abord sélectionner la configuration à démarrer.

  7. Déboguez et inspectez le code. Vous pouvez ajouter des points d’arrêt supplémentaires lors du débogage.

  8. Arrêtez la session de débogage d’association en sélectionnant Dissocier dans la barre d’outils Visual Studio Code.