Runsub

Appelle un sous-script, qui s'exécute puis utilise Return action pour revenir au script principal et continuer de l’exécuter. Lorsque le sous-script s'exécute, il stocke une valeur dans la propriété ReturnValue de l'action Return, puis renvoie la valeur à la propriété ReturnVariable dans l’action Runsub sur le 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 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 placez une action Runsub dans le script principal, votre sous-script DOIT comporter 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 sont plus disponibles lorsque le sous-script se termine, sauf si vous les déclarez comme variables globales. Pour ce faire, utilisez l’action SNIPPET en ajoutant global: avant le nom de la variable. Par exemple, ASSIGN global:varName = value. Une autre manière d’accéder aux données d’un sous-script consiste à utiliser l’API GET /contacts/{contactId}/custom-data .
• Pour utiliser la fonction savetodb() comme variable dans un sous-script Runsub, il faut qu’ il s’agisse 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	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 essentielles :

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

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
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. 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 afin de sélectionner un script stocké pour votre unité commerciale.
ReturnVariable	La valeur renvoyée au script principal est stockée dans cette propriété. Pour transmettre plusieurs valeurs, utilisez un tableau comme variable.
Parameters	Cliquez sur l’icône représentant trois points de suspension dans le champ et ajoutez une variable pour chaque paramètre que vous voulez envoyer au script engendré. Entrez une variable par ligne dans la fenêtre de l’éditeur. Utilisez des noms de variables significatifs. Les noms des variables ne doivent pas nécessairement correspondre au nom de la variable correspondante utilisée dans le script engendré. Les paramètres qui sont transmis dans un script apparaissent dans la sortie de trace de ce script dans l’action Begin.

Conditions de branche résultantes

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 parcouru sauf si le script remplit une condition qui l'oblige à emprunter l'une des autres branches. Il est également suivi 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, comme une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un caractère de soulignement simple, doit contenir une explication condensée du problème.

Exemple de script

Dans le script principal ci-dessous (représenté en haut), lorsque le script est déclenché, l'action Runsub déclenche immédiatement le sous-script (représenté en bas). Dans le sous-script, Voiceparams définit les paramètres Synthèse vocale, et l'action Hours défini les tronçons pour ouvert, fermé et vacances vers trois actions Return différentes. Lorsque le sous-script est terminé, les valeurs dans 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 alors les tronçons ouvert, fermé et vacances si nécessaire.

Script principal

Souhaitez-voustélécharger ce script?

Indice

Les trois actions Return fournissent des valeurs dans la propriété ReturnValue de sorte que l'action Case dans le script principal peut déterminer quelle branche suivre.

Souhaitez-voustélécharger ce script?