myContactCenterManuel

Données et expressions

D'où un modèle de rapport tire ses données, comment placer des champs de la liste des champs sur la page, calculer avec des expressions et des champs calculés, créer des paramètres personnalisés et ce que myContactCenter prépare lui-même lors du calcul.

Les données d’un modèle

Chaque type de base et chaque gabarit lit exactement une requête sur les statistiques — conversations, phases des conversations, actions des agents ou alarmes, voir Modèles de rapport. Lors du calcul, myContactCenter ajoute les paramètres choisis comme filtres à cette requête et convertit les heures de l’UTC dans le fuseau horaire du rapport — voir Fuseaux horaires.

Construisez donc votre analyse sur la requête du type de base. Add Data Source permettrait certes de créer d’autres sources de données, mais ni les paramètres ni la conversion des heures ne s’y appliquent.

La liste des champs

La Field List (liste des champs) affiche la source de données, en dessous la requête avec ses champs, les champs calculés et le nœud Parameters. Les champs portent les noms techniques de la base de données, par exemple SkillName ou TotalWaitDuration ; leur signification est décrite sous Les champs des statistiques. Au-dessus de l’arborescence, un champ de recherche permet de chercher par nom.

  • Les drapeaux comme IsConnected ou IsAbandoned valent 0 ou 1. Leur somme est donc un nombre : sumSum([IsConnected]) compte les conversations connectées.
  • Les durées comme TotalWaitDuration sont en secondes.

Faire glisser des champs sur la surface

Vous faites glisser Résultat
un champ sur un emplacement libre un élément Label qui affiche la valeur du champ
un champ sur un élément existant l’élément affiche désormais ce champ ; avec Ctrl, un élément supplémentaire est créé à la place
plusieurs champs, sélectionnés avec Ctrl un tableau avec une cellule par champ
plusieurs champs avec le bouton droit de la souris un tableau avec les noms des champs — les titres
un champ avec le bouton droit de la souris ou avec Maj un menu dans lequel vous choisissez le type d’élément
un paramètre du nœud Parameters un élément Label avec la valeur du paramètre

L’usage : les titres dans le PageHeader (en-tête de page), les valeurs dans Detail ou dans un en-tête de groupe.

Expressions

Ce qu’affiche un élément est déterminé par son Expression. Dans le cas simple, c’est le nom d’un champ entre crochets, par exemple [SkillName] ; mais elle peut aussi calculer, comparer et assembler des textes. D’autres propriétés peuvent également être pilotées par une expression, par exemple la couleur et la visibilité — voir Couleurs conditionnelles.

Vous ouvrez l’éditeur d’expressions via le « f » de l’élément sélectionné, via le « f » à côté d’une propriété sous Properties ou dans le menu des tâches sous Expression. Il propose des champs, des paramètres, des fonctions et des opérateurs à cliquer et fait des suggestions pendant la saisie. Si quelque chose ne va pas, il affiche The expression contains errors.

Composant Syntaxe Exemple
Champ [Nom] [TotalWaitDuration]
Paramètre ?Nom ?Culture
Texte entre apostrophes 'Compétence : ' + [SkillName]
Condition Iif(condition, alors, sinon) Iif([IsConnected] = 1, 'connectée', 'non connectée')
Valeur vide IsNullOrEmpty(…) Iif(IsNullOrEmpty([SenderName]), [Sender], [SenderName])
Date et heure GetHour, GetDayOfWeek, AddDays, … GetHour([ConversationStartTime])
Nombres Round, Floor, … Round([TotalConnectDuration] / 60, 1) — temps de conversation en minutes
Total sur un groupe sumSum, sumCount, sumAvg, … sumSum([IsConnected]) — voir Agrégations

Champs calculés

Un champ calculé est un champ que vous calculez vous-même : il possède une expression et s’utilise ensuite comme tout autre champ — pour afficher, regrouper, trier, filtrer.

  1. Cliquez sur Home › Data › Add Calculated Field ou, dans la Field List, cliquez avec le bouton droit sur Add Calculated Field.
  2. Sélectionnez le nouveau champ dans la Field List et saisissez sous Properties un Name et l’Expression, par exemple GetDayOfWeek([ConversationStartTime]) pour le jour de la semaine.

Dans la Field List, un champ calculé apparaît précédé de « Report », par exemple « ReportJourSemaine ». Choisissez donc son nom de sorte qu’il ait un sens lu de cette façon.

Paramètres personnalisés

Les types de base apportent les paramètres que myContactCenter connaît — période, compétences, langues, agents, base de temps et les autres décrits sous Paramètres. myContactCenter les reconnaît à leur nom. Ne les renommez donc pas et ne les supprimez pas ; sinon, ils perdent leur effet.

Vous créez des paramètres personnalisés avec Home › Data › Add Parameter. Dans la fenêtre Add New Parameter, vous indiquez le nom et le type, une valeur par défaut et, si nécessaire, une liste des valeurs autorisées. Règles à respecter :

  • Comme libellé dans le volet Parameters, myContactCenter affiche le nom du paramètre ; il remplace une description personnalisée lors du chargement. Choisissez donc un nom qui convienne comme libellé — composé uniquement de lettres, de chiffres et de traits de soulignement.
  • Un paramètre personnalisé ne filtre pas dans la requête. Si vous l’utilisez dans le filtre du rapport, il agit sur les lignes déjà chargées pour la période — voir Filtrer.

La période dans le rapport

Les gabarits affichent en haut « Le rapport contient des données de … à … ». Derrière se cache un champ calculé nommé _HeaderExpressionName, que myContactCenter remplit avec la période avant chaque calcul — dans l’heure locale et la langue du rapport. En-tête avec la période montre comment le reprendre dans votre propre modèle.

Ce que myContactCenter prépare lors du calcul

Lors du calcul, myContactCenter prépare lui-même certaines valeurs pour les rendre lisibles :

Quoi Comment cela apparaît
expressions avec un champ dont le nom contient « Duration » sous forme de durée, p. ex. 00:03:25, au lieu d’un nombre de secondes — y compris les totaux de ces champs
champs dont le nom contient « StartTime », « EndTime » ou « Time » sous forme de date ou de date avec heure
type de conversation, état, canal, déclencheur, mode d’attribution, motif de déconnexion traduits dans la langue du paramètre Culture
graphiques avec un axe temporel l’unité et l’intervalle de l’axe suivent Groupe horaire de base et Nombre de groupes horaires
graphiques dans un en-tête ou un pied de groupe n’affichent que les données de leur groupe

Cela vaut pour les éléments Label, les cellules de tableau et les graphiques placés directement dans une bande, et seulement tant que l’élément n’a pas sa propre chaîne de format. Ne sont pas préparés les éléments dans un Panel, dans les tableaux croisés, les sparklines, les jauges et les sous-rapports : les durées y restent en secondes et les types de conversation en anglais.

    ↑ ↓ sélectionner · Entrée ouvrir · Échap fermer