Runsub

Diese Hilfeseite bezieht sich auf CXone Studio. Diese Informationen sind auch für Desktop Studio verfügbar.

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.

ABHÄNGIGKEITEN

  • 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, es sei denn, Sie deklarieren sie als globale Variablen. Dies können Sie erreichen, indem Sie in einer SNIPPET-Aktion vor dem Namen der Variablen global: hinzufügen. Zum Beispiel ASSIGN global:varName = value. Eine weitere Option zum Zugriff auf Daten in einem Subskript ist die Verwendung der API GET /contacts/{contactId}/custom-data Ein Quadrat mit einem Pfeil, der von der Mitte aus nach oben rechts weist..
  • Damit die savetodb()-Funktion für eine Variable in einem Runsub-Subskript verwendet werden kann, muss es sich um eine globale Variable handeln.
  • 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.

Unterstützte Skripttypen

Ein Quadrat, von dem eine Linie abzweigt, die zu drei anderen Quadraten verläuft.

Allgemein

E-Mail Chat Telefon Voicemail Arbeitselement SMS Digital

Vergleich ähnlicher Aktionen

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

  • Runscript: Wenn Runscript ein anderes Skript auslöst, kehrt es nicht vom zweiten Skript zum ersten Skript zurück.
  • 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.
  • SPAWN: Startet ein zweites Skript, das parallel zum ersten Skript ausgeführt wird. Generierte Skripte können keine Daten an das erste Skript zurückgeben, es sei denn, Sie schließen eine SIGNAL-Aktion in das generierte Skript ein.

Eingabeeigenschaften

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

Eigenschaft

Beschreibung

Add 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.

Script Name

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 aus Ihrer Geschäftseinheit auszuwählen.

Return Variable

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.

Fehler

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.

Skriptbeispiel

Dies ist ein Beispiel, das zeigt, wie diese Aktion in Skripten verwendet werden kann. Es handelt sich nicht um ein vollständiges Skript. Möglicherweise müssen weitere Skriptteile erstellt werden.

Im folgenden Hauptskript (oben dargestellt) löst die Aktion Runsub bei Auslösung des Skripts umgehend das Subskript aus (unten dargestellt). Im Subskript legt Voiceparams die Einstellungen für die Sprachausgabe und die Hours-Aktion die Verzweigungen für geöffnet, geschlossen und Feiertag für drei verschiedene Return-Aktionen fest. Wenn das Subskript beendet ist, werden die Werte in der Eigenschaft ReturnValues (in der Return-Aktion) im Feld ReturnVariable gespeichert (Runsub-Aktion im Hauptskript). Die Aktion Case legt dann entsprechend die Verzweigungen für geöffnet, geschlossen und Feiertag/Urlaub fest.

Hauptskript

Ein Beispielskript, das die Studio-Aktionen mit Pfeilen verbindet. Jede Aktion ist mit einer Beschriftung versehen, die angibt, was die Aktion im Skript bewirkt.

Möchten Sie dieses Skript herunterladen?

Subscript

Ein Beispielskript, das die Studio-Aktionen mit Pfeilen verbindet. Jede Aktion ist mit einer Beschriftung versehen, die angibt, was die Aktion im Skript bewirkt.

Die drei Return-Aktionen stellen in der Eigenschaft ReturnValue Werte bereit, damit die Case-Aktion im Hauptskript bestimmen kann, welcher Verzweigung gefolgt wird.

Möchten Sie dieses Skript herunterladen?