Référence technique Guide

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

Cette section fournit des informations de référence technique détaillées sur l'écriture de scripts dans Studio. Les informations s'appliquent généralement à l'écriture de scripts à l'aide d'actions et de snippets de code personnalisés. Dans certains cas, les informations s'appliquent uniquement à l'une ou l'autre méthode d'écriture de scripts.

Les informations présentées sur cette Page résument les concepts fondamentaux de l'écriture de scripts que vous devez connaître lorsque vous écrivez des scripts avec Studio. Des informations Plus approfondies sont disponibles sur les autres Pages de cette Section.

Structure du script et de l'Extrait

Les scripts Studio 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 distincts. Chaque script doit :

  • Commencez par une action Begin. Les sous-scripts doivent également commencer par une action Begin.
  • Terminez par une action de terminaison , telle que End. Les sous-scripts se terminent par Return, une action qui renvoie le flux du script vers le script principal.
  • Posséder 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 qui pourraient survenir à un moment donné du script. Vous pouvez utiliser les branches pour la gestion des erreurs, pour les options d'un menu IVRClosed Interactive Voice Response. Automated phone menu contacts use via voice or key inputs to obtain information, route an inbound voice call, or both., ou pour les chemins vrai/faux basés sur une action IF.
  • Certaines actions ont plusieurs conditions de branche disponibles. Il n'est pas nécessaire de les connecter toutes à chaque fois. Toutefois, il est important de toujours connecter la branche Default. C’est la branche que suit le script si aucune des autres conditions ne s'applique. Elle peut empêcher les contacts de rester bloqués à cet emplacement du script si une situation inattendue 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 n'ont aucune exigence de structure, hormis 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 snippets.

Vous pouvez utiliser les extraits non seulement pour conserver du code personnalisé. Vous pouvez également les utiliser pour regrouper les attributions 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 de déclaration dans une seule action Snippet.

Vous pouvez faire différentes choses pour rendre vos scripts plus lisibles.Ceci peut aider d'autres rédacteurs de script qui pourraient avoir besoin de travailler sur le script ultérieurement. Tu peux:

  • Modifiez la propriété Ajouter une légende de chaque Action. Le contenu de cette propriété apparaît dans l'espace de travail du canevas de script. Vous pouvez ajouter un mot ou une courte phrase qui explique ce que fait chaque action. Par exemple, vous pouvez indiquer la compétence utilisée par l'action, le fichier musical qu'elle joue ou ce que fait le code Snippet.
  • Utilisez les actions Annotation et Note pour fournir une documentation supplémentaire dans votre script. Dans les actions Extrait, vous pouvez ajouter des commentaires.
  • Suivez les autres meilleures pratiques relatives au script dans Studio.

Syntaxe

Comme tous les langages de programmation, Snippet comporte des règles de syntaxe 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 de syntaxe sont décrites à l'aide de résumés de syntaxe. Les résumés utilisent certaines conventions pour distinguer les éléments en option des éléments obligatoires. En savoir plus sur ces conventions sur la Page d'aide Statements.

Types de données

Les types de données décrivent la manière dont les données sont représentées ainsi que les types d'opérations qui peuvent être effectuées avec ces données. De nombreux langages de programmation prennent en charge de nombreux types de données qui distinguent les différents types de représentations numériques et alphanumériques. Studio ne fait pas ces distinctions. Dans Studio, les valeurs sont d'un des types suivants :

  • Chaîne : la valeur de la variable contient des caractères alphanumériques et spéciaux, comme des points, des virgules et des caractères de soulignement. Les valeurs chaîne doivent être placées entre guillemets doubles.
  • Numérique : la valeur de la variable est un nombre. Les valeurs Numériques n'ont pas besoin de guillemets doubles.
  • 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 fonctions de date/heure dans Studio, la valeur doit être placée entre guillemets et précédée d'un signe dièse à l'extérieur des guillemets : var = #"11-23-2022".
  • Booléen : la valeur de la variable est soit true soit 1, soit false soit 0. N'encadrez pas les valeurs booléennes de 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 du scripting. Vous pouvez en savoir plus sur les types de données dans les scripts Studio dans 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 que la fonction que vous utilisez attend, ainsi que la manière dont la sortie peut varier 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 exister 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 :

Vous pouvez créer n'importe laquelle de ces structures de données en la déclarant à l'aide d'une instruction de déclaration.

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 expressions de type chaîne, numérique et booléenClosed A data type that has two possible values: true and false.. Les expressions ont de nombreuses utilisations dans les scripts Studio. Elles sont utilisées pour :

  • Configurez les propriétés des actions Studio ou dans des extraits.
  • Définir la logique dans un script qui crée des branches et qui simule la prise de décision.
  • Fournir des valeurs littérales pour les propriétés d'action ou dans les snippets.
  • Fournir des calculs mathématiques ou algébriques.

Les opérateurs

Les opérateurs sont des symboles mathématiques qui indiquent l'opération mathématique ou algébrique à effectuer avec les nombres. Studio prend en charge tous les opérateurs mathématiques standard et certains opérateurs algébriques opérateurs. Il prend également en charge les opérateurs booléensClosed A data type that has two possible values: true and 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 booléens 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 qu'un script exécute 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 se contentent d'exécuter une tâche, comme attribuer une valeur à une variable. D'autres instructions affectent le flux du script. Les instructions sont exécutées dans un ordre logique, mais cet ordre peut changer à chaque exécution du script.

Lorsque vous rédigez des scripts avec des actions, vous n'avez généralement pas besoin de penser en termes d'instructions. Dans les extraits, 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 prise de décision instructions pour que le code de l'extrait sélectionne une tâche à exécuter en fonction des conditions que vous précisez. Vous pouvez les utiliser pour contrôler le flux linéaire de ce qui se passe dans le script.
  • Bouclage : Utilisez des déclarations de bouclage pour que l'extrait effectue une tâche ou un ensemble de tâches de façon répétée jusqu'à ce que la condition de fin spécifiée soit remplie.
  • Autre : ces instructions vous permettent de terminer des fonctions, d'afficher les résultats dans la fenêtre Snippet editor pendant le débogage, et d'inclure des DLL proxy de service Web dans vos Extraits.

Certaines instructions possèdent Studio actions qui font la même chose. Par exemple, les actions ASSIGN et IF effectuent la même chose que les instructions ASSIGN et IF que vous pouvez utiliser dans les snippets. Pour de nombreuses instructions, la seule possibilité de les utiliser consiste à en faire des snippets.

Mots réservés

Studio comporte 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 :

Si vous utilisez un mot réservé comme nom d'une entité dans votre script, une erreur se produira. Pour résoudre l'erreur, Vous devez renommer l'entité.

Commentaires

Les commentaires permettent de documenter un élément de votre script ou de votre snippet. Vous pouvez les utiliser pour laisser une note à votre attention ou à celle d'un futur développeur de script, ou pour expliquer l'objectif de quelque chose dans le script.

Dans les scripts Studio, vous pouvez ajouter des commentaires avec l'action Note ou l'action Annotation. Les deux actions permettent d'ajouter un commentaire sur le canevas de script. L'action Annotation place le commentaire de manière visible sur le canevas. Pour lire le commentaire d’une action Note, vous devez double-cliquer sur l'action.

Dans les snippets, 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 snippets pour masquer les lignes de code que vous ne voulez pas voir figurer dans le script lors de son exécution. Ceci est utile pour le dépannage de problèmes.

Les fonctions

Les fonctions sont un moyen de créer du code que vous voulez 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 dispose également de certaines fonctions intégrées que vous pouvez utiliser sans avoir à les déclarer dans votre script.

Gestion des chaînes

Dans les extraits, vous pouvez effectuer de nombreuses opérations sur les chaînes à l'aide des fonctions intégrées :

  • Les concaténer
  • Les fractionner en sous-chaînes
  • Y effectuer des recherches
  • Remplacer une partie du contenu
  • Comparez-les
  • Les convertir de majuscules en 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 voulez que le script utilise.Vous pouvez également utiliser certaines des fonctions intégrées pour convertir les chaînes dans différents formats.

Certains caractères ne peuvent pas être inclus dans les chaînes 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 espaces arrière et les accolades ouvertes sont d'autres caractères qui nécessitent des séquences d'échappement.