Utilisation des commentaires et de la console pour déboguer les scripts

Découvrez comment les commentaires et la console peuvent vous aider à déboguer vos scripts.

CPQ dispose de plusieurs zones où l’administrateur peut utiliser des scripts pour définir le comportement. Il s’agit notamment des conditions avancées pour les règles, des actions avancées pour les règles et des enrichissements.

Conditions avancées pour les règles

Actions avancées pour les règles

Enrichissements

Cet article met en évidence quelques fonctionnalités clés pour vous aider à tester et à préparer votre code avant de le déployer dans un plan.

Remarque :

Le langage de script est de CPQ type JavaScript, ce qui signifie qu’il suit la syntaxe de style JavaScript mais ne dispose pas de toutes les capacités de JavaScript.

Console.log

Lorsque l’administrateur commence à écrire un script, il CPQ ressemble à ceci :

Cliquez sur Exécuter le débogueur dans le panneau inférieur pour afficher le débogueur et la section Sortie du débogueur. Cette section est également appelée console.

Cette zone affiche la sortie du script en fonction du script et des entrées ajoutées au débogueur (le cas échéant). Par exemple, le script d’enrichissement BOM affiche la nomenclature mise à jour en fonction de l’enrichissement et des entrées placées dans le débogueur.

Des lignes de code peuvent être enregistrées dans la console. Ainsi, vous pouvez envoyer du texte à la console, comme dans ce qui suit :

Vous pouvez également journaliser des variables, ce qui est utile pour vous assurer que votre script fonctionne correctement. Vous pouvez ajouter du texte au journal pour aider les lignes de code à se démarquer :

Commentaires

Les commentaires sont des lignes de code que le script ignore. Les commentaires ont plusieurs utilisations. Tout d’abord, il est très utile pour les futurs codeurs (et pour vous, lorsque vous revisiterez le code beaucoup plus tard) si vous avez commenté comment et pourquoi vous avez codé des lignes du script comme vous l’avez fait. L’ajout de commentaires peut également être utilisé pour enregistrer le code à réutiliser. Et si vous n’utilisez pas un bloc de code mais que vous souhaitez l’utiliser plus tard, vous pouvez le commenter afin qu’il n’affecte pas votre travail actuel.

Vous pouvez écrire des commentaires sur une seule ligne ou sur plusieurs lignes.

Pour ajouter des commentaires d’une seule ligne, utilisez deux barres obliques. Tout ce qui est écrit après les barres obliques sur la même ligne est ignoré par le script.

Ce commentaire est ignoré par le script

Cependant, tout code avant les barres obliques est toujours exécuté. Par exemple, dans l’image ci-dessous, la variable be4comment reste 12345, car le script ignore le commentaire « 67890 » qui suit les barres obliques.

Pour créer un commentaire multiligne, ajoutez une barre oblique et un astérisque avant le commentaire. Ajoutez un astérisque et une barre oblique après le commentaire.

/*
Your comment goes here.
It can span multiple lines.
*/

Lorsque vous ajoutez un commentaire multiligne, veillez à ne pas commenter des éléments importants tels que des crochets fermants, des parenthèses ou des instructions de retour.

Lorsque vous revoyez ou modifiez fréquemment une règle qui prend des entrées de nombreux autres champs, il peut être utile de coller l’entrée dans la section du débogueur en tant que commentaire multiligne. De cette façon, lorsque vous reviendrez travailler sur la règle plus tard, vous n’aurez pas besoin de réécrire les entrées.

/* inputs
{"Field1": "testValue1",
    "Field2Quantity": 2,
      "Field3": "testValue3"
    },
*/