SNIPPET

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

Hiermee kunt u aangepaste codes toevoegen aan uw script.

Afhankelijkheden

  • De code die in deze actie wordt gebruikt, moet worden geschreven in Snippet, een interne scripttaal ontwikkeld door NICE CXone. 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.

    • Update het API-verzoek 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.

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

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

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

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.

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.

Een script met twee FRAGMENT-acties.

Download dit script.