Runsub

This help page is for Desktop Studio. This information is also available for CXone Studio.

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

Roept een subscript aan, dat wordt uitgevoerd en uiteindelijk Return action gebruikt om terug te keren naar de uitvoering van het hoofdscript. Wanneer het subscript wordt uitgevoerd, slaat het een waarde op in de eigenschap ReturnValue van de Return-actie. Deze waarde wordt vervolgens doorgegeven aan de eigenschap ReturnVariable in de Runsub-actie in het hoofdscript.

Deze actie kan vooral handig zijn als u een of meer grotere scripts hebt die u liever in kleinere, overzichtelijke scripts opsplitst.

Afhankelijkheden

  • Het hoofdscript en het subscript moeten zich in dezelfde map bevinden.

  • Het type van het hoofdscript en het subscript moet gelijk zijn. Als het hoofdscript bijvoorbeeld een telefoonscript is, moet het subscript ook een telefoonscript zijn.
  • Als u een Runsub-actie in het hoofdscript plaatst, MOET het subscript een Return-actie hebben.
  • Runsub kan meerdere variabelen van het hoofdscript naar het subscript doorgeven, maar het subscript kan slechts één waarde (via de eigenschap ReturnVariable) retourneren naar het hoofdscript.
  • Alle variabelen die in het subscript worden gedefinieerd, zijn niet langer beschikbaar wanneer het subscript wordt beëindigd, tenzij u ze declareert als algemeen. U kunt dit doen in een SNIPPET-actie door global: toe te voegen vóór de naam van de variabele. Bijvoorbeeld, ASSIGN global:varName = value. Een andere optie om toegang te krijgen tot een subscript, is het gebruik van de GET /contacts/{contactId}/custom-data Een pictogram van een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst. API.
  • Om de savetodb()-functie te gebruiken op een variabele in een Runsub-subscript, moet dit een globale variabele zijn.
  • Alle scripts die door RunScript , Spawn, Runsub of soortgelijke scriptacties worden aangeroepen, moeten geldig en actief zijn. Studio valideert tijdens het opslaan alle scripts die door acties worden aangeroepen. Als een van de scripts ongeldig of inactief is, geeft Studio een foutbericht weer en kunt u niet opslaan.

Ondersteunde scripttypen

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.

Generiek

E-mail Chat Telefoon Voicemail Werkitem SMS Digitaal

Vergelijkbare functies vergelijken

De volgende acties hebben vergelijkbare functies, maar met enkele belangrijke verschillen:

  • Runscript: wanneer Runscript een ander script triggert, is er geen manier om vanuit het tweede script terug te keren naar het eerste script.
  • Runsub: wanneer Runsub een subscript triggert, kan het script terugkeren naar het eerste script, zolang het subscript een Return-actie heeft. De Return-actie retourneert een waarde naar de Runsub-actie wanneer het subscript is voltooid.
  • SPAWN: start een tweede script dat parallel met het eerste script wordt uitgevoerd. Gespawnde scripts kunnen gegevens niet terug doorgeven naar het eerste script tenzij u een SIGNAL action opneemt in het gespawnde script.

Invoereigenschappen

Deze eigenschappen definiëren gegevens die de actie gebruikt bij het uitvoeren.

Vertakking

Beschrijving

bijschrift toe

Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram. The default is the action name.

ScriptName

Het script dat u wilt spawnen. U kunt op de link Choose Script boven aan het eigenschappenvenster van de actie klikken om een script van uw bedrijfseenheid te selecteren.

ReturnVariable

De waarde die wordt geretourneerd naar het hoofdscript wordt opgeslagen in deze eigenschap. Als u meerdere waarden wilt doorgeven, gebruikt u een array als variabele.
Parameters

Klik op de drie puntjes in het veld en voeg een variabele toe voor elke parameter die u naar het gespawnde script wilt sturen. Typ in het editorvenster één variabele per regel. Gebruik betekenisvolle namen voor de variabelen. Variabelenamen hoeven niet overeen te komen met de naam van de overeenkomstige variabele die wordt gebruikt in het gespawnde script.

Parameters die in een script worden verplaatst verschijnen in de trace-uitvoerwaarde van dat script in de Begin-actie.

Resultaatvertakkingsvoorwaarden

Met Resultaatvertakkingsvoorwaarden kunt u vertakkingen maken in uw script om verschillende resultaten te behandelen wanneer de actie wordt uitgevoerd.

Voorwaarde

Beschrijving

Default

Het pad dat altijd wordt gevolgd, behalve als het script voldoet aan een voorwaarde die vereist dat het een van de andere vertakkingen volgt. Dit pad wordt ook gevolgd als de andere vertakkingen van de actie niet zijn gedefinieerd.

OnError

Het pad dat wordt gevolgd als de actie niet correct is uitgevoerd. Als er bijvoorbeeld een onverwacht probleem is, zoals een slechte verbinding, syntaxfouten enz. De _ERR-variabele, met één onderstrepingsteken, moet een beknopte beschrijving van het probleem bevatten.

Voorbeeld van een script

Dit is een voorbeeld dat toont hoe deze actie kan worden gebruikt in scripts. Het is niet bedoeld als een compleet script. Het kan nodig zijn het script verder te bewerken.

Wanneer het hoofdscript (het eerste script in de afbeelding) wordt gestart, triggert de Runsub-actie onmiddellijk het subscript (het tweede script in de afbeelding). In het subscript bepaalt Voiceparams de instellingen voor tekst-naar-spraak. De Hours-actie triggert drie vertakkingen met verschillende Return-acties voor als het contactcenter open, gesloten of met vakantie is. Na afloop van de uitvoering van het subscript, worden de waarden uit de eigenschap ReturnValues (van de Return-actie) opgeslagen in het veld ReturnVariable (van de Runsub-actie in het hoofdscript). De Case-actie triggert vervolgens de relevante vertakkingen voor open, gesloten en feestdagen.

Hoofdscript

Een voorbeeldscript met Studio-acties en pijlen die de relaties tussen de acties aangeven. Elke actie heeft een label om aan te geven wat de actie in het script doet.

Wilt u dit script downloaden?

Subscript

Een voorbeeldscript met Studio-acties en pijlen die de relaties tussen de acties aangeven. Elke actie heeft een label om aan te geven wat de actie in het script doet.

De drie Return-acties retourneren waarden door middel van de ReturnValue-eigenschap, zodat de Case-actie in het hoofdscript kan bepalen welke vertakking moet worden gevolgd.

Wilt u dit script downloaden?