RUNSUB

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

Icône Runsub : cercles violets reliés par des flèches

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

Un carré d'où part une ligne qui va vers trois autres carrés.

Icon of gray-green envelope

\n Icon of dark green speech bubble\n

Icon of purple telephone handset

Icône du symbole de messagerie vocale de couleur rouille représentant deux cercles reliés par une ligne

Icon of pink document with lines of text

Icône d'un téléphone mobile vert avec une bulle de discussion sur l'écran

Icône d'un moniteur d'ordinateur violet avec un appareil mobile chevauchant son coin inférieur droit

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

Ajouter une 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.

Nom du script

The script you want to spawn. Choose a script from the drop-down list or enter its name and relative path. The script must be located in the same folder as the calling script or in one of its subfolders.

Variable de retour

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.

Error

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 des branches pour l'ouverture, la fermeture et les jours fériés vers trois actions Return différentes. 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 du script principal). L'action Case définit ensuite les branches d'ouverture, de fermeture et de jours fériés selon le cas.

Script principale

Main script using the RUNSUB action

Télécharger ce script.

Indice

Sous-script avec trois actions Return qui définissent la ReturnValue utilisée par l'action Case dans le script principal

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

Télécharger ce script.