Créer une visualisation (graphique)

Article
03/22/2023

Pour créer une visualisation par programme, vous devez créer un enregistrement pour l’Entité SavedQueryVisualization ou l’Entité UserQueryVisualization et générer respectivement un graphique appartenant à une organisation ou appartenant à un utilisateur. Cette rubrique explique comment créer une visualisation de graphique et une visualisation de ressource web.

Avant de créer une visualisation

Avant de créer une visualisation, envisagez les opérations suivantes :

Type de visualisation : si vous souhaitez que vos visualisations soient disponibles dans toute l’organisation et que vous ne souhaitez pas gérer les niveaux d’accès à un niveau plus détaillé, vous pouvez créer une visualisation appartenant à l’organisation. En revanche, si vous êtes préoccupé par les privilèges d’accès et la sécurité de votre visualisation, envisagez de créer une visualisation appartenant à l’utilisateur qui vous permet d’avoir plus de contrôle sur les utilisateurs qui peuvent y accéder.

Note

Les visualisations appartenant à une organisation peuvent uniquement être créées par les utilisateurs détenteurs du rôle Administrateur système ou Personnalisateur de système.
Entité associée : les visualisations sont jointes aux entités. Pour plus d'informations : Entités prises en charge pour les visualisations. Vous pouvez joindre un graphique à une entité prise en charge à l'aide de l'attribut SavedQueryVisualization.PrimaryEntityTypeCode ou UserQueryVisualization.PrimaryEntityTypeCode.

Créer une visualisation graphique

Les graphiques requièrent que vous spécifiez des données sous-jacentes et leur mode de présentation sous la forme de chaînes XML de description de données et d'une description de présentation. Pour plus d'informations : Spécification des données du graphique et Exemples de graphiques.

Pour obtenir un exemple complet qui explique comment créer un graphique appartenant à une organisation, voir Exemple : créer, extraire, mettre à jour et supprimer un graphique.

Créer un graphique à plusieurs séries

Les graphiques à plusieurs séries mappent plusieurs valeurs de l’axe vertical à une valeur de l’axe horizontal de la catégorie. La seule différence avec un graphique à une seule série est que ces graphiques ont plusieurs éléments <measurecollection> et <series> correspondants spécifiés dans les chaînes XML. Chaque élément <measurecollection> contient un élément enfant appelé <measure> qui définit une valeur d'axe de série (vertical) pour la même valeur de catégorie (horizontal) . Pour plus d'informations : Comprendre les graphiques : représentation des graphiques et données sous-jacentes.

Pour obtenir un exemple de graphique à plusieurs séries et de chaînes XML de description de présentation et de description de données correspondantes, voir Graphique à plusieurs séries.

Créer une visualisation de ressources web

Les visualisations contenant des ressources web n’ont pas besoin que vous spécifiez des chaînes XML de description de données et de description de présentation. L’exemple suivant montre comment créer une visualisation appartenant à une organisation contenant une ressource web à l’aide du Kit de développement logiciel.

SavedQueryVisualization newWebResourceVisualization = new SavedQueryVisualization()  
{  
   Name = "Sample Dashboard Visualization",  
   Description = "Sample organization-owned visualization",  
                           PrimaryEntityTypeCode = Account.EntityLogicalName,  
   WebResourceId = new EntityReference(WebResource.EntityLogicalName, _webResourceId))  
  
};  
_orgOwnedVisualizationId = _serviceProxy.Create(newWebResourceVisualization);

Pour créer une visualisation de ressources Web via l’application Web Dynamics 365 for Customer Engagement, vous devez créer un fichier XML au format suivant, puis utiliser Importer un graphique dans le ruban pour importer la visualisation.

<visualization>  
  <name>Visualization_Name</name>  
  <description>Description</description>  
  <webresourcename>Name_Of_An_Existing_Web_Resource</webresourcename>  
  <primaryentitytypecode>Entity_Logical_Name</primaryentitytypecode>  
  <isdefault>Value: true or false</isdefault>  
</visualization>

Par exemple, pour créer un exemple de visualisation comportant une ressource web existante appelée new_TestWebResource, la visualisation doit être jointe à l’entité de compte. Le XML doit se présenter comme suit.

<visualization>  
  <name>Sample Visualization</name>  
  <description>Sample Web Resource Visualization.</description>  
  <webresourcename>new_TestWebResource</webresourcename>  
  <primaryentitytypecode>account</primaryentitytypecode>  
  <isdefault>false</isdefault>  
</visualization>

Voir aussi

Graphiques
Spécification des données du graphique
Actions sur le graphique
Exemples de graphiques
Visualisation et analyse des données
Exemple : créer, extraire, mettre à jour et supprimer un graphique

Partager via