---
sourceDocument: Australie Gestion de la relation client pour les ventes
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/order-management

 Release :

    - australia

ft:locale :

    - fr-FR

ft:publication_title :

    - Australie Gestion de la relation client pour les ventes

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Scripts

# Scripts {#ariaid-title1}

* Rversion finale: Australia
* 
* Mis à jour 12 mars 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Découvrez comment le scripting va au-delà CPQ des règles simples : découvrez où les scripts s'exécutent, ce qu'ils renvoient et comment les utiliser pour modéliser une logique de configuration avancée de manière sûre et efficace.
Le scripting est plus efficace CPQ lorsque la logique de configuration nécessite plus de flexibilité que de simples règles. Les administrateurs peuvent utiliser des scripts pour calculer des valeurs complexes, évaluer des conditions ou manipuler dynamiquement les données produit. Des scripts sont disponibles dans les conditions de règle, les actions et les enrichissements de plan pour l'initialisation, la validation ou la tarification.

Le scripting complète, mais ne remplace pas, les options déclaratives. Utilisez d'abord les règles standard, les extensions de liste déroulante et les sélecteurs de produits. Réservez le scripting aux scénarios spécialisés.

## Où pouvez-vous utiliser des scripts {#scripts__section_rsk_1sy_ghc}

* Conditions de règle : Renvoie `vrai` ou `faux` pour déterminer si les actions s'exécutent.
* Actions de règle : définissez des valeurs de champ, masquez ou affichez des éléments ou créez des listes de produits de manière dynamique.
* Enrichissements de plans : initialisez les données, appelez des systèmes externes ou enrichissez les configurations lors d'événements \<\< À la configuration \>\> ou \<\< Reconfiguration \>\>.
{#scripts__ul_uhs_bsy_ghc}

Chaque type de script nécessite une valeur de retour spécifique pour garantir des résultats prévisibles.

## Valeurs de retour attendues {#scripts__section_t4f_dsy_ghc}

{#scripts__table_iry_dsy_ghc__entry__3}

| Type de script | Format de retour | Exemple |
|-|-|-|
| Condition avancée | Booléen | `vrai` ou `faux` |
| Masquage avancé | Chaîne | `<< field_to_hide >>` |
| Détermination du champ | Dépend du type de champ | Nombre → `5` ; Le texte → `<< Rouge >>` ; Sélection multiple → ["Option1", "Option2"] |
| Inclusion et exclusion | Tableau | `["OptionA >>, << OptionB"]` |
| Action du produit | Objet ProductList | `ProductList.add({id :"123 >>, qté :2})` |
| Enrichissement | Objet de configuration mis à jour | `renvoyer cfgRequest ;` |
[Tableau 1. Valeurs de retour attendues]

{#scripts__table_iry_dsy_ghc}

## Objets de configuration {#scripts__section_llw_3sy_ghc}

Les scripts interagissent avec les objets de configuration suivants :

* `cfg` : instantané en lecture seule des valeurs de champ actuelles utilisées par les règles.
* `cfgRequest` : un objet accessible en écriture disponible dans Enrichments ; Utilisez `.set(<< value >>, x)` pour modifier les champs.
* `Liste de produits` : Utilisé pour ajouter ou modifier des éléments dans la nomenclature (BOM).

{#scripts__ul_uvx_jsy_ghc}

Vous pouvez référencer les propriétés à l'aide de la notation à points ou entre parenthèses (`cfgRequest.fieldName` ou `cfgRequest["fieldName"]).`

## Utilisation de données externes {#scripts__section_vxc_lsy_ghc}

Utilisez les données externes pour améliorer les configurations de manière dynamique :

* Tables gérées : interrogez les données avec `lookup()` pour mapper les résultats dans des champs ou des produits.
* Connexions externes : effectuez des appels approuvés (par exemple, des requêtes SOQL vers Salesforce) pour renseigner les ensembles ou les valeurs de champ dans les enrichissements.

{#scripts__ul_udg_msy_ghc}

Ces techniques réduisent la logique codée en dur et centralisent la gestion des données.

## Débogage et test {#scripts__section_qzg_nsy_ghc}

L'interface de scripting comprend des outils intégrés :

* Suggestions de code : saisie automatique pour les fonctions, les variables et les champs.
* Panneau d'aide : répertorie toutes les fonctions et paramètres pris en charge avec des exemples.
* Débogueur : accepte l'entrée JSON et affiche les résultats de sortie et `console.log().` Enregistrez les entrées de test courantes sous forme de commentaires pour réutilisation.
{#scripts__ul_kb5_4sy_ghc}

## Directives générales {#scripts__section_dtx_rsy_ghc}

* Préférez les règles déclaratives lorsque cela est possible.
* Gardez les scripts concis et concentrés sur une seule tâche.
* Toujours renvoyer le type de données attendu.
* Utilisez des noms de variables et des commentaires clairs.
* Évitez la logique imbriquée ou conditionnelle longue : utilisez plutôt des tables ou des connexions externes.
{#scripts__ul_egh_ssy_ghc}
**Concepts associés**   

* [Créer des scripts](https://servicenow-prod.fluidtopics.net/jhtl7OeRBAM91lgJKkJxaw "Apprenez à créer des fonctions avancées à l’aide de l’interface de scripting.")