Utiliser des actions de code AL

Effectué

L’extension AL Language permet aux utilisateurs de résoudre les problèmes dans le code. 

Actions de code est une fonctionnalité de Visual Studio Code qui fournit à l’utilisateur des actions correctives possibles juste à côté d’une erreur ou d’un avertissement. Si des actions sont disponibles, une ampoule s’affiche en regard de l’erreur ou de l’avertissement. Lorsque l’utilisateur clique sur l’ampoule (ou appuie sur Ctrl + .), une liste d’actions de code disponibles s’affiche. Une action de code est applicable à une instance unique ou à une étendue plus grande selon le type d’action.

Dans l’extension AL Language, ces actions de code sont disponibles dans la version actuelle :

  • Conversion multiple IF en CASE

  • Vérification orthographique

  • Outil d’implémentation d’interface

  • Rendre la méthode locale

  • Utiliser des parenthèses pour le correctif d’appel de méthode pour une instance, un document, un projet ou un espace de travail

  • Correctif explicite avec des instructions

  • Correctif implicite avec des instructions

  • Correction de l’ancienne présentation d’état et remplacement par la section de présentation du rendu

  • Correctif pour AW0013

  • Convertissez des pages ou extensions de page afin d’utiliser la syntaxe actionRef pour les actions promues sur la barre d’actions. Correctif pour une instance, un document, un projet ou un espace de travail. 

Activer les actions de code AL

  1. Ouvrez la palette de commandes en appuyant sur Ctrl + Maj + P, puis le fichier settings.json.

  2. Saisissez le paramètre al.enableCodeActions et définissez-le sur true comme suit : "al.enableCodeActions": true.

  3. Enregistrez le fichier des paramètres. Vous avez maintenant activé les actions de code sur votre projet.

Autre méthode disponible

  1. Ouvrez la page Paramètres, appuyez sur Ctrl + , et choisissez Paramètres utilisateur ou Paramètres de l’espace de travail selon l’étendue à laquelle vous souhaitez que les actions de code s’appliquent.

  2. Accédez à Extensions > Configuration de l’extension AL Language.

  3. Cochez la case Activer les actions de code. Vous avez maintenant activé les actions de code sur votre projet.

Certaines actions de code ont du sens pour s’exécuter dans un contexte plus global que pour l’instance uniquement. Si l’action de code prend en charge l’option, il est possible de l’exécuter sur la manifestation spécifique à partir de laquelle elle est déclenchée, dans le document à partir duquel elle est déclenchée, dans le projet à partir duquel elle est déclenchée ou sur l’ensemble de l’espace de travail. Ainsi, les développeurs peuvent refactoriser le code plus rapidement et plus efficacement sur une étendue source plus grande sans avoir à accéder à chaque manifestation spécifique pour y déclencher l’action de code.

Dans la 2e vague de lancement 2022, les actions de code suivantes prennent en charge l’exécution dans de plus grandes étendues :

  • Convertir des actions promues

  • AA0008 - Ajouter une parenthèse

  • AA0241 - En minuscules

Exemples d’actions de code AL

L’action de code Vérification orthographique est déclenchée sur certaines erreurs de syntaxe :

Capture d’écran de l’action de code Vérification orthographique.

L’action Rendre la méthode locale est déclenchée pour corriger l’avertissement CodeCop AA0207 :

Capture d’écran de l’action Rendre la méthode locale.

L’action de code vous permet de convertir la syntaxe héritée pour les actions promues en syntaxe actionref, qui est introduite dans la 2e vague de lancement 2022 de Business Central. Les personnalisations dans le client, la personnalisation utilisateur et les configurations de profil sont converties automatiquement dans la nouvelle syntaxe, donc cela s’applique principalement aux extensions de développement. L’action de code peut s’appliquer à une seule instance, au document, au projet ou à l’espace de travail.

Capture d’écran de l’action de code.

Pour les extensions de concepteur, appuyez sur F6 pour ouvrir le Concepteur et la page où la syntaxe héritée est utilisée. Cliquez sur le symbole de cadenas et convertissez automatiquement la syntaxe héritée du code d’exécution à l’aide de l’action Déverrouiller la page. Appuyez sur Alt + F6 pour revenir dans Visual Studio Code et afficher le code actionref converti.