SNIPPET

Cette page d’aide concerne CXone Studio. Cette information est également disponible pour Desktop Studio.

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’action REST API . 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

Un carré d’où part une ligne qui va vers trois autres carrés.

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

Ajouter Légende

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.

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.

Max String Size

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.

Erreur

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

Fenêtre Snippet Editor

La fenêtre Snippet editor s’ouvre lorsque vous sélectionnez une action Snippet et que vous cliquez sur Ouvrir l’éditeur dans les propriétés de l’action.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s’agit pas d’un texte complet. Des scripts supplémentaires peuvent être nécessaires.

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.

Un script avec deux actions EXTRAIT DE CODE.

Téléchargez ce scénario.