Runsub

Appelle un sous-script, qui s’exécute et utilise ensuite Return action pour revenir au script principal et continuer à l’exécuter. 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 du script principal. 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 script principal et le sous-script doivent être dans le même dossier.

• Le type de script principal et le type de sous-script doivent être identiques. Par exemple, si le script principal est un script téléphonique, le sous-script doit également être un script téléphonique.
• Si vous placez une action Runsub dans le script principal, votre script secondaire DOIT avoir une action Return.
• Runsub peut transmettre plusieurs variables du script principal au sous-script, mais ce dernier ne peut renvoyer qu’une seule valeur (dans la propriété ReturnVariable) au script principal.
• Toutes les variables définies dans le sous-script ne seront plus disponibles lorsque le sous-script s’achèvera, à moins que vous ne les déclariez comme globales. Vous pouvez le faire dans une action SNIPPET en ajoutant global: devant le nom de la variable. Par exemple, ASSIGN global:varName = value. Une autre option pour accéder aux données d’un sous-script est d’utiliser l’API GET /contacts/{contactId}/custom-data .
• Pour utiliser la fonction savetodb() 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 des 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

Générique	Courriel	Clavardage	Téléphone	Messagerie vocale	Élément de travail	SMS	Numérique

Comparaison d’actions similaires

Les actions suivantes ont des fonctions semblables, mais avec quelques différences essentielles :

• Runscript : Lorsque Runscript déclenche un autre script, il ne retourne pas au premier script à partir du second.
• Runsub : Lorsque Runsub déclenche un sous-script, le script peut revenir au premier script, à condition que le sous-script ait une action Return. L’action Return renvoie une valeur à l’action Runsub lorsque le sous-script est terminé.
• SPAWN : Lance un deuxième script qui s’exécute en parallèle au premier script. Les scripts créés ne peuvent pas renvoyer de données au premier script, à moins que vous n’incluiez une SIGNAL action dans le script créé.

Propriétés d’entrée

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

Propriété	Description
Caption	Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action. The default is the action name.
ScriptName	Le script que vous souhaitez générer. Vous pouvez cliquer sur le lien Choose Script en haut de la boîte de propriétés de l’action pour sélectionner un script de votre unité commerciale.
ReturnVariable	La valeur qui est retournée au script principal est stockée dans cette propriété. Pour transmettre plusieurs valeurs, utilisez un tableau en tant que variable.
Parameters	Cliquez sur l'icône représentant des points de suspension dans le champ et ajoutez une variable pour chaque paramètre script que vous souhaitez envoyer au script généré. Entrez une variable par ligne dans la fenêtre de l'éditeur. Utilisez des noms de variables significatifs. Les noms de variable ne doivent pas nécessairement correspondre au nom de la variable correspondante utilisée dans le script généré. Les paramètres transmis à un script apparaissent dans Tracer la sortie de ce script dans l’action Begin.

Conditions de la branche de 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
Default	Chemin emprunté à moins que le script ne remplisse une condition exigeant qu’il prenne l’une des autres branches. Elle est également prise si les autres branches de l’action ne sont pas définies.
OnError	Chemin emprunté lorsque l’action ne s’exécute pas correctement. Par exemple, en cas de problème inattendu tel qu’une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un seul caractère de soulignement, doit être remplie avec une explication condensée du problème.

Exemple de script

Dans le script principal ci-dessous (en haut), lorsque le script est déclenché, l’action Runsub déclenche immédiatement le sous-script (en bas). Dans le sous-script, Voiceparams définit les paramètres de la synthèse texte-parole et l’action Hours définit les branches ouvertes, fermées et en vacances pour 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 (actionRunsub dans le script principal). L’action Case définit alors les branches ouvertes, fermées et vacances si approprié.

Script principal

Souhaitez-vous télécharger ce script ?

Sous-script

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 à emprunter.

Souhaitez-vous télécharger ce script ?