Runsub

The Runsub action icon, a curled piece of paper with two arrows pointing to the right next to it at the top and bottom.

Ruft ein Subskript auf, das ausgeführt wird und dann die Return-action verwendet, um zum Hauptskript zurückzukehren und es weiter auszuführen. Wenn das Subskript ausgeführt wird, speichert es einen Wert in der Eigenschaft ReturnValue der Return-Aktion und gibt diesen Wert dann zurück an die Eigenschaft ReturnVariable in der Runsub-Aktion im Hauptskript.

Diese Aktion kann besonders nützlich sein, wenn Sie ein oder mehrere größere Skripte haben, die Sie lieber in kleinere Skripte aufteilen würden.

Dependencies

  • Hauptskript und Subskript müssen sich im gleichen Ordner befinden.

  • Der Hauptskripttyp und der Subskripttyp müssen gleich sein. Wenn zum Beispiel das Hauptskript ein Telefonskript ist, muss das Subskript ebenfalls ein Telefonskript sein.
  • Platzieren Sie eine Runsub-Aktion im Hauptskript, MUSS Ihr Subskript eine Return-Aktion enthalten.
  • Runsub kann mehrere Variablen vom Hauptskript an das Subskript übergeben, aber das Subskript kann nur einen Wert (über die Eigenschaft ReturnVariable) an das Hauptskript zurückgeben.
  • Alle im Subskript definierten Variablen sind nicht mehr verfügbar, wenn das Subskript beendet wird.
  • Alle Skripte, die von RunScript , Spawn, Runsub oder ähnlichen Skripten aufgerufen werden, müssen gültig und aktiv sein. Während des Speichervorgangs validiert Studio alle von Aktionen aufgerufenen Skripte. Wenn eine davon ungültig oder inaktiv ist, zeigt Studio eine Fehlermeldung an und Sie können nicht speichern.

Supported Script Types

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

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

Allgemein

E-Mail Chat Telefon Voicemail Arbeitselement SMS Digital

Comparison of Similar Actions

Die folgenden Aktionen haben ähnliche Funktionen, aber mit einigen wichtigen Unterschieden:

  • Runscript: Wenn Runscript ein Subskript auslöst, gibt es keine Möglichkeit, vom Subskript zum ersten Skript zurückzukehren.
  • Runsub: Wenn Runsub ein Subskript auslöst, kann das Skript zum ersten Skript zurückkehren, sofern das Subskript eine Return-Aktion hat. Die Return-Aktion liefert einen Wert an die Runsub-Aktion zurück, wenn das Subskript beendet ist.

Input Properties

Diese Eigenschaften definieren Daten, die von der Aktion bei der Ausführung verwendet werden.

Eigenschaft

Beschreibung

Caption

Geben Sie eine kurze Phrase ein, mit der diese Aktion im Skript eindeutig identifiziert wird. Die Beschriftung wird im Skript-Arbeitsbereich unter dem Symbol der Aktion angezeigt. The default is the action name.

ScriptName

Das Skript, das Sie erzeugen möchten. Sie können oben im Eigenschaften-Feld der Aktion auf den Link Choose Script klicken, um ein Skript auszuwählen, das für Ihre Geschäftseinheit gespeichert ist.

ReturnVariable

Der Wert, der an das Hauptskript zurückgegeben wird, wird in dieser Eigenschaft gespeichert. Verwenden Sie ein Array als Variable, um mehrere Werte zu übergeben.
Parameters

Klicken Sie auf die Ellipse im Feld und fügen Sie eine Variable für jeden Parameter hinzu, den Sie an das generierte Skript senden möchten. Geben Sie eine Variable pro Zeile in das Editor-Fenster ein. Verwenden Sie aussagekräftige Variablennamen. Variablennamen müssen dem Namen der entsprechenden Variablen, die in dem generierten Skript verwendet wird, nicht entsprechen.

Parameter, die an ein Skript übergeben werden, erscheinen in der Trace-Ausgabe dieses Skripts in der Begin-Aktion.

Bedingungen für Ergebnisverzweigungen

Mit Bedingungen für Ergebnisverzweigungen können Sie in Ihrem Skript Verzweigungen erstellen, die für unterschiedliche Ergebnisse bei der Ausführung einer Aktion vorgesehen sind.

Bedingung

Beschreibung

Default

Genommener Pfad, außer das Skript erfüllt eine Bedingung, die es erfordert, einer der anderen Verzweigungen zu folgen. Dieser Pfad wird auch genommen, wenn die anderen Verzweigungen der Aktion nicht definiert sind.

OnError

Genommener Pfad, wenn die Aktion nicht ordnungsgemäß ausgeführt werden kann. Beispiel: Wenn ein unerwartetes Problem auftritt, wie eine schlechte Verbindung oder Syntaxfehler. Die Variable _ERR, mit einem einzelnen Unterstrich, sollte mit einer kurzen Erläuterung des Problems ausgefüllt werden.

Script Example

Bei diesem Beispiel handelt es sich nicht um ein vollständiges Skript. Zur Verwendung dieser Aktion muss das Skript vervollständigt werden.

In the main script below (shown top), when the script is triggered, the Runsub action immediately triggers the subscript (shown bottom). In the subscript, Voiceparams sets the Text-to-Speech settings, and the Hours action sets branches for open, closed, and holiday to three different Return actions. When the subscript is finished, the values in the ReturnValues property (in the Return action) are stored in the ReturnVariable field (Runsub action in the main script). The Case action then sets the open, closed, and holiday branches as appropriate.

Main Script

An example script, showing Studio actions with arrows connecting them. Each action has a label beneath it to indicate what the action does in the script.

Would you like to download this script?

Subscript

An example script, showing Studio actions with arrows connecting them. Each action has a label beneath it to indicate what the action does in the script.

The three Return actions provide values in the ReturnValue property so the Case action in the main script can determine which branch to follow.

Would you like to download this script?