SNIPPET

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 la création de scripts dans des snippets.
• Les attributs des objets ne peuvent pas être nommés __type (avec deux traits de soulignement). Ce mot est réservé pour être utilisé lors de l'analyse de JSON à partir d'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.  La limite s’applique de manière stricte pour éviter toute instabilité et panne du cluster. Si vous le pouvez, utilisez plutôt l’action REST API. Elle présente la même limite, mais peut traiter une charge plus élevée. Si vous devez absolument utiliser l’action SNIPPET, suivez ces conseils 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 génération de rapports NICE pour obtenir des contacts, vous pouvez filtrer les résultats en fonction des champs startDate et endDate du contact. Cet appel d’API vous permet également de renvoyer un nombre maximal d’éléments. Reportez-vous à la documentation de l’API associée à votre intégration de script pour déterminer les filtres que vous pouvez utiliser.

  • Mettez à jour la requête d’API pour renvoyer uniquement les données dont vous avez besoin. Par exemple, si vous utilisez l’API de génération de rapports NICE pour obtenir des contacts, vous pouvez utiliser les champs contactId ou agentId pour renvoyer uniquement les données pertinentes. Reportez-vous à la documentation de l’API associée à votre intégration de script pour déterminer les limites de données que vous pouvez utiliser.

  • Si vous ne pouvez exécuter aucune des options précédentes, créez un middleware.

Types de scripts pris en charge

Générique	Email	Conversation	Téléphone	Messagerie vocale	Élément de travail	SMS	Digital

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	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’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 , de diverses instructions de contrôle de flux et de fonctions intégrées ou définies par l'utilisateur.
MaxStringSize	Définit la taille de chaîne maximale pour toutes les commandes dans la propriété Data. Les options sont Limit2K, Limit4K, Limit8K, Limit16K et Limit32K. Cette limite s'applique aux réponses d'intégration avec les API Rest et SOAP.

Conditions de branche résultantes

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 parcouru sauf si le script remplit une condition qui l'oblige à emprunter l'une des autres branches. Il est également suivi 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, comme une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un caractère de soulignement simple, doit contenir 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 type chaîne dans les propriétés d’autres actions Studio lorsque vous devez transmettre les données JSON. Cette approche évite le risque d'erreurs de validation lors de l'enregistrement du script.
• Si vous réglez un système IVR 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 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 jeu de paramètres que vous pouvez utiliser dans les snippets.
• Le langage Snippet fournit des commandes de 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 plus encore.
• Studio possède des fonctions intégrées que vous pouvez utiliser dans vos scripts.
• Vous pouvez créer vos propres des fonctionnalités personnalisées afin de les utiliser dans des snippets.
• Vous pouvez tester et déboguer du code snippet 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. Ces 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. Ces onglets sont les suivants :

• L'onglet Vue Texte. Il s'agit d'un champ de texte libre où vous pouvez entrer le 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 au snippet.

Exemple de script

Dans cet exemple simple, le code dans le Snippet est utilisé pour tester si un prospect peut être créé à l'aide d'informations provenant d'un système tiers.

Téléchargez ce scénario.