Créer des scripts
Apprenez à créer des fonctions avancées à l’aide de l’interface de scripting.
Certains cas d’utilisation nécessitent une condition ou une action avancée. Dans d’autres cas, l’administrateur peut préférer le script à l’utilisation de règles simples. Pour ces occasions, CPQ offre la possibilité d’écrire des scripts dans des domaines clés.
Le scripting est disponible dans les actions et conditions de règle, derrière le choix ou le bouton bascule du menu Avancé.
Lorsque vous cliquez sur Créer une fonction avancée, l’éditeur de script s’ouvre, y compris les outils dont vous avez besoin pour écrire un script.
Lorsque l’éditeur de script s’ouvre pour la première fois, il fournit le format de retour attendu du script.
- Les conditions avancées renvoient vrai ou faux.
- Les règles de masquage avancées renvoient une chaîne de texte.
- Les règles de détermination avancée renvoient le type de champ qu’elles définissent.
- Une règle de détermination qui définit un nombre renvoie un nombre.
- Une règle de détermination qui définit une liste déroulante à sélection multiple renvoie un tableau.
- Les règles avancées d’inclusion et d’exclusion renvoient un tableau.
- Les règles de produit renvoient ProductList.
Pour plus de détails et un exemple de script, consultez la section « Actions avancées sur les produits » de Règles.
Le ? Le bouton Aide ouvre un menu des fonctions disponibles. Chaque entrée comprend une description de la fonction, les paramètres qu’elle accepte, sa sortie et un exemple qui peut être inséré à l’emplacement actuel du curseur dans le script.
Au fur et à mesure que vous tapez dans l’éditeur de script, des suggestions sont fournies, notamment des fonctions, des noms de variables de champ configurables et des variables locales. L’utilisation de cette fonctionnalité permet d’éliminer les noms de variables non correspondants et les erreurs de frappe. Dans la capture d’écran ci-dessous, taper Ma donne à l’utilisateur deux fonctions disponibles (Carte et Mathématiques) et une liste de tous les champs correspondants. Des entrées supplémentaires réduisent la liste des options de correspondance.
En bas de l’interface de scripting, le débogueur vous permet de tester votre script en définissant des valeurs pour les variables (champs) qu’il référence. L’entrée du débogueur est fournie au format JSON. Pour plus de commodité, consultez les formats spécifiques aux champs dans l’aide des informations sur les champs (flèche).
Il peut être utile d’enregistrer les entrées de votre débogueur sous forme de commentaires dans votre script pour faciliter le collage dans le débogueur lorsque vous devez tester le script.
Les appels à console.log() dans le script sont renvoyés dans la sortie du débogueur.