Instructions de déclaration

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

Les instructions de déclaration vous permettent d’introduire de nouvelles variables, de nouveaux objets ou de nouvelles fonctions dans votre script. Les mots-clés de ces instructions sont les suivants :

  • ASSIGN : Utilisez cette instruction lorsque vous devez créer une variable ou un tableau de chaînes.
  • DYNAMIC : Utilisez cette instruction lorsque vous devez créer un objet de données dynamique.
  • FUNCTION : Utilisez cette instruction pour créer une nouvelle fonction dans votre script.

L’analyse de chaque type d’instruction comprend un résumé de la syntaxe. Ces résumés utilisent certaines conventions pour indiquer les parties de l’instruction et préciser si chaque partie est requises ou facultative.

InstructionsASSIGN

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

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

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

Détails : Les instructions ASSIGN créent un <variable> et lui attribuent un <value>. Il n’est pas nécessaire de déclarer un type de données lorsque vous créez une variable, sauf s’il s’agit d’un type date/heure. Les variables en Studio sont implicitement typées, ce qui signifie que vous pouvez créer et assigner une valeur en une seule étape. Par exemple :

ASSIGN oneName = "Odin"

Si la valeur que vous assignez à une variable est numérique, vous n’avez pas besoin de la mettre entre guillemets. Si la valeur est une chaîne, elle doit être placée entre guillemets.

Vous pouvez utiliser les instructions ASSIGN pour créer un tableau de chaînes :

ASSIGN manyNames = "Odin|Freya|Thor"

Vous pouvez assigner une variable comme valeur d’une autre variable :


ASSIGN x =  1
ASSIGN y = x 
ASSIGN var1 = z

La variable située à droite du signe égal n’a pas besoin d’être entourée d’accolades et de guillemets doubles si elle est déjà déclarée. Le script évalue le terme à droite du signe égal. S’il n’est pas entre accolades et guillemets et s’il n’est pas numérique, le script considère qu’il s’agit d’une variable. Si elle existe déjà, le script attribue sa valeur à la deuxième variable. Si elle n’est pas déclarée, le script la crée avec une valeur nulle.

Vous pouvez attribuer une valeur à un membre d’objet dynamique en utilisant ASSIGN. Après avoir déclaré l’objet avec DYNAMIC, utilisez ASSIGN pour attribuer des valeurs aux membres de l’objet. Si le membre n’existe pas encore, il est créé lorsque vous lui attribuez une valeur. Utilisez la syntaxe suivante : ASSIGN <name>.<key> = <value>

Il n’est pas nécessaire d’utiliser le mot-clé ASSIGN lors de la déclaration d’une variable ou d’un . Cependant, il est utile de l’utiliser. L’inclusion de ASSIGN permet de localiser facilement dans votre script l’endroit où vous avez introduit la variable ou le tableau à l’aide de la recherche avancée. Sans ASSIGN, vous devez rechercher le nom de la variable ou du tableau. Les résultats de la recherche contiendront toutes les références à la variable ou au tableau dans votre script. Lorsque vous incluez ASSIGN dans votre terme de recherche, la recherche ne renvoie que les résultats où la variable est explicitement assignée. Pour déclarer une variable sans ASSIGN, utilisez la syntaxe suivante : <name> = "<value>"

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.

Instructions DYNAMIC

Description : Les instructions DYNAMIC créent une variable d’objet de données dynamiques avec le nom spécifié.

Syntaxe : DYNAMIC <name>

Détails : Un objet de données dynamiques est une variable qui peut contenir plusieurs valeurs. Ils sont similaires aux tableaux, mais présentent quelques différences essentielles.

Les valeurs que les objets de données dynamiques contiennent sont appelées « paramètres ». Ils sont définis comme des paires clé-valeur, où chaque paramètre a une clé (nom) et une valeur. Après avoir déclaré l’objet avec le mot-clé DYNAMIC, vous pouvez définir les membres de l’objet.

Par exemple :

DYNAMIC beowulfCharacteristics
beowulfCharacteristics.name = "Beowulf"
beowulfCharacteristics.occupation= "Hero" 
beowulfCharacteristics.foe = "Grendel" 

La casse est importante lors du référencement d’objets de données dynamiques et de leurs paramètres. BeowulfCharacteristics n’est pas la même chose que beowulfCharacteristics.

Si la valeur que vous assignez à un objet est numérique, vous n’avez pas besoin de la mettre entre guillemets. Si la valeur est une chaîne, elle doit être placée entre guillemets.

Utilisez DYNAMIC pour déclarer les objets qui sont transmis à votre script par d’autres scripts ou intégrations. Les objets doivent être déclarés dans chaque script, sinon cela provoque une erreur de validation du script lors de l’enregistrement.

Conventions d’attribution de nom : Lorsque vous attribuez un nom à des objets de données dynamiques, 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 les noms de variables prédéfinies ou de mots réservés.

En savoir plus : De plus amples informations sur les objets de données dynamiques sont disponibles sur les pages d’aide Objets et Structures des données.

DYNAMIC a une autre utilisation importante, qui est de créer des instructions pour les objets qui sont transmis dans le script depuis d’autres sources. Si vous ne déclarez pas ces objets, une erreur se produira lors de l’enregistrement du script. .

InstructionsFUNCTION 

Description : Crée une fonction personnalisée.

Syntaxe à déclarer : FUNCTION <name><([parameter], [...])> <{ ... [RETURN [data]]}>

Syntaxe à appeler : <functionName><([parameter], [parameter], [...])><{<varName>.<functionName><([parameter], [parameter], [...])>}>

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.

Entre les accolades { RETURN <data>} après l’en-tête de l’instruction, incluez le code que vous voulez que le script exécute lorsque la fonction est appelée. Terminez le code par le mot-clé RETURN suivi de la variable <data> qui doit contenir la sortie de la fonction. L’inclusion d’une variable après RETURN n’est nécessaire que si vous devez transmettre des données au script d’appel.

Les noms de fonctions doivent toujours comporter des parenthèses, même si la fonction n’a pas de paramètres. Par exemple :

FUNCTION noParams()

FUNCTION twoParams(name, accountNum)

Vous pouvez appeler une fonction dans votre script lorsque vous avez besoin d’utiliser le code qu’elle contient. La syntaxe utilisée pour appeler la fonction dépend du fait que la fonction renvoie ou non une valeur.

Si la définition de la fonction comporte <parameters>, le script doit transmettre les informations appropriées à la fonction. Vous devez inclure les paramètres dans l’appel de la fonction. Incluez tous les paramètres dans l’ordre dans lequel ils apparaissent dans la définition de la fonction. Par exemple, callVar.twoParams('Beowulf', 349839)

Si vous souhaitez que le résultat de la fonction soit affecté à une variable, vous pouvez appeler la fonction dans le cadre d’une instruction ASSIGN. Par exemple, ASSIGN var = otherVar.function(). Toutefois, il existe un cas où cela ne fonctionne pas, à savoir l’appel d’une fonction membre de la fonction GetRESTproxy().

Ajoutez un commentaire après le nom de la fonction dans la définition de la fonction pour fournir une aide en ligne pour la fonction. L’aide en ligne propose des suggestions dans des menus contextuels au fur et à mesure que vous tapez dans la fenêtre Snippet editor.

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.

Exemple

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)