Runsub

Cette page d'aide concerne Desktop Studio. Ces informations sont également disponibles pour Studio.

L'icône d'action Runsub, un morceau de papier enroulé avec deux flèches pointant vers la droite à côté de celui-ci, en haut et en bas.

Appelle un sous-script, qui s'exécute puis utilise l'action Return pour revenir au script principal et continuer son exécution. Lorsque le sous-script s'exécute, il stocke une valeur dans la propriété ReturnValue de l'action Return, puis transmet cette valeur à la propriété ReturnVariable de l'action Runsub dans le script principale.

Cette action peut être particulièrement utile si vous avez un ou plusieurs scripts plus volumineux que vous préférez diviser en scripts plus petits.

Dépendances

  • Le sous-script doit se trouver dans le même dossier que le script principale, ou dans l'un de ses sous-dossiers.

  • Le type de script principal et le type d'indice doivent être identiques.Par exemple, si le script principal est un script téléphonique, l'indice doit également être un script téléphonique.
  • Si vous mettez une action Runsub dans le script principal, votre sous-script DOIT avoir une action Return.
  • Runsub peut transmettre plusieurs variables du script principal au sous-script, mais le sous-script ne peut retourner qu'une valeur (dans la propriété ReturnVariable) au script principal.
  • Toutes les variables définies dans le sous-script ne seront plus disponibles à la fin de l'exécution de celui-ci, sauf si vous les déclarez comme global. Vous pouvez effectuer cette opération dans une action SNIPPET en ajoutant global: avant le nom de la variable. Par exemple, ASSIGN global:varName = value. Une autre option pour accéder aux données dans un sous-script consiste à utiliser l'GET /contacts/{contactId}/custom-data Icône d'un carré avec une flèche pointant du centre vers le coin supérieur droit. API.
  • Pour utiliser la savetodb() fonction sur une variable dans un sous-script Runsub, il doit s'agir d'une variable globale.
  • Tous les scripts appelés par RunScript, Spawn, Runsub, ou autres scripts similaires doivent être valides et actifs. Pendant le processus de sauvegarde, Studio valide tous les scripts appelés par les actions. Si l'un d'entre eux est invalide ou inactif, Studio affiche une erreur et vous ne pourrez pas enregistrer.

Types de scripts pris en charge

The icon for a Generic script type - a rectangle with < and > symbols inside it.

L'icône du type de script E-mail - un grand symbole @ dans un losange.

L'icône du type de script Chat - une bulle de chat avec des points de suspension à l'intérieur (...), en forme de losange.

L'icône du type de script Téléphone - un combiné téléphonique à l'ancienne avec des lignes courbes indiquant que le son en sort.

L'icône du type de script de messagerie vocale - un symbole qui ressemble à une cassette - deux cercles assis sur une ligne horizontale.

L'icône pour le type de script d'élément de travail - un morceau de papier avec un coin replié et une liste à puces dessus.

" L'icône du type de script SMS - un téléphone intelligent avec une bulle de discussion qui en sort."

L'icône pour le type de script Digital - un moniteur d'ordinateur avec un smartphone à côté.

Générique

Email Conversation Téléphone Messagerie vocale Élément de travail SMS Digital

Comparaison d'actions similaires

Les actions suivantes ont des fonctions similaires, mais présentent quelques différences clé :

  • Runscript : lorsque Runscript déclenche un autre script, il ne revient pas au premier script depuis le second script.
  • Runsub : lorsque Runsub déclenche un sous-script, le script peut revenir au premier script, à condition que le sous-script comporte une action Return.L'action revenir fournit une valeur à l'action exécuter lorsque l'indice est terminé.
  • SPAWN : démarre un deuxième script qui s'exécute en parallèle du premier script. Les scripts générés ne peuvent pas renvoyer de données au premier script, sauf si vous incluez une SIGNAL action dans le script généré.

Propriétés de saisie

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété

Description

Légende

Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. La valeur par défaut est le nom de l’action.

ScriptName

The script you want to spawn. You can click the Choose Script link at the top of the action's properties box to select a script from your business unit.

ReturnVariable

The value that is returned to the main script is stored in this property. To pass multiple values, use an array as the variable.
Paramètres

Permet de modifier le nom des variables par défaut qui contiennent les valeurs des paramètres que vous souhaitez envoyer au script généré ou enfant. Les variables par défaut sont p1 - p9, mais si vous précisez des noms dans cette propriété, ces noms remplacent les noms DE variables par défaut dans lesquels les valeurs des paramètres sont transmises. Si vous ne modifiez pas les noms, les variables conservent leurs noms pX par défaut.

Pour modifier les noms, cliquez sur l'icône représentant des points de suspension dans le champ et ajoutez des noms DE variable pour chaque paramètre que vous souhaitez envoyer au script généré ou enfant. Entrez jusqu'à neuf noms, un par ligne, dans la fenêtre de l'éditeur. Pour modifier les noms, ajoutez de nouveaux noms pour chaque paramètre que vous souhaitez envoyer au script généré ou enfant. Entrez jusqu'à neuf noms DE variable, un par ligne. Les Noms DE variable ne doivent pas nécessairement correspondre au nom de la variable correspondante utilisée dans le script généré, mais ils doivent être significatifs. Ces valeurs sont transmises en tant que variables de paramètrevariables de paramètre p1 - p9.

Les paramètres transmis à un script apparaissent dans la sortie de trace de ce script dans l'action Begin.

Conditions de branche résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition

Description

Par défaut

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.

OnError

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s'agit pas d'un script complet. Des scripts supplémentaires peuvent être nécessaires.

Dans le script principal ci-dessous (illustré en haut), lorsque le script est déclenché, l'action Runsub déclenche immédiatement le sous-script (illustré en bas). Dans le sous-script, Voiceparams définit les paramètres de Synthèse vocale, et l'action Hours définit les branches pour les actions Return ouverte, fermée et jour férié. Lorsque le sous-script est terminé, les valeurs de la propriété ReturnValues (dans l'action Return) sont stockées dans le champ ReturnVariable (action Runsub dans le script principal). L'action Case définit ensuite les branches ouverte, fermée et jour férié comme il convient.

Script principale

Un exemple de script, montrant des actions Studio avec des flèches les reliant. Chaque action comporte une étiquette en dessous pour indiquer ce que l'action fait dans le script.

Souhaitez-vous télécharger ce script ?

Indice

Un exemple de script, montrant des actions Studio avec des flèches les reliant. Chaque action comporte une étiquette en dessous pour indiquer ce que l'action fait dans le script.

Les trois actions Return fournissent des valeurs dans la propriété ReturnValue afin que l'action Case du script principal puisse déterminer quelle branche suivre.

Souhaitez-vous télécharger ce script ?