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é pour NiCE CXone. Le guide de référence technique Studio fournit des informations détaillées sur l'écriture de scripts dans les Extraits.
• Les attributs des objets ne peuvent pas être nommés __type (avec deux traits de soulignement). objets dynamiques.
• Vous pouvez effectuer des Appels API à l'aide de l'action Snippet. Toutefois, il ne s'agit pas de la méthode recommandée pour effectuer des Appels API dans vos Scripts. Si vous les effectuez de cette manière, veillez à bien comprendre les risques et bonnes pratiques.
• La taille maximum des tableaux dans Studio est de 63 millions d'éléments. Si cette taille de tableau est dépassée, cela entraîne l'erreur suivante dans la variable __err dans une trace de script: Index de tableau hors limites. L'index de Tableau actuel ([index]) dépasse l'index maximum autorisé (63000000). Lorsque la taille maximale du tableau est dépassée, le script suit la branche Error de l'action SNIPPET. Si la branche Error n'est pas connectée, le script continue de s'exécuter, mais sans les informations du tableau. Vous pouvez configurer les scripts pour qu'ils vous avertissent lorsque la taille maximale du tableau a été dépassée en ajoutant une action EMAIL à la branche Error de l'action SNIPPET. Enfin, vous pouvez ajouter une logique dans la branche Error pour poursuivre le script. Notez qu'il se poursuivra sans les informations du tableau.

• The maximum response size in NiCE CXone is 32 KB. The limit is strictly enforced to prevent cluster instability and outages. Studio enforces this limit when saving the script, but Desktop Studio does not. If you can, use the REST API action or Integration Hub instead of the SNIPPET action to make API calls. They have the same limit, but can handle a heavier load. If you must use the SNIPPET action, follow these tips to reduce the size of the returned data: 

  • Filtrer les données dans la réponse API : Par exemple, si vous utilisez l'API Reporting NiCE pour obtenir des contacts, vous pouvez filtrer les résultats par startDate et endDate du contact. Cet Appel API vous permet également de renvoyer et de limiter un nombre haut d'éléments. Reportez-vous à la documentation de l'API fournie avec votre intégration de script pour déterminer les filtres que vous pouvez utiliser.

  • Mettez à jour la demande API pour renvoyer uniquement les données dont vous avez besoin : Par exemple, si vous utilisez l'API de création 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.

  • Créer un middleware : Si vous ne pouvez effectuer aucune des deux options précédentes, créez un middleware qui effectue des filtres en fonction de critères personnalisés que vous définissez. Si vous procédez ainsi, assurez-vous que votre middleware n'ajoute pas de latence à l'appel.

• ```

  Chaque boucle FOR, FOREACH ou REPEAT au sein d'un SNIPPET est protégée par une limite de temps de 500 ms. Si une boucle dépasse cette limite, l'action SNIPPET prend la branche d'erreur avec l'erreur Too much time has elapsed. Cela évite l'utilisation excessive des ressources système pour les boucles incontrôlées. La limite de temps de 500 ms s'applique uniquement au travail côté script, y compris les affectations, les opérations arithmétiques, les conditions, l'accès aux tableaux, etc. Elle ne s'applique pas à l'exécution de bout en bout du code de l'Extrait. Par exemple, le temps d'attente pour un système externe tel qu'un appel API REST ou une base de données ne compte pas dans cette limite.

  ```

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 de saisie

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.
Données	Contient le code personnalisé ajouté dans la fenêtre Snippet editor. Cela peut inclure plusieurs ASSIGN et DYNAMICcommandes, diverses instructions de contrôle de flux, ainsi que des fonctions intégrées et définies par l'utilisateur.
Taille de chaîne maximale	Définit la taille maximum des chaînes pour toutes les commandes de la propriété Data. Options : limite 2k, limite 4k, limite 8k, limite 16k, limite 32k. Cette limite s'applique aux réponses d'intégration avec les API REST et SOAP.

Conditions de branche du 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
Par défaut	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
Error	Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Astuces et conseils

• Utilisez la fonction asjson() dans un Snippet Action et stocker le résultat JSON dans une variable de chaîne.Utilisez le Variable de 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 Réponse vocale interactive. Menu téléphonique automatisé que les contacts utilisent par la Voix ou par des touches pour obtenir des informations, acheminer un appel vocal entrant, ou les deux. compatible ASR Reconnaissance automatique de la Parole. Permet aux contacts de répondre aux invites en parlant, en appuyant sur des touches du téléphone, ou les deux., il existe un ensemble de paramètres que vous pouvez utiliser dans les extraits de code.
• Le langage des Extraits 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 plus encore.
• Studio dispose de 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.
• Pour ajouter un commentaire à votre code, saisissez deux barres obliques (//). Vous pouvez cliquer sur l'icône en forme de bulle de dialogue pour insérer automatiquement les barres obliques au début de la rangée. Sélectionnez plusieurs rangées pour les convertir toutes en commentaires. Cliquez à nouveau sur l'icône en forme de bulle de dialogue pour supprimer les barres obliques. Vous pouvez également utiliser des raccourcis clavier pour activer et désactiver les commentaires (CTRL + /).
• Cliquez sur l'icône de bug sur le côté de la fenêtre de l'éditeur Snippet pour tester et déboguer votre code.
• Utilisez la variable système test lors du débogage des extraits. Elle vous permet de définir la valeur des variables utilisées dans l'extrait et qui seraient renseignées par le script lorsqu'il s'exécute pour un contact La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels..

Fenêtre de l'Éditeur Snippet

La fenêtre de l'éditeur Snippet 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. Vous pouvez également cliquer sur l'icône de fenêtre au milieu de l'action lorsqu'elle se trouve sur le canevas de script.

Exemple de script

Dans cet exemple simple, les actions Snippet contiennent des déclarations d'objets de données dynamiques et d'autres variables utilisées dans le script. L'action Snippet portant le nom Analyser la Transcription contient du code qui vérifie si la transcription correspond à une messagerie vocale. S'il s'agit d'une messagerie vocale, le script copie le corps du message de la transcription dans une variable. La variable contenant le corps du message est transmise à l'action PLAY, qui lit le message à l'aide de la synthèse vocale Permet aux utilisateurs d’entrer des invites enregistrées sous forme de texte et d’utiliser une voix générée par ordinateur pour prononcer le contenu..

Télécharger ce script.