SNIPPET

Vous permet d’ajouter du code personnalisé à votre script.

Dépendances

• Le code utilisé dans cette action doit être écrit en Snippet, un langage de script interne développé par NICE CXone. Le guide de référence technique Studio fournit des informations détaillées sur les scripts dans les extraits de code.
• Les attributs des objets de données dynamiques ne peuvent pas être nommés __type (avec deux traits de soulignement). Ce mot est réservé à l’analyse JSON des objets dynamiques.
• Vous pouvez effectuer des appels API à l’aide de l’action Snippet. La taille maximale de la réponse est de 32 ko. Ceci est cohérent avec la limite de taille de la réponse dans l’action REST API.  Cette limite est strictement appliquée pour éviter l’instabilité des clusters et les pannes. Si vous le pouvez, utilisez plutôt l’ REST API action. Elle a la même limite, mais peut prendre en charge une charge plus lourde. Si vous devez utiliser l’action SNIPPET, suivez les conseils suivants pour réduire la taille des données renvoyées :

  • Filtrez les données dans la réponse de l’API. Par exemple, si vous utilisez l’API de rapports NICE pour obtenir des contacts, vous pouvez filtrer les résultats en fonction de la startDate et de la endDate du contact. Cet appel API vous permet également de renvoyer et de limiter le nombre d’éléments en tête de liste. Reportez-vous à la documentation de l’API fournie avec votre intégration de script pour déterminer le filtrage que vous pouvez utiliser.

  • Mettez à jour la demande d’API pour qu’elle ne renvoie que les données dont vous avez besoin. Par exemple, si vous utilisez l’API de rapports NICE pour obtenir des contacts, vous pouvez utiliser les champs contactId ou agentId pour ne renvoyer que les données pertinentes. Reportez-vous à la documentation de l’API fournie avec votre intégration de script pour déterminer les limites de données que vous pouvez utiliser.

  • Si vous ne pouvez pas faire l’une ou l’autre des options précédentes, construisez un intergiciel.

Types de scripts pris en charge

Générique	courriel	Clavardage	Téléphone	Messagerie vocale	Élément de travail	SMS	Numérique

Propriétés d’entrée

Ces propriétés définissent les données que l’action utilise lors de son exécution.

Propriété	Description
Caption	Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action. The default is the action name.
Data	Contient le code personnalisé ajouté dans la fenêtre Snippet editor. Il peut s’agir de plusieurs commandes ASSIGN et DYNAMIC, d’un assortiment de instructions de contrôle de flux et de fonctions intégrées ou définies par l’utilisateur.
MaxStringSize	Définit la taille maximale de la chaîne de caractères pour toutes les commandes dans la propriété Data. Les options sont les suivantes : Limit2K, Limit4K, Limit8K, Limit16K, Limit32K. Cette limite s’applique aux réponses d’intégration avec les API Rest et SOAP.

Conditions de la branche de résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l’exécution d’une action.

Condition	Description
Default	Chemin emprunté à moins que le script ne remplisse une condition exigeant qu’il prenne l’une des autres branches. Elle est également prise si les autres branches de l’action ne sont pas définies.
OnError	Chemin emprunté lorsque l’action ne s’exécute pas correctement. Par exemple, en cas de problème inattendu tel qu’une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un seul caractère de soulignement, doit être remplie avec une explication condensée du problème.

Conseils & Astuces

• Utilisez la fonction asjson() dans une action Snippet et stockez le JSON résultant dans une variable de type chaîne. Utilisez la variable de chaîne dans les propriétés d’autres actions Studio lorsque vous devez transmettre les données JSON. Cette approche évite la possibilité d’erreurs de validation lors de l’enregistrement du script.
• Si vous réglez un système SRVI Menu téléphonique automatisé qui permet aux appelants d’interagir via des commandes vocales, des entrées de touches ou les deux pour obtenir des informations, acheminer un appel vocal entrant, ou les deux. compatible avec ASR Permet aux contacts de répondre aux invites vocales enregistrées en parlant, en appuyant sur les touches de leur téléphone ou en combinant les deux., il existe un ensemble de paramètres que vous pouvez utiliser dans les extraits de code.
• Le langage Snippet fournit des commandes avec des mots-clés qui vous permettent de déclarer des variables et des objets, de créer des boucles et des instructions itératives, et bien d’autres choses encore.
• Studio dispose de fonctions intégrées que vous pouvez utiliser dans vos scripts.
• Vous pouvez créer vos propres fonctions personnalisées à utiliser dans les extraits de code.
• Vous pouvez tester et déboguer des extraits de code dans la fenêtre Snippet editor .

Fenêtre Snippet Editor

La fenêtre Snippet editor s’ouvre lorsque vous double-cliquez sur une action Snippet.

La fenêtre Snippet editor de l’action Snippet comporte deux onglets. Les deux onglets permettent de créer les mêmes types de code. Vous pouvez passer d’un onglet à l’autre et modifier votre code dans l’un ou l’autre. Les onglets sont les suivants :

• L’onglet Vue textuelle. Il s’agit d’un champ de texte libre dans lequel vous pouvez saisir votre code manuellement.
• L’onglet Arborescence. Il s’agit d’une interface graphique que vous pouvez utiliser pour construire votre code. Cet onglet contient une liste de mots-clés que vous pouvez sélectionner pour ajouter des instructions à l’extrait de code.

Exemple de script

Dans cet exemple simple, le code du Snippet est utilisé pour vérifier si un contact éventuel peut être créé à l’aide d’informations provenant d’un système tiers.

Téléchargez ce scénario.