SNIPPET

Cette page d'aide concerne CXone Studio. Ces informations sont également disponibles pour Desktop Studio.

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

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

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

Ajouter une légende

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.

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.

Max String Size

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.

Erreur

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

Fenêtre Snippet Editor

La fenêtre Snippet editor s’affiche lorsque vous sélectionnez une action Snippet et que vous cliquer 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 script complet. Une rédaction de script supplémentaire peut être requise.

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.

Un script avec deux actions SNIPPET.

Téléchargez ce scénario.