Snippets de code personnalisé

Les informations sur cette page d’aide concernent à la fois Studio et Desktop Studio.

Certains scripts nécessitent une complexité supérieure à celle que les actions Studio peuvent fournir à elles seules. Studio vous permet d'ajouter du code personnalisé à vos scripts.Vous pouvez ainsi personnaliser vos scripts afin de répondre aux besoins de votre organisation.

Studio utilise un langage de programmation personnalisé appelé Snippet, développé pour être utilisé dans Studio. Un guide de référence technique complet est disponible dans l'aide en ligne afin que vous puissiez apprendre à utiliser ce langage.

Faits clés à propos des Snippets

  • Les snippets de code peuvent contribuer à améliorer l'organisation et l'efficacité de vos scripts. Ils vous permettent de mieux contrôler les processus qui s'exécutent, ainsi que le moment et la manière dont ils s'exécutent. Vous pouvez créer vos propres variables et objets et ajouter une logique de programmation à l'aide d'instructions telles que IF, FOR, FOREACH, et d'autres.
  • Certains produits et fonctionnalités requièrent des snippets, mais vous pouvez les utiliser dans vos scripts même s'ils ne sont pas nécessaires.
  • Lorsqu'un produit ou une fonctionnalité nécessite des extraits de code, l'aide en ligne fournit des informations détaillées les extraits de code que vous devez inclure. Des exemples de scripts sont fournis pour montrer comment utiliser les snippets de code dans les scripts. Des scripts supplémentaires peuvent être nécessaires pour implémenter les produits ou fonctionnalités.
  • Le langage de script Extrait est basé sur le framework .NET. Ce langage s'exécute côté serveur et se compile en MSIL (Microsoft Intermediate Language), tout comme C# et Visual Basic .NET.

Action extrait

Pour ajouter du code personnalisé à vos scripts, vous avez besoin d'un Extrait Action. Vous pouvez double-cliquer sur cette action pour ouvrir une fenêtre d'édition dans laquelle vous pouvez ajouter votre code personnalisé. Vous pouvez également déboguer le code dans la fenêtre de l'éditeur. Vous pourriez avoir besoin de plus que d'une action Snippet dans votre script. Si vous utilisez multiple actions, mettez à jour le champ Ajouter une légende de chacune avec une phrase qui aide à identifier son objectif.

Le placement d'une action Snippet est important. Si un Snippet attribue une valeur à une variable, il doit être placé avant l'action qui a besoin de cette valeur. En revanche, si un Snippet contient du code décisionnel qui agit en fonction d'une valeur qui lui est transmise, le Snippet doit être placé après l'action qui fournit cette valeur.

Snippets comparés aux Actions

Certaines des actions que vous pouvez effectuer dans les extraits peuvent également être réalisées à l'aide des actions Studio. Par exemple, il existe des actions pour les instructions IF et FOR. Il existe également l'action ASSIGN, que vous pouvez utiliser pour créer une variable personnalisée et lui attribuer une valeur. L'utilisation de ces actions est un moyen acceptable d'ajouter ces capacités à votre script. Toutefois, l'utilisation d'extraits est plus efficace.

En plaçant du code dans des extraits, votre script est plus propre, mieux organisé et plus facile à parcourir. Cela facilite et rend plus efficace votre travail de développeur de script. Si vous prenez l'habitude de toujours déclarer les variables dans les snippets, à l'avenir, si vous avez besoin de retrouver une déclaration particulière, vous aurez moins d'endroits où chercher.

ajouter du code personnalisé à un script

L'action Snippet permet d'ajouter du code personnalisé à vos scripts.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Studio.
  2. Sur la Page Scripts, repérez et ouvrez votre script.
  3. Ajoutez l'action Snippet à votre script, puis cliquez sur Ouvrir l'Éditeur dans le panneau des propriétés.
  4. Entrez votre code dans la fenêtre de l'éditeur. Vous pouvez taper le code ou le copier-coller à partir d'une autre source, comme ce site d'aide ou un autre script.
  5. Pour ajouter un commentaire à votre code, cliquez sur la bulle de dialogue Icon of a speech bubble with two angle brackets in it. ou type deux barres obliques (//). Cliquez à nouveau sur la bulle de dialogue pour supprimer les barres obliques en début de ligne.
  6. Cliquez sur le bug Icon of a bug. pour test et déboguer votre code.
  7. Cliquez sur Appliquer pour enregistrer vos modifications. L'éditeur d'extrait se ferme. Rouvrez-le pour continuer à modifier votre code.