Spawn-scripts

Door een script te spawnen, kunt u een script handmatig uitvoeren. Dit wordt ook gebruikt om een script te starten vanaf andere scripts of externe processen. U kunt dit ook gebruiken om een script te testen. Bij het testen kan dit ook samen met script-traces worden gebruikt.

Om scripts te testen, kunt u scripts starten vanuit Studio met behulp van de trace option.

Om scripts te starten van andere scripts of processen:

  • Gebruik de SPAWN action in het oproepscript.
  • Met de POST /scripts/start Een pictogram van een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst. API. Dit is de aanbevolen oplossing om een script te spawnen vanaf elk extern proces.

Bedrijfseenheden kunnen maximaal 15.000 scripts uitvoeren, tenzij anders geconfigureerd. Wanneer deze limiet is bereikt, kunnen er geen scripts meer worden gestart of gespawned met behulp van een van de methoden die op deze pagina worden beschreven, totdat een of meer scripts niet meer worden uitgevoerd.

Scriptparameters

Met scriptparameters kunt u gegevens laten doorgaan in scripts. De gegevens kunnen komen van andere scripts, inclusief systeemscripts, of van externe bronnen, zoals CRM'sGesloten Klantrelatiebeheer: externe systemen voor het beheren van contacten, verkoopkansen, supportdetails en cases. of API's. Dit wordt aan de scripts doorgegeven in pX-variabelen, p1 tot en met pN, waarbij N het maximum aantal parameters is dat wordt ondersteund door de spawnmethode. U kunt opgeven welke gegevens aan het script moeten worden doorgegeven wanneer u een script spawnt met een van de opties die in het vorige gedeelte zijn genoemd.

Als u de namen van de parametervariabelen wilt wijzigen, kunt u de Begin-actie configureren in het gespawnde script met nieuwe namen. Wanneer het script de BEGIN-actie verwerkt, worden de pX-variabelen omgezet naar de nieuwe namen. Als u geen nieuwe namen opgeeft, behouden de variabelen de pX namen.

Wanneer gegevens worden doorgegeven in een script, kunt u ze zien in een trace. Selecteer de BEGIN-actie om de parametervariabelen te zien in de lijst met trace-uitvoervariabelen. Als u de BEGIN-actie hebt geconfigureerd met nieuwe namen voor variabelen, selecteert u de actie die volgt op BEGIN in de script-trace om de namen te zien. Parametervariabelen zijn alleen aanwezig als ze een waarde bevatten.

Aangepaste parameters:

  • Ondersteun een maximum van: 
    • 32 KB per waarde indien gespawnd met de SPAWN-actie.
    • 32 KB in totaal voor alle parameters, met inbegrip van de sluisteken als scheidingstekens, indien gespawnd door API.
  • Ondersteuning variabelesubstitutie. Voer de naam van de variabele in tussen accolades ( { } ).
  • Ondersteun 1-20 parameters bij het starten via de SPAWN-actie of API.
  • Geen ondersteuning voor dynamische gegevensobjecten. Objecten moeten eerst worden geconverteerd naar een JSON-string.

Vergelijking van Studio-acties

Er zijn drie Studio-acties die een nieuw script starten vanaf het huidige script. Er zijn echter enkele verschillen:

  • Runscript: wanneer  een ander script triggert, is er geen manier om vanuit het tweede script terug te keren naar het eerste script.
  • Runsub: wanneer een subscript triggert, kan het script terugkeren naar het eerste script, zolang het subscript een -actie heeft. De -actie retourneert een waarde naar de -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 action opneemt in het gespawnde script.

Spawnen vanaf een ander script met de SPAWN-actie

Als u geen parameterwaarden moet doorgeven naar het onderliggende script, hoeft u de SPAWN-actie alleen toe te voegen en te configureren in het bovenliggende script. Als u parameters moet doorgeven, moet u de volgende configuraties maken:

  • Breng de volgende wijzigingen aan in het bovenliggende script:
    • Plaats de SPAWN-actie op het punt waar u het onderliggende script wilt spawnen. Configureer de eigenschap Parameters in de SPAWN-actie met elke waarde die u moet doorgeven aan het onderliggende script. Waarden worden doorgegeven in variabelen p1 tot p9.
    • Configureer de other properties van de SPAWN-actie.

  • Breng de volgende wijzigingen aan in het onderliggende script.

    • Configureer de eigenschap Parameters in de -actie om de naam te wijzigen van de aangepaste parametervariabelen. Als u niets doet, blijven aangepaste parameterwaarden in de -variabelen.
    • Als u waarden moet teruggeven aan het bovenliggende script of de oproeptoepassing, kunt u de action toevoegen en configureren.

Spawn een script via API

Gebruik de POST /scripts/start Een pictogram van een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst. API om een script te spawnen..

Wanneer u deze API gebruikt, is het belangrijk om rekening te houden met het feit dat:

  • De volgende parameters zijn vereist:
    • skillId: de waarde moet een geheel getal zijn wanneer het word verzonden als JSON, maar niet als het wordt verzonden als queryparameters. Skills moeten:
        • Wees actief.
        • Stem het scriptmediatype af. Telefoonscripts moeten bijvoorbeeld correleren met telefoonskills. U kunt het skilltype vinden op het tabblad Details van een skill. Scripts van het type Generic werken met elke actieve skill.

    • scriptId of scriptPath: het gebruik van scriptPath is aanbevolen. De script-ID verandert elke keer wanneer wijzigingen aan het script worden opgeslagen. Dit moet dus worden bijgewerkt in de parameter.

  • U kunt maximaal 20 parameters opnemen.
  • Parameters moeten worden verzonden in een lijst, gescheiden door sluistekens.
  • De API ondersteunt maximum 32 KB voor alle parameters, inclusief de sluistekens.
  • Parameters kunnen geen sluistekens bevatten, tenzij ze worden gebruikt als scheidingstekens.
  • Als de aanvraag wordt verzonden als JSON, moeten voorbehouden tekens correct worden vermeden.
  • Als de aanvraag wordt verzonden via URL-queryparameters, moeten de parameters URL-gecodeerd zijn.