Extraits de code personnalisés

Les informations contenues dans cette page d’aide s’appliquent à la fois à CXone Studio et à Desktop Studio.

Certains scripts nécessitent plus de complexité que les actions Studio ne peuvent en fournir à elles seules. Studio vous permet d’ajouter du code personnalisé à vos scripts. Cela vous permet de personnaliser vos scripts en fonction des besoins de votre organisation.

Le codage personnalisé nécessite des connaissances en matière de script ou de programmation. Studio utilise un langage de programmation personnalisé appelé Snippet. NICE CXone a développé ce langage pour l’utiliser dans Studio. Un guide de référence technique complet est disponible dans l’aide en ligne pour vous permettre d’apprendre à utiliser ce langage.

Faits saillants concernant les extraits de code

  • Les extraits de code peuvent contribuer à améliorer l’organisation et l’efficacité de vos scripts. Ils vous permettent de mieux contrôler les processus exécutés, ainsi que le moment et la manière dont ils s’exécutent. Vous pouvez créer vos propres variables et objets et ajouter une logique de programmation à l’aide d’instructions telles que IF, FOR, FOREACH, etc.
  • Certains produits et fonctionnalités requièrent des extraits de code, mais vous pouvez les utiliser dans vos scripts même s’ils ne sont pas nécessaires.
  • Lorsqu’un produit ou une fonctionnalité nécessite des extraits de code, l’aide en ligne fournit des informations détaillées sur les extraits de code que vous devez inclure. Des exemples de scripts sont fournis pour montrer comment utiliser les extraits de code dans les scripts. Des scripts supplémentaires peuvent être nécessaires pour mettre en œuvre les produits ou les fonctionnalités.
  • Le langage de script Snippet est basé sur le cadre .NET. Il s’exécute côté serveur et se compile en MSIL (Microsoft Intermediate Language) comme le font C# et Visual Basic .NET.

Action d’extrait de code

Pour ajouter du code personnalisé à vos scripts, vous avez besoin d’une action Snippet. Vous pouvez double-cliquer sur cette action pour ouvrir un éditeur dans lequel vous pouvez ajouter votre code personnalisé. Vous pouvez également déboguer le code dans la fenêtre de l’éditeur. Il se peut que vous ayez besoin de plus d’une action Snippet dans votre script. Si vous utilisez plusieurs actions, mettez à jour le champ AJouter Caption de chacune d’entre elles avec une phrase qui aide à identifier son objectif.

L’emplacement d’une action Snippet est important. Si une Snippet attribue une valeur à une variable, elle doit être placée avant l’action qui a besoin de cette valeur. En revanche, si une Snippet contient un code décisionnel qui agit en fonction d’une valeur qui lui est transmise, l’Snippet doit être placée après l’action qui fournit la valeur.

Extraits de code par rapport aux actions

Certaines des actions que vous pouvez effectuer dans les extraits de code peuvent également être réalisées à l’aide des actions Studio. Par exemple, il existe des actions pour les instructions IF et FOR. Il existe également l’action ASSIGN, que vous pouvez utiliser pour créer une variable personnalisée et lui attribuer une valeur. L’utilisation de ces actions est un moyen acceptable d’ajouter ces capacités à votre script. Cependant, l’utilisation d’extraits de code est plus efficace.

En plaçant le code dans des extraits de code, votre script est plus propre, mieux organisé et plus facile à parcourir. Cela rend votre travail de scripteur plus facile et plus efficace. Si vous prenez l’habitude de toujours déclarer les variables dans les extraits de code, à l’avenir, si vous avez besoin de retrouver une déclaration particulière, vous aurez moins d’endroits où chercher.

Ajouter un code personnalisé à un script

L’action Snippet vous permet d’ajouter du code personnalisé à vos scripts. Cette action se trouve dans la section Avancé de la palette par défaut de l’onglet Outils.

  1. Dans Studio, ouvrez votre script.
  2. Placez une action Snippet dans votre script à l’endroit où vous avez besoin du code et reliez-la aux autres actions.
  3. Double-cliquez sur l’action pour ouvrir la fenêtre de l’éditeur. C’est ici que vous pouvez ajouter votre code.
  4. Cliquez sur l’onglet que vous souhaitez utiliser pour ajouter votre code. Chaque onglet propose une méthode différente pour ajouter du code. Les onglets sont les suivants :

  5. Déboguez votre code, au besoin.

  6. Cliquez en tout temps sur Apply pour enregistrer vos modifications sans fermer la fenêtre de l’éditeur.
  7. Cliquez sur OK lorsque vous avez fini de modifier le code.

Code avec Vue textuelle

L’onglet Vue textuelle de la fenêtre Extraits de code vous permet d’écrire votre code Snippet à la main. Un guide de référence complet est disponible dans l’aide en ligne pour vous permettre d’apprendre à utiliser ce langage.

  1. Dans Studio, ouvrez votre script.
  2. Ajoutez l’action Snippet à votre script et double-cliquez dessus pour ouvrir la fenêtre Extrait de code.
  3. Dans la partie gauche de l’onglet Arborescence, saisissez votre code. Vous pouvez taper le code ou le copier-coller à partir d’une autre source, comme ce site d’aide ou un autre script.
  4. Cliquez à tout moment sur l’onglet Tree View pour ajouter du code à partir des mots-clés prédéfinis. Vous pouvez utiliser les boutons fléchés vers le haut et vers le bas pour déplacer le code lié à un mot-clé à un autre endroit du script.
  5. Cliquez sur l’icône Check Syntax L’icône Vérifier la syntaxe, trois petits cercles verts avec un triangle pointant vers la droite. pour vérifier que la syntaxe du code actuel est correcte. Le champ d’état dans la barre d’outils au bas de l’onglet Vue textuelle affiche l’état Okay s’il n’y a pas d’erreurs. En cas d’erreur, un message d’erreur apparaît et le champ d’état de la barre d’outils affiche un message. Par exemple, le message peut être : Error at line 4.
  6. Cliquez sur l’icône Comment L’icône Commentaire, une équerre ouverte et une équerre fermée séparées par une barre oblique bleue. pour convertir la ligne où se trouve le curseur dans un commentaire.
  7. Cliquez sur l’icône Uncomment L’icône Annuler le commentaire, une grande barre oblique rouge superposée à une équerre ouverte et à une équerre fermée séparées par une barre oblique. pour supprimer les caractères de commentaire de la ligne où se trouve le curseur.
  8. Cliquez en tout temps sur Apply pour enregistrer vos modifications sans fermer la fenêtre de l’éditeur.
  9. Cliquez sur OK lorsque vous avez fini de modifier le code.

Code avec Arborescence

L’onglet Arborescence de la fenêtre Propriétés de l’extrait de code vous guide tout au long du processus de création de code personnalisé. Un ensemble prédéfini de mots-clés est à votre disposition.

  1. Dans Studio, ouvrez votre script.
  2. Ajoutez l’action Snippet à votre script et double-cliquez dessus pour ouvrir la fenêtre Extrait de code.
  3. Cliquez sur l’icône plus Un signe plus avec une flèche pointant vers le bas. en bas de l’onglet Arborescence.
  4. Sélectionnez le mot-clé que vous souhaitez ajouter à votre code.
  5. Cliquez sur le mot-clé qui apparaît dans la liste à gauche de la fenêtre pour afficher ses propriétés.
  6. Configurez les propriétés du mot-clé dans la liste située à droite de la fenêtre. Vous pouvez :

    • Sélectionnez chaque propriété pour en afficher la définition dans l’espace situé sous le volet de droite.
    • Reportez-vous à la section Mots-clés d’extrait de code de cette page pour plus de détails sur la configuration de chaque commande.
  7. Ajoutez d’autres mots-clés si nécessaire.
  8. Cliquez à tout moment sur l’onglet Text View pour visualiser le code écrit dans un format de codage traditionnel.
  9. Cliquez en tout temps sur Apply pour enregistrer vos modifications sans fermer la fenêtre de l’éditeur.
  10. Cliquez sur OK lorsque vous avez fini de modifier le code.

Déboguer l’extrait de code

L’action Snippet possède son propre débogueur que vous pouvez utiliser pour vérifier le code. Vous ne pouvez déboguer le code qu’à partir de l’onglet Vue textuelle.

Si vous avez créé votre code dans l’onglet Arborescence, vous pouvez utiliser le débogueur si vous passez à l’onglet Vue textuelle. Si le débogueur trouve des problèmes, utilisez le numéro de ligne spécifié pour déterminer quelle partie du code contient le problème. Vous pouvez ensuite revenir à l’onglet Arborescence pour corriger le problème.

D’autres options de débogage sont disponibles, notamment pour parcourir le code ligne par ligne et pour utiliser des points d’arrêt. Vous pouvez également utiliser les instructions TRACE dans le code de l’extrait pour produire du texte pendant le débogage. Cette sortie peut être utile pour résoudre des problèmes dans votre script.

  1. Dans Studio, ouvrez un script contenant une action Snippet.
  2. Double-cliquez sur l’action Snippet.
  3. Add Snippet code on the Text View tab, if it doesn't already contain some.
  4. On the right side of the Snippet editor window, click the Debugger tab.
  5. Click the down-arrow button on the right side of the Debug icon An icon of a window with a green right-facing triangle. On the right side of the icon is a down-facing black triangle that opens a drop-down menu. and select StartAn icon of a green play button triangle..
  6. If there are any syntax errors in the code, the Snippet editor window expands. All errors in the code appear in a pane at the bottom of the window. If there are no errors, skip to the next step.

    1. Correct the errors.
    2. When the errors have been corrected, click the Close or Clear Trace Output icons An X. to close the error pane.
    3. Start the debugger again.
  7. View the contents of the Variables as Text tab. The tab shows the variables and their values when all of the code has been executed if you didn't set a breakpoint.
  8. You can select one or more lines in the snippet code and click the Comment out selected lines icon An icon with open and closed angle brackets next to each other with a blue forward slash between them.. This is helpful if you want to remove some code to see how the outcome of the debugging changes.
  9. You can select one or more lines of commented-out code and click the Uncomment the selected lines icon An icon with open and closed angle brackets next to each other with a forward slash between them. A large red forward slash crosses the other characters. to add those lines back into the snippet.

Mots-clés d’extrait de code dans l’onglet Arborescence

Les mots-clés, ou commandes, font partie de la syntaxe des déclarations dans le langage Snippet. Il s’agit de termes prédéfinis qui sont réservés à des usages spécifiques dans les scripts. Le compilateur reconnaît le mot-clé et exécute le comportement qui lui est associé. Par exemple, lorsque le compilateur voit le mot-clé ASSIGN, il crée une nouvelle variable avec le nom et la valeur spécifiés après le mot-clé. Par exemple : ASSIGN varName = 1

Les mots-clés étant des termes réservés, ils ne peuvent pas être utilisés comme identificateurs d’objets ou de variables dans vos scripts.

De nombreux mots-clés ont également des actionsFermé Exécute un processus au sein d’un script Studio, tel que la collecte de données client, l’écoute d’un message ou de musique, ou le routage d’un contact vers un agent. Studio portant le même nom. Par exemple, il existe un mot-clé IF et une action IF. Les deux accomplissent le même comportement dans votre script. Vous pouvez utiliser les actions Snippet avec du code personnalisé pour réduire le nombre d’actions dans vos scripts.

Les sections suivantes décrivent les options de mots-clés disponibles dans l’onglet Arborescence. Ces options comprennent la plupart des mots-clés que vous pouvez utiliser dans les extraits de code. Une liste complète de tous les mots-clés pris en charge est disponible dans la section de référence.

Assigner

Description : Les instructions ASSIGN créent une variable portant le nom et la valeur que vous spécifiez.

Action Studio : Assign (page d’aide dans CXone Studio : Assign)

Conventions d’attribution de nom : Suivez ces conventions pour l’attribution des noms aux variables :

  • Utiliser des caractères alphanumériques (a-z, A-Z, 0-9).

  • Le premier caractère du nom doit être une lettre.
  • Utilisez le caractère de soulignement ( _ ) et le signe du dollar ( $ ) partout dans le nom.
  • Si le dernier caractère d’un nom de variable est un signe de dollar, la valeur est traitée comme du texte.
  • N’utilisez pas les noms de variables prédéfinies ou de mots réservés.

En savoir plus : De plus amples informations sur les variables sont disponibles sur la page d’aide Variables. Plus d’informations sur le mot clé ASSIGN sont disponibles à la page Instructions de déclaration.

Propriétés de l’arborescence

Dans l’onglet Arborescence, ASSIGN apparaît sous la forme newvar="". Les propriétés suivantes doivent être configurées :

Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.

ASSIGN varName = value1
varName2 = value2

//Including the ASSIGN keyword is optional. 
//It's best practice to use this keyword every time you create a variable.
//When you use advanced search, you can quickly locate where a variable 
//is created if it includes this keyword. 

Pause

Description : Termine immédiatement une boucle.

Syntaxe : BREAK

Détails : Lorsque l’instruction BREAK est atteinte, la boucle en cours se termine immédiatement. Le script continue d’exécuter l’extrait de code situé sous la boucle jusqu’à ce qu’il soit terminé.

BREAK est facultatif. Si non inclus, la boucle continue jusqu’à ce que la condition d’arrêt définie soit remplie.

Appeler la fonction

Appelle une fonction préalablement définie.

Propriétés de l’arborescence

Dans l’onglet Arborescence, la Fonction d’appel apparaît sous la forme newcall().

Les propriétés suivantes doivent être configurées :

  • Arguments : Saisissez les arguments que vous devez transmettre à la fonction. Les arguments apparaissent entre les parenthèses dans le nom de la fonction. Par exemple, functionA (var1, var2).
  • Comment : Ajoutez un commentaire concernant la variable.
  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.
  • Name : Saisissez le nom de la fonction que vous souhaitez appeler.

Cas

Description : Définit l’une des instructions possibles à exécuter. Utilisé avec SWITCH ou SELECT.

Syntaxe : varie; voir SWITCH ou SELECT

Action Studio : (page d’aide dans CXone Studio : Case)

Détails :  CASE doit être utilisé dans le bloc de code conditionnel d’une instruction SWITCH ou SELECT. Ajoutez une ou plusieurs instructions CASE pour définir les blocs possibles pour l’exécution du script. Au moins un CASE est requis.

Lié : Incluez une instruction DEFAULT pour définir le cas utilisé si aucune des instructions CASE spécifiées ne s’applique.

Commentaire

Cache le texte dans le script afin que le compilateur ne le traite pas.

Utilisez des commentaires pour documenter votre script. Vous pouvez fournir des explications et des descriptions de chaque partie de votre texte afin qu’il soit facile à comprendre par la suite.

Propriétés de l’arborescence

Dans l’onglet Arborescence, Comment apparaît sous la forme //.

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire.
  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.

Chacun des mots-clés disponibles dans l’arborescence possède une propriété Comment. Cela vous permet d’ajouter un commentaire sur cette instance spécifique du mot-clé. Utilisez l’option Comment de l’onglet Arborescence pour ajouter un commentaire général sur l’extrait de code.

Déclarer une fonction

Description : Crée une fonction personnalisée.

Détails : Déclarez une fonction en lui donnant un <name> avec un ensemble de parenthèses ouvertes et fermées à la fin. Par exemple, FUNCTION functionName(). Ajoutez les [parameters] facultatifs entre les parenthèses. Les paramètres permettent de transmettre des données, appelées arguments, à l’entrée et à la sortie de la fonction.

Conventions d’attribution de nom : Lorsque vous attribuez un nom à des fonctions, suivez les conventions suivantes :

  • Utiliser des caractères alphanumériques (a-z, A-Z, 0-9).

  • Le premier caractère du nom doit être une lettre.
  • Utilisez le caractère de soulignement ( _ ) et le signe du dollar ( $ ) partout dans le nom.
  • N’utilisez pas de mots réservés ou de noms de fonctions intégrées.

En savoir plus : De plus amples informations sur les fonctions sont disponibles sur la page d’aide Fonctions.

Propriétés de l’arborescence

Dans l’onglet Arborescence, FUNCTION apparaît sous la forme FUNCTION newfunc().

Les propriétés suivantes doivent être configurées :

  • Arguments : Saisissez les arguments que vous souhaitez voir passer dans la fonction. Les arguments apparaissent entre les parenthèses dans le nom de la fonction. Par exemple, newfunc(var1, var2).
  • Comment : Ajoutez un commentaire concernant la variable.
  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.
  • Name : Saisissez le nom de la fonction.

Pour compléter FUNCTION, cliquez avec le bouton droit de la souris sur SWITCH 0 et ajoutez le mot-clé CASE pour chaque condition que vous voulez que le script évalue. Ajoutez une condition DEFAULT pour définir ce que fait le script lorsqu’aucune des options CASE définies ne s’applique. Configurez chaque CASE et le mot-clé DEFAULT.

Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.

FUNCTION TimerRound(Timer)
{
  IF Timer = "-1"
  {
    ASSIGN Timer = Timer
  }
  ELSE
  {
    ASSIGN PeriodLocation = Timer.indexof('.')
	IF PeriodLocation = 0
	{
	  ASSIGN Timer = Timer
	}
	ELSE
	{
	    ASSIGN DataLength = Timer.length
	    IF DataLength - PeriodLocation <= 2
	        {
	          ASSIGN Timer = Timer
            }   
	    ELSE
	     {
            ASSIGN DigitCheck = Timer.substr(PeriodLocation + 3, PeriodLocation + 3)
            IF DigitCheck >=5 && DigitCheck <= 9
               {
                  ASSIGN Timer = Timer + .01
               }
            ELSE
              {
                 ASSIGN Timer = Timer
              }
		
            ASSIGN Timer = Timer.substr(1, PeriodLocation + 2)
         }
      }
   }
  
   TRACE "{Timer}"
   RETURN Timer
}

IF TEST = 1
   {
      ASSIGN DC1 = "1.931876668494874"
   }   

   ASSIGN DC1 = TimerRound(DC1)

Par défaut

Description : Définit le bloc CASE utilisé si aucun des CASE spécifiés ne s’applique. Utilisé avec SWITCH et SELECT.

Syntaxe : Variable; voir SWITCH ou SELECT

Détails : DEFAULT doit être utilisé avec les blocs SWITCH ou SELECT, et il doit y avoir au moins une instruction CASE. DEFAULT ne peut pas être utilisé seul. DEFAULT est toujours facultatif. Il doit s’agir de la dernière clause de la liste des instructions CASE.

Pour

Description : Répète une instruction ou une série d’instructions un nombre spécifique de fois.

Propriétés de l’arborescence

Dans l’onglet Arborescence, FOR  apparaît sous la forme FOR i = 1 to 10.

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire concernant la boucle FOR .
  • EndValue : Saisissez la valeur de l’index de fin. La valeur par défaut est 10.

  • Iterator : Saisissez le nom de la variable qui contient l’index de la boucle en cours.

  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.
  • StartValue : Saisissez la valeur de l’index de départ. La valeur par défaut est 1.

Pour compléter FOR, cliquez avec le bouton droit de la souris sur FOR i = 1 to 10 et ajoutez les mots-clés et les comportements que vous souhaitez que le script exécute.

Exemples

Pour voir ces exemples dans l’arborescence, copiez et collez dans l’onglet Arborescence, puis cliquez sur l’onglet Arborescence.

IF TEST = 1
{
  ASSIGN Names = "Wes|Nate|Dan|Clay"
  ASSIGN EyeColors = "Blue|Blue|Brown|Brown"
  ASSIGN Signs = "Aquarius|Aries|Pisces|Leo"
  ASSIGN Foods = "Spagetti|Pizza|Sushi|Deep Fried Twinkies"
}

DYNAMIC Persons

ASSIGN PeopleCount = Names.size

FOR i = 1 TO PeopleCount
{
  ASSIGN Persons[i].Name = "{Names[i]}"
  ASSIGN Persons[i].Eyecolor = "{EyeColors[i]}"
  ASSIGN Persons[i].Sign = "{Signs[i]}"
  ASSIGN Persons[i].Food = "{Foods[i]}"
}
FOR i=1 TO 9
{
	a = "{a}{i}"
}
//Result: a="123456789"


FOR i=9 TO 1
{
	b = "{b}{i}"
}
//Result: b="987654321"

ForEach

Description : Répète une boucle une fois pour chaque élément du tableau de chaînes spécifié.

Propriétés de l’arborescence

Dans l’onglet Arborescence, FOREACH apparaît sous la forme FOREACH i in array.

Les propriétés suivantes doivent être configurées :

  • ArrayName : Le nom de la variable contenant le tableau auquel le script doit appliquer les comportements définis.
  • Comment : Ajoutez un commentaire concernant la boucle FOREACH .
  • Iterator : Saisissez le nom de la variable qui contient l’élément de tableau actuel.

  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.

Pour compléter FOREACH, cliquez avec le bouton droit de la souris sur FOREACH i in array et ajoutez les mots-clés et les comportements pour définir ce que vous voulez que le script fasse avec chaque élément du tableau spécifié.

Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.



IF TEST = 1 
{
	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

	}
}

Si

Description : Évalue une expression et emprunte une branche en fonction des résultats de l’évaluation.

Action Studio : If (page d’aide dans CXone Studio : If)

Propriétés de l’arborescence

Dans l’onglet Arborescence, IF apparaît sous la forme >IF 0 avec >True et False en dessous. >IF définit l’expression à évaluer. >True définit ce qui se passe si l’expression est évaluée comme vraie. >False définit ce qui se passe si l’expression est évaluée comme fausse.

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire sur l’instruction If.
  • Expression : Saisissez la condition que vous souhaitez que le script évalue.
  • Line Number : Le numéro de ligne sur laquelle se trouve la commande dans l’éditeur.

Pour compléter votre instruction IF, cliquez avec le bouton droit de la souris sur True et False et sélectionnez le mot-clé ou le comportement que vous souhaitez que le script exécute en fonction de l’évaluation de Expression. Il n’est pas nécessaire de fournir des options pour True et False. Vous pouvez ajouter plusieurs mots-clés ou comportements. Configurez les mots-clés ou les comportements sélectionnés selon vos besoins.

Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.

IF TEST = 1
   {
      ASSIGN contactID = "123456780"
      ASSIGN customerName = "XYZ International"
      ASSIGN CBWindowStart = #"{date} 8:00 AM"
      ASSIGN CBWindowEnd = #"{date} 4:30 PM"
   }

//String Comparison

IF customerName = "ABC Corporation"
   {
      ASSIGN contractLevel = "Gold"
   }
   ELSE
      {
         ASSIGN contractLevel = "Silver"
      }

//Numeric Comparision

IF contactID % 10 = 0
   {
      ASSIGN logCall = 1
   }
   ELSE
      {
         ASSIGN logCall = 0
      }

//DateTime Comparison

ASSIGN myTime = #"{time}"

IF myTime >= CBWindowStart && myTime  <= CBWindowEnd
   {
      ASSIGN offerCallback = "True"
   }
   ELSE
      {
         ASSIGN offerCallback = "False"
      }

Répéter

Description : Exécute les commandes désignées un nombre spécifié de fois.

Propriétés de l’arborescence

Dans l’onglet Arborescence, REPEAT apparaît sous la forme REPEAT 0.

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire sur la répétition.
  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.
  • Repeat : Saisissez une expression qui évalue une valeur numérique pour définir le nombre de fois que vous voulez que les comportements spécifiés se répètent.

Pour compléter REPEAT, cliquez avec le bouton droit de la souris sur REPEAT 0 et sélectionnez le comportement que vous voulez que le script répète. Vous pouvez ajouter plusieurs comportements. Configurez chaque comportement sélectionné.

Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.


REPEAT 10
{
	phone = "{phone}{random(10)}"
}	

Retourner

Description : Met fin à une fonction et transmet éventuellement une variable de la fonction au script. À utiliser avec les instructions FUNCTION.

Syntaxe : RETURN ou RETURN <var>

Action Studio : Return (page d’aide en CXone Studio : Return)

Détails : Doit être utilisé dans le code d’une déclaration de fonction. Ajoutez un nom de variable <var> après le mot-clé RETURN pour transmettre des informations au script.

Sélectionner

Description : Exécute un ensemble de commandes en fonction de la première expression évaluée comme vraie.

Propriétés de l’arborescence

Dans l’onglet Arborescence, SELECT apparaît sous la forme SELECT 0.

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire concernant SELECT.
  • Line Number : Le numéro de ligne sur laquelle se trouve la commande dans l’éditeur.

Pour compléter SELECT, cliquez avec le bouton droit de la souris sur SELECT 0 et ajoutez le mot-clé CASE pour chaque expression que vous voulez que le script évalue. Ajoutez une condition DEFAULT  pour définir ce que fait le script lorsqu’aucune des options CASE définies ne s’applique. Configurez chaque CASE et le mot-clé DEFAULT .

Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.

SELECT
{
	CASE name="Odin" { agentid = 123 }
	CASE name="Frigg" { agentid = 345 }
	CASE name.length = 0
	 {
	   ASSIGN agentid = -1
	   ASSIGN error = "Invalid name"
	 }
	DEFAULT { ASSIGN agentid = 999 }
} 

Basculer

Description : Évalue la variable spécifiée et entreprend l’action définie par la CASE correspondante.

Détails :  SWITCH compare la valeur d’une variable à la valeur littérale de chaque CASE. Lorsqu’un CASE correspondant est trouvé, SWITCH s’exécute et passe au code entre accolades { ... } associé au CASE correspondant.

SWITCH ne peut évaluer qu’une variable. Il ne peut pas évaluer une expression. Si vous utilisez une expression, votre script ne fonctionnera pas.

Au moins une CASE est attendue. Toutes les instructions CASE doivent avoir le même type de littéral. Le premier CASE détermine le type des autres instructions CASE. Si une instruction CASE a un type différent du premier CASE, une erreur de compilation se produit. Les types littéraux suivants sont tous valables :

  • CASE "john"
  • CASE 512
  • CASE #"5/15/2050"
  • CASE #"6/1/2050 7:00am"
  • CASE #"7am"

Par exemple :

IF TEST = 1
{
  ASSIGN MyDate = "07/03/2023" //This date falls on a Monday
}
ASSIGN MyDow = MyDate.asdatedow
SWITCH MyDow
{
  CASE 0   { ASSIGN NewToday = "Sunday"  }
  CASE 1   { ASSIGN NewToday = "Monday"  }
  CASE 2   { ASSIGN NewToday = "Tuesday" }
  CASE 3   { ASSIGN NewToday = "Wednesday" }
  CASE 4   { ASSIGN NewToday = "Thursday" }
  CASE 5   { ASSIGN NewToday = "Friday"  }
  CASE 6   { ASSIGN NewToday = "Saturday"   }
}

Cas d’utilisation : SWITCH permet d’obtenir des résultats spécifiques en fonction du contenu de la variable spécifiée. Par exemple, vous pouvez demander au script d’évaluer une variable contenant les indicatifs régionaux. Vous pouvez définir un CASE pour chaque indicatif régional possible et demander au script d’ajouter une valeur à la variable state qui correspond à l’état auquel l’indicatif régional est attribué. Par exemple :

SWITCH areaCode
{
	CASE 603 { state =  "New Hampshire" }
	CASE 614 { state =  "Ohio" }
	CASE 628 { state =  "California" }
	CASE 646 { state =  "New York" }
	CASE 667 { state =  "Maryland" }
}

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.

Propriétés de l’arborescence

Dans l’onglet Arborescence, SWITCH  apparaît sous la forme SWITCH 0.

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire concernant SWITCH.
  • Expression :

  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.

Pour compléter SWITCH, cliquez avec le bouton droit de la souris sur SWITCH 0 et ajoutez le mot-clé CASE pour chaque condition que vous voulez que le script évalue. Ajoutez une condition DEFAULT  pour définir ce que fait le script lorsqu’aucune des options CASE définies ne s’applique. Configurez chaque CASE et le mot-clé DEFAULT .

Trace

Description : Sort du texte dans le panneau des résultats de la fenêtre Snippet editor lorsque vous utilisez le débogueur dans l’onglet Vue texte.

Syntaxe : TRACE "<value>"

Détails : Ajoutez un mot clé TRACE avec toute "<value>" que vous souhaitez voir apparaître dans le panneau des résultats de la fenêtre Snippet editor lorsque vous utilisez le débogueur. La <value> peut être un nom de variable. TRACE est un outil utile pour résoudre les problèmes de code ou pour vous aider à voir ce qui se passe dans le script.

Ce mot-clé ne peut être utilisé que dans les actions Snippet. Vous pouvez laisser les mots-clés TRACE dans vos extraits de code. Au moment de l’exécution, ils sont ignorés en dehors de l’outil de débogage dans la fenêtre Snippet editor.

Propriétés de l’arborescence

Dans l’onglet Arborescence, les propriétés suivantes doivent être configurées pour TRACE  :

  • AllowEscapes : Lorsque la valeur est true, vous pouvez intégrer une séquence d’échappement commençant par une barre oblique inverse (\). La valeur par défaut est false.
  • Comment : Ajoutez un commentaire sur la trace.
  • Expression : Le texte que vous souhaitez afficher dans le volet des résultats. Vous pouvez inclure des variables en les plaçant entre accolades { }. Par exemple, {agentId}.
  • Line Number : Le numéro de ligne sur laquelle se trouve la commande dans l’éditeur.
Exemple

Pour voir cet exemple en arborescence, faites un copier-coller dans l’onglet Vue textuelle, puis cliquez sur l’onglet Arborescence.

TRACE "this is trace text"
//The text you specify with TRACE appears 
//In the results window when you use the 
//Debugger on the Text View tab. 

Description : Permet d’inclure une DLL mandataire de service Web SOAP à utiliser dans l’extrait de code. La DLL doit être compilée par WISDL par NICE CXone.

Syntaxe : USES "<proxy>.dll"

Action Studio : Uses (page d’aide dans CXone Studio : Uses)

Détails : Pour utiliser une instruction USES, la DLL mandataire doit se trouver dans le dossier racine du serveur de fichiers de votre locataireFermé Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre environnement CXone. Vous pouvez visualiser les fichiers dans votre locataire sur la page Parcourir les fichiers ACD dans CXone.

En savoir plus : Pour en savoir plus sur l’utilisation des mandataires de services Web avec les scripts Studio, consultez la page d’aide Appels d’API à partir des actions EXTRAIT DE CODE.

Propriétés de l’arborescence

Dans l’onglet Arborescence, « Utilisations » apparaît sous la forme USES "".

Les propriétés suivantes doivent être configurées :

  • Comment : Ajoutez un commentaire sur ce mot-clé.
  • FileName : Ajoutez le nom du fichier DLL mandataire que vous souhaitez utiliser dans l’extrait de code.
  • Line Number : Le numéro de la ligne sur laquelle se trouve la commande dans l’éditeur.

Chaque mot-clé a une propriété Comment. Cela vous permet d’ajouter un commentaire sur ce mot-clé. Utilisez l’option Comment pour ajouter un commentaire qui n’est pas lié à une propriété spécifique.