Snippets de code personnalisé

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

Certains scripts nécessitent plus de complexité que les actions Studio seules ne peuvent fournir. 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.

Le codage personnalisé nécessite des connaissances en matière de script ou de programmation. 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 sur 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 mettre en œuvre 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 pouvez avoir besoin de plus que Snippet action dans votre script. Si vous utilisez plusieurs actions, mettez à jour le champ Ajouter une légende de chacune avec une phrase qui permet d'identifier son objectif.

Le placement d'une action Snippet a son importance. 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'ASSIGN action, 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 le code dans des extraits, votre script est plus clair, 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'Snippet action vous permet d'ajouter du code personnalisé à vos scripts.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Studio.
  2. Sur la Page Scripts, repérez et ouvrez votre script.
  3. Ajoutez l’action Snippet à votre script et cliquez sur Ouvrir l’éditeur dans le panneau de propriétés.
  4. Entrée 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 discussion Icon of a speech bubble with two angle brackets in it. ou type deux barres obliques (//). Cliquez de nouveau sur la bulle de discussion pour supprimer les barres obliques au début d'une ligne.
  6. Cliquez sur l'icône de bug Icon of a bug. pour tester 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.