Utilisation de graphiques dans les communications interactives

En utilisant des graphiques dans une communication interactive, vous pouvez condenser de grandes quantités d’informations dans un format visuel facile à analyser et à comprendre

Un diagramme ou un graphique est une représentation visuelle des données. Elle concentre une grande quantité d’informations dans un format visuel simple à interpréter et permet aux destinataires de la communication interactive de mieux visualiser, interpréter et analyser les données complexes.

Lors de la création d’une communication interactive, vous pouvez ajouter des graphiques pour représenter visuellement des données bidimensionnelles à partir du modèle de données de formulaire de la communication interactive. Le composant de graphique vous permet d’ajouter et de configurer les types de graphiques suivants :

• Diagramme circulaire
• Colonnes
• Anneau
• Barre (Canal web uniquement)
• Ligne
• Ligne et point
• Point
• Domaine

Ajouter et configurer le graphique dans une communication interactive

Pour ajouter un graphique à une communication interactive, procédez comme suit :

1. À partir des composants de la barre latérale AEM, glissez-déposez le composant graphique dans l’un des canaux d’impression ou web d’une communication interactive :

   • Canal d'impression : Zone de cible et champ d’image
   • Canal web : panneau et zone Cible

   Le composant Graphique déposé crée un espace réservé pour un graphique.

2. Appuyez sur le composant de graphique dans l’éditeur de communication interactive et dans la barre d’outils Composant, sélectionnez Configurer ( ).

   La barre latérale Propriétés s’affiche avec les propriétés de base du graphique actives.

   
   Figure : propriétés de base d'un graphique de type graphique en courbes dans le canal d'impression

   
   Figure:propriétés de base d’un graphique de type graphique en courbes dans un canal Web

3. Configurez les propriétés de base du graphique pour le canal d’impression et le canal web. Outre les propriétés communes, il existe des propriétés spécifiques au canal d’impression, au canal web et au type de graphique.

   • Nom : Nom de l'objet de graphique. Le nom du graphique que vous spécifiez ici n’apparaît pas dans la sortie graphique mais est utilisé dans les règles pour faire référence au graphique.

   • Type de graphique : spécifiez le type de graphique : Circulaire, Colonne, Anneau, Ligne, Ligne et Point, Point, Aire.

   • Masquer l’objet : sélectionnez cette option pour masquer le graphique dans la sortie finale.

   • Indiquez les éléments suivant pour l’axe X et l’axe Y :

     • Titre : spécifiez les titres des axes X et Y à afficher dans la communication interactive.
     • Objet de modèle de données* : recherchez et sélectionnez les objets de modèle de données des axes X et Y du graphique à partir du modèle de données de formulaire spécifié lors de la création de la communication interactive. Choisissez deux propriétés de type collection/tableau du même objet de modèle de données parent significatives l’une par rapport à l’autre pour tracer les axes X et Y d’un graphique.
     • Fonction : Pour utiliser des fonctions statistiques pour calculer les valeurs sur l'axe, sélectionnez la fonction pour l'axe X / Y. Pour plus d’informations sur les fonctions, voir Utiliser les fonctions dans le graphique et Exemple 2 : Application des fonctions de somme et de moyenne dans un graphique linéaire .
   REMARQUE

   Pour le canal d’impression, sur l’axe X, l’objet de modèle de données que vous reliez doit être de type Nombre, Chaîne ou Date. Sur l’axe Y, l’objet de modèle de données que vous liez doit être de type Nombre. Il est recommandé d’utiliser la légende de droite dans le canal d’impression.

   Pour plus d’informations sur les propriétés de graphique, consultez la section Propriétés de base dans les graphiques.

4. (Canal d’impression uniquement) Dans les Paramètres de l’agent, indiquez si l’utilisation de ce graphique est obligatoire pour l’agent. Si l'option t est obligatoire pour que l'agent utilise ce graphique n'est pas sélectionnée, l'agent peut appuyer sur l'icône en forme d'oeil du graphique dans l'onglet Contenu de l'interface utilisateur de l'agent pour afficher/masquer le graphique.

   

5. Dans la barre latérale Propriétés, appuyez sur .

   Aperçu permettant de visualiser l’apparence et les données du graphique. Revenez à l’étape précédente pour reconfigurer les propriétés du graphique, si nécessaire.

6. Revenez à l’étape précédente pour apporter d’autres modifications à la communication interactive.

Exemple 1 : sortie du graphique sur papier et sur le web

Dans l’onglet Réglages de base, vous définissez le type de graphique, les propriétés de modèle de données de formulaire contenant des données, les libellés à mapper sur l’axe X et l’axe Y du graphique, et éventuellement la fonction statistique pour calculer les valeurs à mapper sur le graphique.

Examinons en détail les informations minimales requises de ces propriétés de base à l’aide d’un relevé de carte de crédit généré via une communication interactive. Imaginons que vous souhaitez générer un graphique pour décrire le montant total des différentes dépenses dans le relevé. Vous souhaitez utiliser différents types de graphiques pour l’impression et la sortie web de la communication interactive.

Pour ce faire, vous devez spécifier :

• Type de graphique - dans cet exemple, Colonne pour le canal d’impression et Anneau pour le canal web

• Objets de modèle de données comme source des axes X et Y du graphique - dans cet exemple, montant de la transaction pour l’axe X et nom des dépenses pour l’axe Y

• Titre pour les axes X et Y (pour le graphique de type Colonne dans le canal d’impression uniquement dans cet exemple) - dans cet exemple, Montant ($) pour l’axe X et Dépenses pour l’axe Y.

• Direction des étiquettes (pour le graphique de type Colonne dans le canal d'impression uniquement dans cet exemple) - dans cet exemple Tilt Left

• ​​Info-bulle à afficher sur une dépense (canal Web uniquement) - dans cet exemple ${x}: $ ${y}, qui s'affiche comme [Expense Label: $ Amount] (Exemple : Theme Park Visit : 315 $)

communication interactiveFigure:graphique à colonnes dans la sortie d'impression d'une communication interactive

Axe A. Y - Montant extrait de la propriété de modèle de données de formulaire et de la propriété Titre définie sur Montant ($) B. Label Direction de l'axe X définie sur Incliner à gauche Axe C. X - Description des dépenses extraite de la propriété de modèle de données de formulaire et de la propriété Titre définie sur Frais

communication interactiveFigure : graphique en anneau dans la sortie Web d'une communication interactive

La propriété A. Inner Radius du beignet est définie B. La propriété Show Legend est sélectionnée et la propriété Legend Position est définie sur Right C. Tooltip affiche le détail de l'élément sur le curseur - Tooltip est défini sur ${x} : $ $ $

Exemple 2 : application des fonctions Somme et Fréquence dans un graphique en ligne

L’application de fonctions dans un graphique vous permet de tracer des données qui ne sont pas directement fournies par le modèle de données de formulaire. Ici, nous utilisons un exemple de relevé de carte de crédit pour comprendre comment les fonctions Somme et Fréquence peuvent être appliquées au graphique.

transactions "Bed and Breakfast"Figure : graphique linéaire sans fonction avec trois transactions "Bed and Breakfast"

Fonction Somme

Vous pouvez appliquer la fonction Somme pour additionner des valeurs de plusieurs instances de la même propriété Data et ne l’afficher qu’une seule fois. Par exemple, dans le graphique suivant, la fonction Somme s’applique à l’axe Y et additionne le montant des trois transactions Bed and Breakfast (99,45 $, 78 $ et 12 $) pour afficher une seule transaction (189,45 $).

La fonction Somme peut rendre le graphique plus utile si vous souhaitez assembler et afficher la somme de plusieurs instances de la même propriété Data.

Fonction Fréquence

La fonction Fréquence renvoie le nombre de valeurs sur l’axe X ou Y pour une même valeur sur l’autre axe. Grâce à l’utilisation de la fonction Fréquence sur l’axe Y (Montant/MontantTrans), le graphique affiche trois occurrences de transactions Bed and Breakfast et une occurrence du reste des types de transactions.

Propriétés de base dans les graphiques

Dans l’onglet Réglages de base, vous pouvez configurer les propriétés suivantes :

​​NomIdentifiant de l'élément de graphique. Le nom n’est pas visible sur le graphique, mais il est utile lors de la référence à l’élément à partir d’autres composants, scripts et expressions SOM.

Titre (canal d’impression uniquement) Indique le titre du graphique.

Type de graphique Spécifie le type de graphique à générer. Les options disponibles sont Circulaire, Colonne, Anneau, Barre (canal web uniquement), Colonne, Ligne, Ligne et point, Point et Aire. Pour plus d’informations, voir Exemple 1 : Sortie de graphique en format papier et Web.

Axe X > Titre Indique le titre de l’axe X.

Axe X > Objet de modèle de données * Indiquez le nom de l’élément de collecte de modèle de données de formulaire à mapper sur l’axe X.

Axe X > Fonction Spécifie la fonction statistique/personnalisée à utiliser pour calculer les valeurs sur l’axe X. Pour plus d’informations sur les fonctions, voir Utilisation des fonctions dans le graphique et Exemple 2 : Application des fonctions de somme et de moyenne dans un graphique linéaire.

Axe X > Direction du libelléDirection du libellé sur le graphique dans le canal d'impression. Si vous choisissez Rotation personnalisée comme orientation du libellé, le champ Angle de rotation personnalisé (degrés) apparaît. Dans le champ Angle de rotation personnalisée (degrés), vous pouvez choisir l’angle de rotation par étapes de 15 degrés.

Axe Y > Titre Indique le titre de l’axe Y.

Axe Y > Objet de modèle de données &ast ; Indique l’élément de collecte de modèle de données de formulaire à tracer sur l’axe y. Dans le canal d’impression, l’objet de modèle de données pour l’axe Y doit être de type Nombre.

Axe Y > Fonction Indique la fonction statistique/personnalisée à utiliser pour calculer les valeurs sur l’axe y. Pour plus d’informations sur les fonctions, voir Utilisation des fonctions dans le graphique et Exemple 2 : Application des fonctions de somme et de moyenne dans un graphique linéaire.

Afficher la légendeAffiche une légende pour le graphique circulaire ou en anneau lorsqu'il est activé.

Légende positionIndique la position de la légende par rapport au graphique. Les options disponibles sont Droite, Gauche, Haut et Bas.

Hauteur (canal d’impression uniquement) Hauteur du graphique en pixels.

Largeur (canal d’impression uniquement) Largeur du graphique en pixels.

Info-bulle (canal Web uniquement) Indique le format dans lequel l’info-bulle apparaît lorsque vous placez le pointeur de la souris sur un point de données du graphique dans le canal Web. La valeur par défaut est ${x}(${y}). En fonction du type de graphique, lorsque vous pointez la souris sur un point, une barre ou une tranche du graphique, les variables ${x} et ${y} sont remplacées dynamiquement par les valeurs correspondantes sur l'axe x et l'axe y et affichées dans l'info-bulle.

Pour désactiver l’info-bulle, laissez son champ vide . Cette option ne s’applique pas aux graphiques en ligne ni en points. Par exemple, voir Exemple 1 : Sortie de graphique sous forme imprimée et Web.

Classe CSS (canal Web uniquement) Spécifiez le nom d’une classe CSS dans le champ de classe CSS pour appliquer un style personnalisé au graphique.

Saut de page obligatoire avant (canal d’impression uniquement) Sélectionnez cette option pour ajouter un saut de page obligatoire avant le graphique et placez le graphique en haut d’une nouvelle page.

Saut de page obligatoire après (canal d’impression uniquement) Sélectionnez cette option pour ajouter un saut de page obligatoire après le graphique et placer le contenu suivant le graphique en haut d’une nouvelle page.

Retrait (canal d’impression uniquement) Indiquez le retrait du graphique à gauche de la page.

​​Configurations spécifiques au graphiqueOutre les configurations courantes, les configurations spécifiques au graphique suivantes sont disponibles :

• Rayon interne : disponible pour les graphiques en anneau pour indiquer le rayon (en pixels) du cercle intérieur dans le graphique.

• Couleur de la ligne : disponible pour les graphiques en courbes, en points, en lignes et en points, ou en aires pour spécifier la valeur hexadécimale de la couleur de la ligne dans le graphique.

• Couleur du point : disponible pour les graphiques en points, en lignes et en points afin de spécifier la valeur hexadécimale de la couleur pour les points du graphique.

• Couleur de la zone : disponible pour les graphiques à aires pour spécifier la valeur hexadécimale de la couleur pour la zone sous la ligne du graphique.

Utilisation des fonctions dans le graphique

Vous pouvez configurer un graphique de sorte qu’il utilise des fonctions statistiques pour calculer des valeurs à partir des données source pour un mappage sur le graphique. L’application de fonctions dans un graphique vous permet de tracer des données qui ne sont pas directement fournies par le modèle de données de formulaire.

Outre les fonctions intégrées du composant de graphique, vous pouvez rédiger vos propres fonctions et les rendre disponibles pour qu’elles soient utilisées dans la configuration du graphique dans le canal web.

Fonctions par défaut

Les fonctions suivantes sont disponibles par défaut avec le composant de graphique :

Moyenne (moyenne) Renvoie la moyenne des valeurs sur l’axe X ou Y pour une valeur donnée sur l’autre axe.

​​Somme Renvoie la somme de toutes les valeurs sur l'axe X ou Y pour une valeur donnée sur l'autre axe.

​​MaximumRenvoie le maximum des valeurs sur l'axe X ou Y pour une valeur donnée sur l'autre axe.

​​FréquenceRenvoie le nombre de valeurs sur l'axe X ou Y pour une valeur donnée sur l'autre axe.

​​RangeRenvoie la différence entre le maximum et le minimum des valeurs sur l'axe X ou Y pour une valeur donnée sur l'autre axe.

​​Médiane Renvoie la valeur qui sépare les valeurs supérieures et inférieures en deux sur l'axe X ou Y pour une valeur donnée sur l'autre axe.

​​MinimumRenvoie le minimum des valeurs sur l'axe X ou Y pour une valeur donnée sur l'autre axe.

​​Mode Renvoie la valeur avec le plus d'occurrences sur l'axe X ou Y pour une valeur donnée sur l'autre axe

Fonctions personnalisées dans le canal Web

En plus d’utiliser les fonctions par défaut dans les graphiques, vous pouvez rédiger des fonctions personnalisées dans JavaScript™ et les rendre disponibles dans la liste des fonctions du composant de graphique du canal web.

Une fonction prend un tableau ou des valeurs et un nom de catégorie comme entrées et renvoie une valeur. Par exemple :

Multiply(valueArray, category) {
 var val = 1;
 _.each(valueArray, function(value) {
 val = val * value;
 });
 return val;
}

Une fois que vous avez rédigé une fonction personnalisée, procédez comme suit pour la rendre disponible pour une utilisation dans la configuration du graphique :

1. Ajoutez la fonction personnalisée à la bibliothèque client associée à la communication interactive concernée. Pour plus d’informations, voir Configuration de l’action Envoyer et Utilisation de bibliothèques côté client.

2. Pour afficher la fonction personnalisée dans la liste déroulante Fonction, dans CRXDe Lite, créez un noeud nt:unstructured dans le dossier des applications avec les propriétés suivantes :

   • Propriété d’Ajoute guideComponentType avec la valeur fd/af/reducer. (mandatory)
   • Ajoutez la propriété value à un nom complet de la fonction JavaScript™ personnalisée. (obligatoire) et définissez sa valeur sur le nom de la fonction personnalisée, telle que Multiplier.
   • Ajoutez la propriété jcr:description avec la valeur que vous souhaitez afficher comme nom de la fonction personnalisée qui apparaît dans la liste déroulante Fonction. Par exemple, Multiplier.
   • Propriété d’Ajoute qtip avec une valeur qui sera une brève description de la fonction personnalisée. Elle s’affiche sous forme d’info-bulle lorsque le curseur est placé sur le nom de la fonction dans la liste déroulante.

3. Cliquez sur Enregistrer tout pour enregistrer la configuration.

Cette fonctionnalité est désormais disponible dans le graphique.