RUNSUB

Deze Help-pagina is bedoeld voor Studio. Deze informatie is ook beschikbaar voor Desktop Studio.

Roept een subscript aan, dat wordt uitgevoerd en vervolgens de Return actie gebruikt om terug te keren naar het hoofdscript en de uitvoering daarvan voort te zetten. Wanneer het subscript wordt uitgevoerd, slaat het een waarde op in de eigenschap ReturnValue van de actie Return en geeft die waarde vervolgens terug aan de eigenschap ReturnVariable in de actie Runsub 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

Een vierkant waaruit een lijnvertakking komt die naar drie andere vierkanten gaat.

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 -actie opneemt in het gespawnde script.

Invoereigenschappen

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

Vertakking

Beschrijving

Add Caption

Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram.

Script Name

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.

Return Variable

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

Hiermee kunt u de naam wijzigen van de standaardvariabelen die waarden bevatten voor parameters die u naar het gegenereerde of onderliggende script wilt verzenden. De standaardvariabelen zijn p1 - p9, maar als u namen opgeeft in deze eigenschap, vervangen deze namen de standaardvariabelenamen waaraan de parameterwaarden worden doorgegeven. Als u de namen niet wijzigt, behouden de variabelen hun standaard pX-namen.

To change the names, click the ellipsis icon in the field and add variable names for each parameter you want to send to the spawned or child script. Enter up to nine names, one per line in the editor window. Om de namen te wijzigen, voegt u nieuwe namen toe voor elke parameter die u naar het gegenereerde of onderliggende script wilt verzenden. Voer maximaal negen variabelenamen in, één per regel. Variabelenamen hoeven niet overeen te komen met de naam van de overeenkomstige variabele die in het gegenereerde script wordt gebruikt, maar ze moeten wel betekenisvol zijn. Deze waarden worden doorgegeven als parameter variablesparametervariabelen p1 - p9.

Parameters die aan een script worden doorgegeven, verschijnen in de trace-uitvoer van dat script in de Beginactie.

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.

Error

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?