Partager via

Comprendre les graphiques : représentation des données et des graphiques sous-jacents

  • Article

Les graphiques affichent les données visuellement en mappant les valeurs textuelles sur deux axes : horizontal (x) et vertical (y). Dans Dynamics 365 for Customer Engagement, l’axe X est appelé l’axe de catégories et l’axe Y est appelé l’axe de séries. L’axe de catégorie peut afficher des valeurs numériques et non numériques alors que l’axe de série affiche uniquement des valeurs numériques.

Les graphiques de Dynamics 365 for Customer Engagement peuvent être classés dans les catégories suivantes :

  • Graphiques à série unique : graphiques qui affichent les données avec une valeur de série (y) mappée sur une valeur de catégorie (x).

  • Graphiques à plusieurs séries : graphiques qui affichent les données avec plusieurs valeurs de série mappées sur une valeur de catégorie unique. Les graphiques à plusieurs séries incluent les histogrammes empilés, qui affichent verticalement la contribution de chaque série par rapport au total parmi des catégories, et les histogrammes empilés 100 %, qui comparent le pourcentage auquel contribue chaque série par rapport au total parmi des catégories. Vous pouvez combiner différents types de graphiques compatibles dans les graphiques à plusieurs séries, par exemple, un histogramme et un graphique en courbes, un graphique à barres et un graphique en courbes, etc.

Note

Des graphiques à plusieurs catégories peuvent être créés via l’application web ou en modifiant les chaînes XML décrites ici.

Lors de la création d’un graphique dans Dynamics 365 for Customer Engagement à l’aide du Kit de développement logiciel (SDK), vous devez prendre en compte les deux aspects importants suivants :

  • Données sous-jacentes du graphique : spécifiées à l’aide de la chaîne XML de description des données.

  • Représentation des données (apparence) : spécifiée à l’aide de la chaîne XML de description de la présentation.

Note

Microsoft Chart Controls vous permet de créer différents types de graphiques tels que des histogrammes, des graphiques à barres, des graphiques en aires, des graphiques en courbes, des graphiques à secteurs, des graphiques en entonnoir, des graphiques en bulles et des graphiques en radar. Le concepteur de graphiques dans Dynamics 365 for Customer Engagement vous permet de créer uniquement certains types de graphiques. Toutefois, le Kit de développement logiciel (SDK) vous permet de créer la plupart des types de graphiques pris en charge par Microsoft Chart Controls.

Utiliser la chaîne XML de description des données pour spécifier les données graphiques

La chaîne XML de description des données définit les données qui s’affichent sur le graphique. Le contenu de la chaîne XML est validé par rapport au schéma de description des données de visualisation. Pour plus d’informations sur le schéma, voir Schéma de description des données de visualisation.

Vous pouvez spécifier la chaîne XML de description des données lorsque vous créez un graphique à l’aide de l’attribut SavedQueryVisualization.DataDescription ou UserQueryVisualization.DataDescription pour le graphique appartenant à l’organisation ou à l’utilisateur, respectivement.

La chaîne XML de description des données contient les deux éléments suivants : <FetchCollection> et <CategoryCollection>.

L’élément <FetchCollection>

L’élément <FetchCollection> utilise FetchXML pour récupérer les données du graphique. La requête FetchXML spécifie les informations sur les attributs d’entité, les fonctions d’agrégation et les clauses Regrouper par pour les données à afficher dans un graphique. Toutes les fonctions d’agrégation FetchXML sont prises en charge pour les graphiques. Pour plus d’informations sur les fonctions d’agrégation FetchXML, voir Utilisation de l’agrégation FetchXML.

La requête FetchXML vous permet de filtrer vos données. En outre, les filtres sont appliqués aux graphiques via des vues. Par conséquent, si une condition de filtre est déjà spécifiée dans la requête FetchXML de l’élément <FetchCollection> et qu’un filtre est appliqué via une vue, le graphique affiche les données retournées après avoir appliqué tous les filtres. Pour plus d’informations sur l’utilisation d’une requête FetchXML pour filtrer les données, voir Génération de requêtes avec FetchXML.

Note

La chaîne XML de description des données est validée par rapport au schéma de description des données de visualisation, contrairement à la requête FetchXML dans l’élément <FetchCollection>. La requête FetchXML est validée par rapport au schéma FetchXML. Pour plus d’informations, voir Schéma FetchXML.

Si le graphique est un graphique de comparaison, l’élément <FetchCollection> contient deux clauses Regrouper par .

L’élément <CategoryCollection>

L’élément <CategoryCollection> contient des informations sur l’axe de catégorie (horizontal) et l’axe de série (vertical) d’un graphique.

  • Chaque sous-élément <Category> est un élément enfant appelé <MeasureCollection> qui est mappé à l’élément <Series> dans la chaîne XML de description de la présentation. Un graphique à série unique contient un élément enfant <MeasureCollection> unique alors qu’un graphique à plusieurs séries contient plusieurs éléments enfants <MeasureCollection>, chacun étant mappé à l’élément <Series> correspondant dans la chaîne XML de description de la présentation.

  • Chaque élément enfant <MeasureCollection> contient un élément appelé <Measure> qui correspond à la valeur de l’axe de série (vertical), correspondant à chaque valeur sur l’axe de catégorie (horizontal).

Exemple

Voici un exemple de chaîne XML de description des données :

<datadefinition>  
  <fetchcollection>  
    <fetch mapping="logical" count="10">  
      <entity name="opportunity">  
        <attribute name="estimatedvalue" />  
        <order attribute="estimatedvalue" descending="true" />  
      </entity>  
    </fetch>  
  </fetchcollection>  
  <categorycollection>  
    <category>  
      <measurecollection>  
        <measure alias="estimatedvalue" />  
      </measurecollection>  
    </category>  
  </categorycollection></datadefinition>

Pour plus d’exemples de chaînes XML de description de données, voir Exemples de graphiques.

Utiliser la chaîne XML de description de la présentation pour spécifier la représentation des données

La chaîne XML de description de la présentation contient des informations sur l’apparence du graphique comme son titre, sa couleur et son type (graphique à barres, histogramme, graphique en courbes, etc.). Il n’existe aucune définition de schéma pour cette chaîne XML. Toutefois, la chaîne XML est une sérialisation de la classe Chart dans Microsoft Chart Controls. Pour plus d’informations, voir : Chart Controls

Vous pouvez spécifier la chaîne XML de description de la présentation lorsque vous créez un graphique à l’aide de l’attribut SavedQueryVisualization.PresentationDescription ou UserQueryVisualization.PresentationDescription pour le graphique appartenant à l’organisation ou à l’utilisateur, respectivement.

Exemple

Voici un exemple de chaîne XML de description de la présentation :

<Chart Palette="BrightPastel">  
  <Series>  
    <Series _Template_="All" Color="153, 204, 255" BorderColor="164, 164, 164" BorderDashStyle="Solid" BorderWidth="1" ShadowColor="128, 128, 128, 128" ShadowOffset="1" IsValueShownAsLabel="true" Font="{0}, 6.75pt" BackGradientStyle="TopBottom" BackSecondaryColor="0, 102, 153" LabelForeColor="100, 100, 100" ChartType="Column">  
      <SmartLabelStyle Enabled="True" />  
      <Points />  
    </Series>  
  </Series>  
  <ChartAreas>  
    <ChartArea _Template_="All" BackColor="White" BorderColor="26, 59, 105" BorderWidth="0" BorderDashStyle="Solid">      <AxisY LineColor="204, 204, 204" TitleFont="{0}, 8pt, GdiCharSet=0" TitleForeColor="100, 100, 100" LabelAutoFitMaxFontSize="7" LabelAutoFitMinFontSize="7">  
        <MajorTickMark LineColor="Gray" />  
        <MajorGrid Enabled="false" />  
        <LabelStyle Font="{0}, 6.75pt, GdiCharSet=0" ForeColor="100, 100, 100" />  
      </AxisY>  
      <AxisX LineColor="204, 204, 204" TitleFont="{0}, 8pt, GdiCharSet=0" TitleForeColor="100, 100, 100" LabelAutoFitMaxFontSize="7" LabelAutoFitMinFontSize="7">        <MajorTickMark LineColor="Gray" />        <MajorGrid Enabled="false" />  
        <LabelStyle Font="{0}, 6.75pt, GdiCharSet=0" ForeColor="100, 100, 100" />  
      </AxisX>  
    </ChartArea>  
  </ChartAreas>  
  <Titles>  
    <Title _Template_="All" Font="{0}, 9pt, style=Bold, GdiCharSet=0" ForeColor="100, 100, 100"></Title>  
  </Titles>  
  <BorderSkin PageColor="Control" BackColor="CornflowerBlue" BackSecondaryColor="CornflowerBlue" />  
</Chart>

Pour plus d’exemples de chaînes XML de description de présentation, voir Exemples de graphiques.

Voir aussi

Visualisations (Graphiques)
Actions sur les visualisations (graphiques)
Créer un graphique
Génération de requêtes avec FetchXML
Schéma FetchXML
Schéma de description des données de visualisation
Exemples de graphiques
Classe Chart (Microsoft Chart Controls)