Formules

Chaque valeur d’un wallboard provient d’une formule. Une formule est une expression unique portant sur les données en direct du centre de contacts, par exemple

Conversations.Count(State = "Waiting")

— le nombre de conversations en attente. Les données disponibles sont décrites sous Données pour les formules ; des formules prêtes à l’emploi figurent sous Exemples. Les indicateurs de performance utilisent le même langage, avec des données un peu différentes, voir ci-dessous.

Ce qu’une formule doit fournir

Règles de base

• Une formule est une seule expression — sans instructions, variables ni commentaires.
• La casse ne joue aucun rôle pour les noms : conversations.count() équivaut à Conversations.Count(). En revanche, elle compte lors de la comparaison de textes : SkillName = "support" ne trouve pas la compétence « Support ».
• Les espaces et les sauts de ligne entre les éléments sont libres.
• Vous ajoutez les champs et les méthodes avec un point : Conversations.First().Agent.Name, Name.StartsWith("A").
• Les requêtes sur les listes ont besoin de parenthèses, même sans contenu : Agents.Count().
• Les guillemets sont les guillemets droits " — les guillemets typographiques comme « » ou “ ” provoquent une erreur de syntaxe.

Valeurs

Vous comparez les états et les types au moyen de leur nom anglais, voir États et types ; ici, la casse est indifférente, et un nom inconnu est une erreur.

Vous convertissez avec les noms de types .NET, par exemple Int32(x) ou Double(Agents.Count()), et avec Convert.ToInt32(…) ou Convert.ToString(…) ; le langage ne connaît pas les noms courts comme int ou double. Pour calculer, toutes les fonctions de Math sont disponibles — Math.Round(x), Math.Round(x, 1), Math.Max(a, b), Math.Abs(x) —, ainsi que les méthodes des valeurs elles-mêmes : Name.ToUpper(), Subject.Length, QueuedTimeSpan.TotalSeconds, StartTime.ToLocalTime().

Opérateurs

Classés par priorité, le plus prioritaire en premier :

Les parenthèses ( ) modifient l’ordre.

Si & concatène un état, une durée ou un instant avec du texte, la valeur apparaît non traduite : les états en anglais, les durées avec des fractions de seconde, les instants en UTC. Mettez donc en forme vous-même, par exemple "Attente la plus longue : " & Conversations.Max(QueuedTimeSpan).ToString("mm\:ss").

Requêtes sur les listes

Chaque liste — conversations, agents, compétences… — connaît ces requêtes :

• Entre les parenthèses s’appliquent les champs de chaque entrée : dans Agents.Count(IsLogin), IsLogin est le champ de chaque agent. Vous désignez l’entrée elle-même par it.
• Les requêtes peuvent être enchaînées : Conversations.Where(ConversationType = "InboundCall").Max(QueuedTimeSpan).
• Si la condition ne peut pas être évaluée pour une entrée — par exemple Skill.Name pour une conversation sans compétence —, l’entrée est considérée comme non correspondante.
• Vous vérifiez s’il existe au moins une entrée avec Conversations.Count(State = "Waiting") > 0.

Conditions

iif(condition, valeur1, valeur2) et condition ? valeur1 : valeur2 fournissent valeur1 si la condition est vraie, sinon valeur2. Les deux valeurs doivent être du même type :

iif(Wrapup, WrapupTimeSpan, TimeSpan.Zero)
Agents.Count(IsLogin) = 0 ? "personne" : "occupé"

Row et it

Dans les colonnes de tableau, les formules de ligne et les séries de diagramme, la ligne en cours est disponible sous Row. Vous pouvez aussi nommer ses champs sans Row : dans un tableau d’agents, Name et Row.Name sont identiques.

À l’intérieur d’une requête sur une liste, it désigne l’entrée de la liste ; la ligne reste accessible via Row. Dans un tableau de compétences, chaque ligne compte ainsi ses propres conversations en attente :

Conversations.Count(Skill.Id = Row.Id and State = "Waiting")

Si un champ de la ligne porte le même nom qu’une liste — les agents ont par exemple les champs Skills et Languages —, le nom seul désigne la liste. Vous atteignez le champ avec Row.Skills ou, dans une requête, avec it.Skills.

Heure et fuseaux horaires

• Now et tous les instants fournis par le serveur — StartTime, LoginTime, RaiseTime — sont en UTC.
• Les durées comme Now - StartTime ou QueuedTimeSpan n’en dépendent pas.
• Une étiquette dont la formule fournit un instant l’affiche dans l’heure locale de l’ordinateur. Dans les tableaux et dans les textes que vous composez vous-même, convertissez : StartTime.ToLocalTime(), Now.ToLocalTime().ToString("HH:mm").

Messages d’erreur

Pendant la saisie, le concepteur vérifie chaque formule ; si elle contient une erreur, le champ change de couleur et le message s’affiche en dessous, souvent avec la position « (à l’indice n) ». Les plus fréquents :

Une étiquette dont la formule est erronée affiche la formule elle-même sur le wallboard.

Si une erreur ne survient qu’au moment du calcul — par exemple First().Name sur une liste vide —, l’élément affiche une valeur vide : 0, un texte vide, 00:00:00 ou « Non ».

Différences avec les indicateurs de performance