Configuration du graphique de l'explorateur de données

Pour certaines zones de l'explorateur de données, il est plus efficace d'afficher les résultats sous forme graphique, comme un graphique à secteurs ou à lignes. Les paramètres d'option de visualisation permettent d'intégrer la configuration du graphique à la zone de l'explorateur de données qui extrait les données.

Les paramètres de l'option de visualisation prennent en charge trois options :

  • Grille : Affiche les données dans une grille d'explorateur de données standard
  • Graphique : Affiche les données sous la forme d'un graphique
  • Matrice : Permet d'appeler une matrice IU pour afficher les données

Vous pouvez spécifier jusqu'à cinq paramètres d'option de visualisation. L'une des options doit être la grille standard, autorisant un maximum de quatre options graphiques. La zone affiche des icônes correspondant aux types de visualisation pour vous permettre de basculer entre les différentes vues. Ces icônes sont présentées dans l'ordre défini dans la liste des paramètres.

Remarque :
Si la seule option d'affichage est une grille standard, il n'est pas nécessaire d'indiquer la grille en tant que paramètre de visualisation.

Les paramètres d'option de visualisation sont fournis dans les types de zone Explorateur de données d'information - SQL unique (F1-DE-SINGLE) et Explorateur de données d'information - SQL multiples (F1-DE).

Configuration des paramètres d'option de visualisation

Les mnémoniques permettent de définir les attributs d'un type d'option dans la valeur du paramètre.

Pour une grille, la mnémonique est 'optiontype=GRID'. Aucune autre mnémonique n'est requise.

Pour une matrice, les mnémoniques sont 'optiontype=MAP map=MAP_​CD schemaPath=xpath', où 'MAP_​CD' est l'ID de la matrice IU et 'xpath' est le chemin du schéma de la matrice IU. Dans la plupart des cas, les éléments de schéma correspondent au jeu de résultats de l'explorateur de données, auquel cas aucune mnémonique schemaPath n'est nécessaire. Si des éléments supplémentaires sont présents dans le schéma de la matrice IU, l'attribut schemaPath définit le noeud de groupe dans lequel les informations de l'explorateur de données seront copiées.

Pour un graphique, la mnémonique du type d'option est 'optiontype=CHART'. Elle est suivie des attributs de configuration de graphique appropriés, décrits dans la section ci-dessous.

Configuration du graphique

Les attributs suivants sont utilisés pour configurer une représentation graphique d'un jeu de données.

L'attribut 'oraChart:' définit le type du graphique à afficher et sa configuration générale. Le jeu de paramètres de configuration disponible pour cet attribut est le suivant :

Paramètre

Valeurs

Description

type:

pie

stacked

cluster

line

area

combo

Définit le type de graphique à afficher.

Obligatoire

showLegend:

true

false

Indique si une légende doit être affichée pour le graphique.

Facultatif (valeur par défaut : true)

legendPosition:

left

right

bottom

top

Indique où doit figurer la légende.

Facultatif (valeur par défaut : right)

Avec la valeur left ou right, l'affichage est automatiquement vertical.

Avec la valeur top ou bottom, l'affichage est automatiquement horizontal.

legendBorder:

true

false

Indique si une bordure doit entourer la légende.

Facultatif (valeur par défaut : false)

depth:

true

false

La valeur true indique que le graphique est à 3 dimensions.

Facultatif (valeur par défaut :false, qui indique que le graphique est à 2 dimensions)

animate:

true

false

La valeur true indique que le graphique doit s'animer lorsqu'il est affiché.

Facultatif (valeur par défaut : true). Avec des jeux de données volumineux, envisagez de désactiver l'animation.

dataCursor:

on

off

La valeur on active l'affichage d'un texte de pointage n'importe où dans le graphique.

Facultatif (valeur par défaut : off). Non applicable aux graphiques à secteurs.

orientation:

horizontal

Définit l'orientation du graphique. Applicable uniquement aux graphiques à barres, à courbes, en aires et combinés.

Par exemple, oraChart="type:cluster; orientation:horizontal" définit un graphique en grappes horizontal.

Facultatif (valeur par défaut : vertical).

L'attribut oraChartSeries définit les informations source pour le graphique. La plupart des graphiques prennent en charge 5 de ces attributs, avec les mnémoniques suivantes :

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

Les graphiques à barres empilées prennent en charge un nombre illimité de séries, par ajout d'attributs oraChartSeries6 et plus, mais prenez garde aux incidences sur les performances et aux limites de la mémoire si vous utilisez un nombre excessif de séries. Tous les attributs ont le même format et utilisent les mêmes paramètres, décrits ci-dessous.

Remarque :
oraChartSeries1 est obligatoire pour tous les graphiques. Les graphiques à barres empilées, en grappes et à courbes peuvent éventuellement faire appel aux attributs de séries supplémentaires (pour plusieurs barres/courbes).

Si vous définissez plusieurs séries, vous devez fournir des données pour chacune d'elles. La valeur des données peut être de 0 (zéro) mais elles doivent être présentes pour que le graphique s'affiche correctement.

Le jeu de paramètres de configuration disponible pour l'attribut oraChartSeriesN est le suivant :

Paramètre

Valeurs

Description

list:

Valeur XPath

Définit le XPath de la liste du XML qui contient les données à représenter graphiquement.

Requis uniquement pour les définitions HTML dans les matrices IU. Les valeurs de l'explorateur de données sont dérivées des colonnes de la zone.

amount:

Cn

Pn

Valeur XPath

Définit l'élément contenant le montant à représenter dans le graphique. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Obligatoire

xaxis:

Cn

Pn

Valeur XPath

Définit l'élément contenant les données de l'axe des X. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément est indiqué.

Obligatoire pour les graphiques à barres empilées, en grappes, à courbes, en aires et combinés.

xaxisFormat:

date

dateTime

time

localDate

string

Définit le format des données de l'axe des X.

Avec date, dateTime ou time, la valeur est présentée au format défini dans le profil d'affichage de l'utilisateur.

Avec localDate ou string, les donnés sont affichées telles quelles, sans formatage particulier.

Facultatif (valeur par défaut : date).

label:

Valeur texte

Définit l'étiquette de la valeur représentée graphiquement.

Ce paramètre ou labelPath: doit être défini.

labelPath:

Cn

Pn

Valeur XPath

Définit l'élément qui fournit l'étiquette de la valeur à représenter graphiquement. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Ce paramètre ou label: doit être défini.

currency:

Code de devise valide

Définit le code de devise de la valeur représentée graphiquement.

Facultatif.

currencyPath:

Cn

Pn

Valeur XPath

Définit l'élément qui fournit le code devise de la valeur à représenter graphiquement. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Facultatif.

hoverText:

Valeur texte

Définit le texte de pointage de l'élément de graphique.

Facultatif (un texte de pointage par défaut est toujours disponible). Ignoré si hoverTextPath: est défini.

Les variables de substitution ci-dessous sont disponibles.

  • $label Sera remplacée par le texte d'étiquette déterminé par le paramètre label: ou labelPath:.
  • $amount Sera remplacée par le texte de valeur spécifié par le paramètre amount:.
  • $axis Sera remplacée par le texte d'axe des X.
  • $% Sera remplacée par le pourcentage correspondant à la barre ou au secteur.
  • $newline Forcera un saut de ligne.

Si le texte de pointage contient l'une des variables ci-dessus, celle-ci sera remplacée par le texte équivalent avant l'affichage.

Exemple :

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

Valeur XPath

Définit l'élément qui fournit le texte de pointage de l'élément de graphique. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Le texte de pointage dans l'élément peut utiliser toutes les variables de substitution décrites ci-dessus pour hoverText:.

Facultatif.

type:

bar

line

area

Cet attribut est utilisé uniquement pour les graphiques de type combiné. Il indique comment chaque série du graphique combiné doit être présentée.

L'exemple ci-dessous définit un graphique combiné avec une série présentée sous forme de barres et une autre sous forme d'aires.

oraChart="type:combo;" 
oraChartSeries1="xaxis:C3; 
label:C2; amount:C1;type:bar" 
oraChartSeries2="xaxis:C3; 
label:C2; amount:C1;type:area"

navOpt:

Code d'option de navigation valide.

Définit l'option de navigation à activer lorsque l'utilisateur clique sur l'élément de graphique.

Facultatif.

navOptPath:

Cn

Pn

Valeur XPath

Définit l'élément qui fournit l'option de navigation à activer lorsque vous cliquez sur l'élément de graphique. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Facultatif

A noter que les deux paramètres navOpt: et navOptPath: peuvent être configurés. L'option de navigation navOptPath: est traitée en premier. Si une valeur est trouvée, elle est utilisée ; sinon, c'est la valeur du paramètre navOpt: qui est utilisée. De ce fait, la définition du graphique peut inclure une option de navigation par défaut et une option de navigation présente dans les données qui la remplacera.

key:

Cn

Pn

Valeur XPath

Définit l'élément qui contient les données de champ de clé à utiliser dans une option de navigation. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Obligatoire si navOpt: ou navOptPath: est défini.

Remarque :
Il n'est possible de configurer qu'un seul champ de clé pour une option de navigation.

script:

Nom de script APT

Définit le script APT à activer lorsque l'utilisateur clique sur l'élément de graphique.

Facultatif

Lorsqu'un script est exécuté, tous les éléments des données du graphique sont mis à sa disposition sous forme de variables temporaires.

scriptPath:

Cn

Pn

Valeur XPath

Définit l'élément qui fournit le script APT à activer lorsque vous cliquez sur l'élément de graphique. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Facultatif

A noter que les deux paramètres script: et scriptPath: peuvent être configurés. L'option de script scriptPath: est traitée en premier. Si une valeur est trouvée, elle est utilisée ; sinon, c'est la valeur du paramètre script: qui est utilisée. De ce fait, la définition de graphique peut inclure un script par défaut et un script présent dans les données qui le remplacera.

color:

Code couleur HTML/Valeur RGB

Facultatif (application de couleurs par défaut)

Définit la couleur de la série. Le format est un code couleur HTML valide, par exemple green, ou blue. Vous trouverez les noms de couleur valides à l'adresse suivante : http://www.w3schools.com/htmL/html_​colornames.asp.

Vous pouvez également utiliser un format RGB. (00FF00 = vert et 0000FF = bleu)

Remarque :
Pour plus d'informations sur l'utilisation de la couleur HTML "rouge" et son impact sur l'accessibilité, voir Contraste de couleurs.

colorPath:

Cn

Pn

Valeur XPath

Définit l'élément contenant une couleur pour la série. Pour les explorateurs de données, il s'agit d'un identificateur de colonne SQL ou de post-traitement. Pour les définitions HTML, le XPath de l'élément doit être indiqué.

Les formats valides sont les mêmes que pour color:.

Facultatif (application de couleurs par défaut)

pieColors:

Code couleur HTML/Valeur RGB

Définit la couleur des séries des graphiques à secteurs. Un nombre quelconque de codes couleur HTML ou de valeurs RGB peut être spécifié, séparés par des espaces. Exemples : 

pieColors: green blue
pieColors: 00FF00 0000FF

Facultatif (application de couleurs par défaut si le nombre de valeurs spécifiées est insuffisant pour la série)

L'attribut oraChartBroadcast: permet de transmettre une valeur de graphique vers l'environnement du portail. Le nombre de champs pouvant être transmis sous la forme de paires nom/valeur est illimité ; par exemple : oraChartBroadcast="FIELD_​NAME1:C1 ;FIELD_​NAME2:C2 ;" où FIELD_​NAMEn est le nom du champ contextuel du portail à transmettre et Cn (ou Pn) est l'élément contenant la valeur de données à transmettre. La transmission se déclenche lorsque vous cliquez sur une section correspondante du graphique.

Pour les définitions HTML dans les matrices IU, la syntaxe est oraChartBroadcast="FIELD_​NAME1:xpath1 ;FIELD_​NAME2:xpath2 ;" où 'xpathn' est l'élément du schéma de liste qui contient la valeur de donnée à transmettre.

Exemples de configuration de zone

Zone avec un graphique à secteurs simple

Dans cet exemple, le SQL de la zone récapitule les entrées de tâche par rôle. Les définitions de colonne sont les suivantes :

  • C1 : Description du rôle

  • C2 : Nombre d'entrées de tâche par rôle

  • C3 : ID rôle

Option de visualisation 1

Cette option affiche les entrées de tâche par rôle sous forme de graphique à secteurs. L'ID rôle sera transmis au portail lorsque vous cliquerez sur la section correspondante du graphique à secteurs.

optiontype=CHART
oraChart="type:pie;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="ROLE_ID:C3"

Zone avec deux types de graphique

Dans cet exemple, le SQL de la zone récapitule les entrées de tâche par priorité et calcule également leur nombre par statut de tâche et priorité. Les définitions de colonne sont les suivantes :

  • C1 : Description de la priorité

  • C2 : Nombre d'entrées de tâche par priorité

  • C3 : Valeur de l'indicateur de priorité

  • C4 : Nombre de tâches non traitée par priorité

  • C5 : Nombre de tâches non traitées par priorité

  • C6 : Etiquette de la barre des tâches non traitées dans le graphique en grappes

  • C7 : Etiquette de la barre des tâches affectées dans le graphique en grappes

Option de visualisation 1

Cette option affiche les entrées de tâche par priorité sous forme de graphique à secteurs. La valeur de priorité sera transmise au portail lorsque vous cliquerez sur la section correspondante du graphique à secteurs.

optiontype=CHART
oraChart="type:pie; legendBorder:true;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"

Option de visualisation 2

Cette option affiche les entrées de tâche par priorité sous la forme d'un graphique en grappes avec deux séries de données : une pour les tâches non traitées et une autre pour les tâches affectées. La valeur de priorité correspondante est transmise au portail lorsque vous cliquez sur la barre des tâches non traitées ou affectées du graphique en grappes.

optiontype=CHART oraChart="type:cluster;  showLegend:true;" 
oraChartSeries1="xaxis:C1; xaxisFormat:string; labelPath:C6; amount:C4;hoverText:$label$newline$amount;"
oraChartSeries2="xaxis:C1; xaxisFormat:string; labelPath:C7; amount:C5;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"