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 ne peuvent en fournir à elles seules. Studio 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 de vous permettre d'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 bien 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 snippets de code, l'aide en ligne fournit des informations détaillées sur les snippets 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 les fonctionnalités.
  • Le langage de script Snippet est basé sur le cadre .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 d'extrait de code

Pour ajouter du code personnalisé à vos scripts, vous avez besoin d’une action Snippet. 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. Il se peut que vous ayez besoin de plusieurs actions Snippet dans votre script. Si vous utilisez plusieurs actions, mettez à jour le champ Ajouter Caption de chacune d’entre elles avec une phrase permettant d’identifier sa fonctionnalité.

L'emplacement d’une action Snippetest important. Si un Snippet attribue une valeur à une variable, il doit être placé avant l'action qui a besoin de cette valeur. D’autre part, si un Snippet contient un 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 la valeur.

Comparaison des snippets et des actions

Certaines choses que vous pouvez effectuer dans les snippets peuvent également être réalisées à l'aide d’actions Studio. Par exemple, il existe des actions pour les déclarations IF et FOR. Il existe également une 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 de snippets est plus efficace.

En plaçant le code dans des snippets, votre script est plus propre, mieux organisé et plus facile à parcourir. Cela facilite votre travail de rédacteur de scripts et le rend plus efficace. 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 vous permet d'ajouter du code personnalisé à vos scripts.

  1. Dans CXone Mpower, cliquez sur le sélecteur d'application et sélectionnezStudio.
  2. Sur la page Scripts, localisez et ouvrez votre script.
  3. Ajoutez l'action Snippet à votre script et cliquez sur Ouvrir l'éditeur dans le panneau des propriétés.
  4. Saisissez 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. Cliquez sur Apply pour enregistrer vos modifications. L'éditeur d'extraits se ferme. Rouvrez-le pour continuer à modifier votre code.