Verklaringen

De informatie op deze helppagina is zowel van toepassing op CXone Studio als op Desktop Studio.

Verklaringen definiëren de acties die een script onderneemt wanneer het wordt uitgevoerd. Dit omvat het maken van variabelen, the toewijzen van nieuwe waarden, het uitvoeren van berekeningen en logische keuzen maken op basis van een bepaalde voorwaarde. Sommige verklaringen voeren alleen een taak uit, zoals het toewijzen van een waarde aan een variabele. Andere verklaringen beïnvloeden de flow van het script. Verklaringen worden uitgevoerd in een logische volgorde, maar die volgorde kan, telkens wanneer het script wordt uitgevoerd, wijzigen.

Verklaringen in snippets bestaan uit een of meer coderegels. Een eenvoudige verklaring op één regel kan een variabele maken en er een waarde aan toewijzen, zoals:

ASSIGN firstName = "Beowulf"

Een complexe verklaring kan veel geneste groepen of regels hebben, zoals:

ASSIGN Names="Odin|Freya|Thor|Loki" ASSIGN SubCounter=1 FOREACH Name IN Names { IF Name = "Odin" | Name = "Freya" { ASSIGN NewNames[SubCounter]= "{Name}" ASSIGN SubCounter=SubCounter + 1 } }

De logische volgorde van uitvoering van de verklaring in een snippet kan worden gewijzigd als er een fout in de snippet is. Als er een fout optreedt, wordt de Snippet-actie onmiddellijk beëindigd. De resterende verklaringen in de snippet worden niet uitgevoerd. In plaats daarvan wordt een foutbericht opgeslagen in een _ERR-variabele die aangeeft wat het probleem is.

Types verklaringen

U kunt de volgende types verklaringen gebruiken in snippets:

  • Declaratie: gebruik declaratieverklaringen voor het declareren of maken van nieuwe variabelen, objecten en functies.
  • Besluitvorming: gebruik besluitvormingsverklaringen om de fragmentcode een taak laten selecteren die moet worden uitgevoerd op basis van de voorwaarden die u opgeeft. U kunt ze gebruiken om de lineaire flow van wat er in uw script gebeurt, te beheren.
  • Looping: gebruik lusverklaringen om het fragment een taak of set van taken herhaaldelijk te laten uitvoeren tot aan de opgegeven eindvoorwaarde is voldaan.
  • Overige: via deze verklaringen kunt u functies beëindigen, resultaten weergeven in het Snippet editor-venster tijdens het debuggen en en webservice proxy-DLL's opnemen in uw fragmenten.

Trefwoorden

Trefwoorden zijn opdrachten waarmee verklaringen worden begonnen. Het zijn vooraf gedefinieerde, gereserveerde voorwaarden. De compiler herkent het trefwoord en voert dan de bijbehorende taak uit.

Aan elke type verklaring dat u kunt gebruiken in een snippet, is er een trefwoord aan gekoppeld. Om bijvoorbeeld een variabele te declareren, kunt u het trefwoord ASSIGN gebruiken. Of om een selectieverklaring te maken, kunt u het IF-trefwoord gebruiken. Zowel de verklaring als het trefwoord delen dezelfde naam. Een IF-verklaring gebruikt dus het IF-trefwoord.

De trefwoorden die beschikbaar zijn in de Snippet taal worden beschreven, samen met de verklaring die aan elk trefwoord is gekoppeld. Er is ook een complete lijst van trefwoorden beschikbaar.

Syntaxis verklaring

Alle verklaringen beginnen met een trefwoord en worden gevolg door woorden of code die definieert wat de verklaring doet. Elke verklaring heeft een eigen syntaxis. Het gedeelte met het syntaxisoverzicht op deze pagina beschrijft u de syntaxis van verklaringen moet worden gelezen.

Sommige verklaringen vereisen een voorwaardelijke code. Dit is een code die een voorwaarde instelt en definieert wat er gebeurt als er niet is voldaan aan de voorwaarde. Voorwaardelijke code kan één of meerdere verklaringen zijn. Deze moet altijd tussen accolades ({ }) staan, zelfs als het een enkele lijn is. De voorwaardelijke code wordt soms een blok genoemd.

Wanneer de compiler een regeleinde of een sluit-accolade tegenkomt, wordt het einde van de instructie herkend. De plaatsing van accolades is relatief flexibel. De volgende indelingen zijn allemaal beschikbaar:


IF x=1 {TRACE "one" } 

IF x=1 {TRACE "one" } IF x=2 {TRACE "two" }
IF x=1 {
  TRACE "one"
}


IF x=1
{
  TRACE "one"
}

Wanneer de geïntegreerde code meer dan een verklaring vereist, volgt u deze regels:

  • Plaats één verklaring per regel.
  • Als er meerdere verklaringen vereist zijn, plaatst u ze op afzonderlijke regels. Dit maakt het gemakkelijker om de code te lezen.
  • Geïntegreerde verklaringen die hun eigen geïntegreerde code vereisen, kunnen meerdere regels innemen waarbij de geldige indelingen voor het gebruik van accolades.

Syntaxisoverzichten

In de online helppagina's die elke type verklaring dekken, heeft elk verklaringstype een syntaxisoverzicht. Het overzicht toont u de indeling die dat type verklaring gebruikt. Dit toont u welke elementen vereist zijn en wat er optioneel is. Dit demonstreert ook hoe de syntaxiselementen moeten genest zijn.

De volgende tabel definieert elk element in de syntaxisoverzichten. Niet alle verklaringen bevatten elk element. Bij het ontcijferen van een syntaxisoverzicht moet u aandacht besteden aan het nesten van elementen.

Element

Details
COMMAND

Dit is de naam van het trefwoord dat u moet gebruiken met de verklaring. Vervang COMMAND door het trefwoord voor de verklaring die u maakt.

Trefwoorden zijn niet hoofdlettergevoelig. Bijvoorbeeld: FOREACH is hetzelfde als foreach naar de compiler. De actie Snippet converteert alle trefwoorden automatisch naar hoofdletters wanneer u de snippet de volgende keer opent.

In the online help worden trefwoorden altijd opgemaakt in hoofdletters.
<required>

Hoekhaken geven een vereist element aan. De tekst tussen de haken geeft het type element aan, zoals een expressie, een variabele of een letterlijke waarde.

In een syntaxisoverzicht van een FOREACH-verklaring, zijn er twee vereiste elementen.

FOREACH <var> in <array> { ... [ BREAK]}

De hoekhaken en de tekst binnenin mogen nooit letterlijk in uw script worden gebruikt. Vervang dat gedeelte door het code-element dat het beschrijft. Zo kunt u bijvoorbeeld <expression> vervangen door een uitdrukking, zoals i = 0.
[optional]

Vierkante haken geven een optioneel element aan. De tekst tussen de haken geeft het type element aan dat u kunt gebruiken. In het IF-syntaxisoverzicht is de optionele ELSE-clausule tussen vierkante haken gezet: [ELSE { ... }.

Als u een optioneel element gebruikt, moet het verschijnen op de locatie die is aangegeven in het syntaxisoverzicht ten opzichte van andere elementen.

De vierkante haken mogen nooit letterlijk in uw script worden gebruikt.
{ ... } Accolades geven een codeblok aan dat kan worden gebruikt.

Accolades verschillen van de hoekhaken en vierkante haken die worden gebruikt in het syntaxisoverzicht. Hoekhaken en vierkante haken zijn niet bedoeld om uw code te worden opgenomen, maar accolades moeten letterlijk in uw code worden opgenomen. U moet echter het weglatingsteken ( ... ) vervangen tussen de accolades in het syntaxisoverzicht met Snippet-verklaringen.

Verticale streep ( | )

De verticale streep geeft aan waar u kunt kiezen wat u wilt opnemen in de verklaring. In het syntaxisoverzicht voor de ASSIGN-verklaring, geeft de verticale streep bijvoorbeeld aan dat u de keuze hebt om de waarde tussen dubbele aanhalingstekens te plaatsen:

ASSIGN <variable> = "<value>" | <value>

De toelichting van de syntaxis licht de keuze toe.
Weglatingsteken (...)

Een weglatingsteken geeft een van twee zaken aan:

  • Waar de code in een blok gaat indien aangetroffen tussen accolades.
  • Een doorlopend patroon, indien aangetroffen tussen vierkante haken met een trefwoord.

Een voorbeeld van een weglatingsteken dat wordt gebruikt om een doorlopend patroon aan te geven, vindt u in het SELECT syntaxisoverzicht:

SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }>

De[CASE ...] geeft aan dat u doorgaat met het toevoegen van zoveel CASE clausules als u nodig hebt volgens het opgemaakte patroon.

Bijvoorbeeld: het syntaxisoverzicht voor de IF-verklaringen die worden gebruikt op deze pagina, is:

IF <expression> <{ ... }>

Dit overzicht toont dat:

  • Het trefwoord IF is.
  • Het volgende element is een vereiste uitdrukking.
  • Het laatste element is een vereist codeblok dat tussen accolades moet worden geplaatst.

Het syntaxisoverzicht voor SWITCH-verklaringen is complexer:

SWITCH <var> <{CASE <literal> [{ ... }] [CASE <literal> [{ ... }]] [CASE ...] [DEFAULT [{ ... }]] }>

Dit overzicht toont dat:

  • Het trefwoord SWITCH is.
  • Het volgende element is een vereiste variabelenaam.
  • Het codeblok is vereist en moet een CASE-clausule bevatten met een letterlijke waarde.
  • De vereiste CASE clausule kan een optioneel codeblok bevatten.
  • Het codeblok van de SWITCH-verklaring kan extra optionele CASE-clausules bevatten volgens het patroon dat tot stand is gebracht in het overzicht.
  • Het codeblok van de SWITCH-verklaring kan een optionele DEFAULT-clausule bevatten met een optioneel codeblok.