Les informations contenues dans cette page d’aide s’appliquent à la fois à CXone Studio et à Desktop Studio.
Cette section fournit des informations techniques détaillées sur les scripts dans Studio. Les informations s’appliquent généralement au scriptage à l’aide d’actions et d’extraits de code personnalisés. Dans certains cas, les informations ne s’appliquent qu’à l’une ou l’autre des méthodes de scriptage.
Les informations contenues dans cette page résument les concepts fondamentaux du scriptage que vous devez connaître lorsque vous créez des scripts avec Studio. Des informations plus détaillées sont disponibles sur les autres pages de cette section.
Structure des scripts et des extraits de code
Les scriptsStudio peuvent être contenus dans un seul fichier ou être constitués d’un script principal et d’un ou plusieurs sous-scripts dans des fichiers séparés. Tous les textes doivent :
- Commencer par une action Begin. Les sous-scripts doivent également commencer par une action Begin.
- Terminer par une action de terminaison, telle que End. Les sous-scripts se terminent par
- Avoir un type de support défini.
À l’intérieur du script, la structure suit le flux requis par les comportements que le script doit fournir. Vous pouvez organiser et disposer le flux d’actions dans votre script de la manière qui vous convient le mieux. Par exemple, le flux peut aller de droite à gauche ou de gauche à droite. De même, il peut aller de haut en bas.
Quelques points à noter sur la structure des scripts :
- Utilisez les conditions de branche pour créer des branches dans votre script. Cela vous permet de couvrir les nombreux résultats, variations ou situations possibles qui peuvent se produire à un moment donné du script. Vous pouvez utiliser des branches pour la gestion des erreurs, pour les options d’un menu SRVI
Menu téléphonique automatisé qui permet aux appelants d’interagir via des commandes vocales, des entrées de touches ou les deux pour obtenir des informations, acheminer un appel vocal entrant, ou les deux. ou pour les chemins vrai/faux basés sur une action IF. - Certaines actions disposent de plusieurs conditions de branche. Il n’est pas nécessaire de les connecter toutes à chaque fois. Cependant, il est important de toujours connecter la branche Default. Il s’agit de la branche que le script emprunte si aucune des autres conditions ne s’applique. Cela peut empêcher les contacts de demeurer bloqués à cet endroit du script si quelque chose d’inattendu se produit.
- Les actions d’événement ne sont pas liées aux actions qui déclenchent l’événement. Elles commencent une nouvelle section dans le même fichier de script. Les nouvelles sections peuvent être placées n’importe où dans le fichier de script. Si votre script comporte plusieurs actions d’événement, il est judicieux de les organiser de manière à pouvoir les retrouver facilement par la suite.
Les extraits de code n’ont pas d’exigences en matière de structure, si ce n’est les limites de l’ordre logique des instructions. Ils peuvent contenir une seule instruction ASSIGN ou une logique de script complexe composée d’une série d’instructions et de blocs imbriqués. Si vous devez créer des fonctions personnalisées, vous devez utiliser des extraits de code.
Les extraits de code ne servent pas uniquement à contenir du code personnalisé. Vous pouvez les utiliser pour consolider les assignations de variables en un nombre réduit d’emplacements. Au lieu d’utiliser une action ASSIGN chaque fois que vous devez ajouter une variable, vous pouvez placer plusieurs instructions dans une seule action
Il y a certaines choses que vous pouvez faire pour faciliter la lecture de vos scripts. Cela peut aider d’autres auteurs de scripts qui pourraient avoir besoin de travailler avec le script plus tard. Vous pouvez :
- Modifier la propriété Caption de chaque action. Le contenu de cette propriété apparaît dans l’espace de travail du script. Vous pouvez ajouter un mot ou une courte phrase qui vous aide à savoir ce que fait chaque action. Par exemple, vous pouvez indiquer la compétence que l’action utilise, le fichier musical qu’elle joue ou ce que fait le code de l’extrait.
- Utilisez les actions Annotation et Note pour fournir une documentation supplémentaire dans votre script. Dans les actions Snippet, vous pouvez ajouter des commentaires.
- Suivez les autres meilleures pratiques de scriptage dans Studio.
Syntaxe
Comme tous les langages de programmation, Snippet a des règles syntaxiques qui doivent être respectées. Chaque page d’aide de la section de référence comporte une section sur la syntaxe qui couvre les règles relatives à cet élément du langage. Vous pouvez vous familiariser avec les règles de syntaxe pour :
Les règles syntaxiques sont décrites par des résumés des syntaxes. Les résumés utilisent certaines conventions pour distinguer les éléments facultatifs des éléments obligatoires. Pour en savoir plus sur ces conventions, consultez la page d’aide Instructions.
Types de données
Les types de données décrivent la manière dont les données sont représentées et les types d’opérations qui peuvent être effectuées avec les données. De nombreux langages de programmation prennent en charge de nombreux types de données qui font la distinction entre différents types de représentations numériques et alphanumériques. Un
- Chaîne : La valeur de la variable contient des caractères alphanumériques et spéciaux, tels que des points, des virgules et des traits de soulignement. Les valeurs de type chaîne doivent être placées entre guillemets.
- Numérique : La valeur de la variable est un nombre. Les valeurs numériques n’ont pas besoin de guillemets.
- Date/heure : La valeur de la variable est une date, une heure ou les deux. Lorsqu’une valeur de date/heure est utilisée avec les fonctions date/heure dans Studio, la valeur doit être placée entre guillemets et précédée d’un dièse à l’extérieur des guillemets : var = #"11-23-2022".
- Booléen : La valeur de la variable est soit true ou 1, soit false ou 0. Ne pas mettre les valeurs booléennes entre guillemets.
Il n’est pas nécessaire de déclarer les types de données lors de la création de variables, comme c’est le cas dans certains langages de programmation. Dans Studio, les variables sont implicitement typées. Cela signifie que le type est déterminé automatiquement lors de la compilation du script.
Les types de données font partie intégrante des scripts. Pour en savoir plus sur les types de données dans les scripts Studio, consultez les pages d’aide consacrées aux structures de données, aux expressions et aux variables. Si vous travaillez avec des fonctions, vous devez connaître les types de données que vous utilisez dans le script. Vous devez également savoir ce qu’attend la fonction que vous utilisez et comment la sortie peut différer selon le type avec lequel vous l’utilisez.
Structures de données : Variables, tableaux et objets
Les structures de données vous permettent de stocker des données à utiliser dans votre script. Vous pouvez récupérer les données de la structure de données lorsque vous en avez besoin ou les remplacer par d’autres données. Dans d’autres langages de programmation, il peut y avoir de nombreux types de structures de données et elles peuvent être très complexes. Dans Studio, il n’existe que trois types de structures de données :
- Variables : Une variable standard contient une seule valeur à la fois.
- Tableaux : Un tableau peut contenir plus d’une valeur. Ils sont utiles pour stocker des listes de données de même nature, telles que les codes postaux ou les noms des compétences Utilisé pour automatiser la livraison des interactions en fonction des compétences, des capacités et des connaissances des agents ACD. Le tableau complet et son contenu sont stockés sous la forme d’une chaîne unique.
- Objets dynamiques : Un objet dynamique contient plus d’une valeur. Ils sont utiles pour stocker des données qui sont toutes liées, comme le nom, l’adresse et le numéro de téléphone d’un contact.
Vous pouvez créer n’importe laquelle de ces structures de données en la déclarant à l’aide d’une instruction.
Expressions
Une expression est tout ce qui, dans votre script, compare une valeur ou aboutit à une valeur. Les exemples suivants sont tous des exemples d’expressions :
-
x = 3(5+10)
- y = 123 North Street
- x != 5
Il existe différents types d’expressions, notamment les chaînes, les expressions numériques et les expressions booléennes Un type de données qui a deux valeurs possibles : true et false.. Les expressions ont de nombreuses utilisations dans les scripts Studio. Elles sont utilisées pour :
- Configurer les propriétés des actions Studio ou dans les extraits de code.
- Définir la logique dans un script qui crée des branches et simule la prise de décision.
- Fournir des valeurs littérales pour les propriétés d’action ou dans les extraits de code.
- Effectuer des calculs mathématiques ou algébriques.
Opérateurs
Les opérateurs sont des symboles mathématiques qui indiquent quelle opération mathématique ou algébrique doit être effectuée sur les nombres. Studio prend en charge tous les opérateurs mathématiques standard et certains opérateurs algébriques. Il prend également en charge les opérateurs booléens Un type de données qui a deux valeurs possibles : true et false., qui sont utilisés dans les expressions booléennes. Il s’agit d’expressions dont la valeur est soit vraie, soit fausse. Vous pouvez utiliser des expressions booléennes dans certaines instructions pour créer un mécanisme de prise de décision dans votre script.
Déclarations
Les instructions définissent les actions d’un script lors de son exécution. Il s’agit notamment de créer des variables, d’attribuer de nouvelles valeurs, d’effectuer des calculs et de faire des choix logiques en fonction d’une condition donnée. Certaines instructions n’effectuent qu’une tâche, telle que l’attribution d’une valeur à une variable. D’autres instructions affectent le déroulement du script. Les instructions sont exécutées dans un ordre logique, mais cet ordre peut être modifié à chaque exécution du script.
Lorsque vous créez des scripts avec des actions, vous n’avez généralement pas besoin de penser en termes d’instructions. Dans les extraits de code, vous pouvez utiliser les types d’instructions suivants :
- Déclaration : Utilisez les instructions de déclaration pour déclarer ou créer de nouvelles variables, de nouveaux objets et de nouvelles fonctions.
- Prise de décision : Utilisez les instructions de prise de décision pour que le code de l’extrait sélectionne une tâche à effectuer en fonction des conditions que vous spécifiez. Vous pouvez les utiliser pour contrôler le flux linéaire de ce qui se passe dans le script.
- Boucle : Utilisez les instructions de boucle pour que l’extrait de code exécute une tâche ou un ensemble de tâches de manière répétée jusqu’à ce que la condition de fin spécifiée soit remplie.
- Autres : Ces instructions vous permettent de mettre fin à des fonctions, d’afficher les résultats dans la fenêtre
Certaines instructions ont des actions Studio qui font la même chose. Par exemple, les actions
Mots réservés
Studio contient des mots réservés qui ne peuvent pas être utilisés comme noms de variables ou d’autres entités dans les scripts. Les mots réservés comprennent les noms de :
- Commandes avec des mots-clés.
- Fonctions intégrées.
- Variables système prédéfinies.
- Variables réservées.
Si vous utilisez un mot réservé comme nom d’une entité dans votre script, cela provoque une erreur. Vous devez renommer l’entité pour résoudre l’erreur.
Commentaires
Les commentaires vous permettent de documenter un élément de votre script ou de votre extrait de code. Vous pouvez les utiliser pour vous laisser une note ou laisser une note à un futur auteur de script, ou pour expliquer l’objectif d’un élément du texte.
Dans les scripts Studio, vous pouvez ajouter des commentaires avec l’action Note ou l’action Annotation. Ces deux actions vous permettent d’ajouter un commentaire au canevas de script. L’action Annotation place le commentaire de manière visible sur le canevas. Pour lire le commentaire dans une action Note, vous devez double-cliquer sur l’action.
Dans les extraits de code, vous pouvez ajouter des commentaires en plaçant deux barres obliques (//). Les commentaires peuvent être placés sur leurs propres lignes ou à la fin d’une instruction.
Vous pouvez également utiliser des commentaires dans les extraits pour masquer les lignes de code que vous ne souhaitez pas voir figurer dans le script lors de son exécution. Ceci est utile pour résoudre les problèmes.
Fonctions
Les fonctions sont un moyen de créer du code que vous souhaitez réutiliser. Vous pouvez créer vos propres fonctions, puis les appeler ailleurs dans votre script lorsque vous souhaitez utiliser le code que la fonction contient. Studio a également quelques fonctions intégrées que vous pouvez utiliser sans avoir à les déclarer dans votre script.
Gestion des chaînes
Dans les extraits de code, vous pouvez faire beaucoup de choses avec les chaînes en utilisant les fonctions intégrées. Vous pouvez :
- Les concaténer
- Les diviser en sous-chaînes
- Les rechercher
- Remplacer une partie du contenu
- Les comparer
- Passer des majuscules aux minuscules et vice versa.
Dans certains cas, il peut être nécessaire de spécifier le formatage des chaînes comportant des dates, des heures ou des nombres. Vous pouvez utiliser les spécificateurs de format désignés pour définir le format que vous souhaitez que le script utilise. Vous pouvez également utiliser certaines fonctions intégrées pour convertir des chaînes en différents formats.
Il existe certains caractères que vous ne pouvez pas inclure dans les chaînes de caractères sans utiliser une séquence d’échappement. Comme les chaînes doivent être placées entre guillemets simples ou doubles, si vous incluez un guillemet simple ou double littéral dans une chaîne, le script l’interprète comme le début ou la fin d’une chaîne. La séquence d’échappement indique au script que le caractère est destiné à être un littéral et non le symbole qu’il utilise par défaut. Les tabulations, les retours arrière et les accolades ouvertes sont d’autres caractères qui nécessitent des séquences d’échappement.