SNIPPET

Hiermee kunt u aangepaste codes toevoegen aan uw script.

Afhankelijkheden

• De code die in deze actie wordt gebruikt, moet geschreven zijn in Snippet, een intern ontwikkelde scripttaal voor CXone Mpower. De Studio technische referentiehandleiding geeft gedetailleerde informatie over scripts maken in snippets.
• Attributen van dynamische gegevensobjecten mogen niet de naam __type (met twee onderstrepingstekens) hebben. Dit woord is gereserveerd voor gebruik bij het parseren van JSON uit dynamische objecten.
• Met de actie Snippet kunt u API-oproepen gebruiken. De maximale responsgrootte is 32 KB. Deze komt overeen met de limiet voor responsgrootte in de actie REST API.  De limiet wordt strikt opgelegd om clusterinstabiliteit en storingen te voorkomen. Als u dat kunt, gebruik dan in plaats daarvan de REST API action. Dit heeft dezelfde limiet maar kan een zwaardere last aan. Als u de SNIPPET-actie moet gebruiken, volgt u deze tips om de grootte van de geretourneerde gegevens te verminderen.

  • Filter de data in de API-respons. Wanneer u bijvoorbeeld de NICE rapportage-API gebruikt om contacten op te halen, kunt u de resultaten filteren op de startDate en de endDate van het contact. Met deze API-oproep kunt u een maximaal aantal items retourneren en limiteren. Raadpleeg de API-documentatie die bij uw scriptintegratie werd geleverd om te bekijken welke filters u kunt gebruiken.

  • Werk het API-verzoek bij om alleen de data te retourneren die u nodig hebt. Wanneer u bijvoorbeeld de NICE rapportage-API gebruikt om contacten op te halen, kunt u de velden contactId of agentId gebruiken om alleen relevante data te retourneren. Raadpleeg de documentatie voor API's die bij uw scriptintegratie werd geleverd om te bepalen welke datalimieten u kunt gebruiken.

  • Wanneer de vorige oplossingen het probleem niet verhelpen, kunt u middleware bouwen.

• De maximale grootte van arrays in Studio is 63 miljoen elementen. Als deze arraygrootte wordt overschreden, resulteert dit in de volgende fout in de __err variabele in een scripttracering: Array-index buiten bereik. De huidige array-index ([index]) overschrijdt de maximaal toegestane index (63000000). Wanneer de arraygrootte wordt overschreden, neemt het script de SNIPPET-tak van de actie Error. Als de Error-tak niet is verbonden, wordt het script nog steeds uitgevoerd, maar zonder de array-informatie. U kunt scripts configureren om u te waarschuwen wanneer de maximale arraygrootte is overschreden door een EMAIL-actie toe te voegen aan de SNIPPET-tak van de Error-actie. Ten slotte kunt u logica toevoegen in de Error-tak om door te gaan met het script. Houd er rekening mee dat het proces doorgaat zonder de array-informatie.

Ondersteunde scripttypen

Generiek	E-mail	Chat	Telefoon	Voicemail	Werkitem	SMS	Digitaal

Invoereigenschappen

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

Vertakking	Beschrijving
Caption	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.
Data	Bevat de aangepaste code die is toegevoegd in het Snippet editor-venster. Dit kan meerdere ASSIGN- en DYNAMIC -opdrachten, verschillende verklaringen voor datatransportbesturing en ingebouwde en gebruikergedefinieerde functies bevatten.
MaxStringSize	Stelt de maximale stringgrootte in voor alle opdrachten in de eigenschap Data. De opties zijn: Limit2K, Limit4K, Limit8K, Limit16K, Limit32K. Deze limiet is van toepassing op de integratiereacties met Rest API's en SOAP.

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.

Tips en trucs

• Gebruik de functie asjson() in een Snippet actie en sla de resulterende JSON op in een stringvariabele. Gebruik deze stringvariabele in de eigenschappen van andere Studio-acties wanneer u de JSON-gegevens wilt doorgeven. Zo verkleint u de kans op validatiefouten bij het opslaan van het script.
• Als u een IVR Interactive Voice Response: een telefoonmenu waarmee bellers via telefoontoetsen en/of gesproken opdrachten keuzes kunnen maken en/of informatie kunnen invoeren.-systeem met ASR Automatische spraakherkenning: klanten kunnen op audioprompts reageren door een antwoord in te spreken.-ondersteuning afstemt, is er een set van parameters die u kunt gebruiken in fragmenten.
• De taal van Snippet biedt trefwoordopdrachten waarmee u variabelen en objecten kunt declareren, lussen en iteratieve verklaringen kunt maken en meer.
• Studio heeft ingebouwde functies die u kunt gebruiken in uw scripts.
• U kunt uw eigen aangepaste functies maken om ze te gebruiken in fragmenten.
• U kunt Fragment code ook debuggen in het Snippet editor -venster.

Snippet Editor venster

Het venster Snippet editor opent wanneer u dubbelklikt op een Snippet-actie.

Het Snippet editor-venster in de Snippet-actie heeft twee tabbladen. Op beide tabbladen kunt u dezelfde types code maken. U kunt heen en terug schakelen tussen de tabbladen en uw code op een van beide bewerken. De tabbladen zijn:

• Het tabblad Tekstweergave. Dit is een vrij tekstveld waar u uw code handmatig kunt invoeren.
• Het tabblad Boomstructuur. Dit is een grafische interface die u kunt gebruiken om uw code te bouwen. Dit tabblad heeft een lijst waarin u trefwoorden kunt selecteren om verklaringen toe te voegen aan het fragment.

Voorbeeld van een script

In dit voorbeeld wordt de code in de Snippet gebruikt om te testen of een prospect kan worden gemaakt met behulp van informatie uit een extern systeem.

Download dit script.