Actions sur les visualisations (graphiques)
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Avec le SDK de Microsoft Dynamics 365, vous pouvez effectuer les actions suivantes sur les entités de visualisation.
Actions sur les visualisations appartenant à une organisation
Pour effectuer des actions sur une visualisation appartenant à une organisation (SavedQueryVisualization), vous devez bénéficier d’un rôle Administrateur système ou Personnalisateur de système. Vous pouvez effectuer les actions suivantes sur une visualisation appartenant à une organisation :
Créer, récupérer, mettre à jour et supprimer une visualisation appartenant à une organisation.Pour plus d'informations :Créer une visualisation (graphique)
Notes
Après avoir mis à jour une visualisation appartenant à une organisation, vous devez publier les modifications apportées aux métadonnées pour les rendre visibles dans l’organisation à l’aide du message PublishAllXmlRequest. Par ailleurs, lorsque vous publiez une entité, toutes les visualisations de l’organisation non publiées qui sont associées à l’entité sont publiées automatiquement.
Interroger et récupérer toutes les visualisations appartenant à une organisation qui sont liées à une entité à l’aide de l’attribut SavedQueryVisualization.PrimaryEntityTypeCode. Plusieurs visualisations détenues par l’organisation peuvent être jointes à une seule entité. Pour une liste d’entités avec laquelle vous pouvez joindre une visualisation, voir Entités prises en charge pour les visualisations. Pour un exemple de code qui montre comment extraire toutes les visualisations appartenant à une organisation jointes à une entité, voir Exemple : Extraire tous les graphiques associés à une entité.
Notes
Vous ne pouvez pas modifier ni mettre à jour une visualisation pour la joindre à une autre entité après avoir créé la visualisation. Cela implique que l’attribut SavedQueryVisualization.PrimaryEntityTypeCode n’est pas valide pour l’action de mise à jour sur la visualisation appartenant à une organisation.
Spécifier une visualisation appartenant à une organisation comme visualisation par défaut de l’entité associée en définissant l’attribut SavedQueryVisualization.IsDefault sur true. Lorsque vous définissez une visualisation appartenant à une organisation comme visualisation par défaut d’une entité, la visualisation s’affiche par défaut lorsque vous choisissez d’afficher des visualisations pour cette entité dans Microsoft Dynamics 365.
Notes
Avec SDK de Microsoft Dynamics 365, si vous définissez une visualisation appartenant à une organisation comme valeur par défaut pour une entité qui a déjà une autre visualisation définie par défaut, les deux visualisations seront marquées comme étant des visualisations par défaut de l’entité. Pour définir une visualisation comme visualisation par défaut d’une entité, vérifiez qu’aucune autre visualisation n’est définie comme visualisation par défaut pour l’entité.
Pour obtenir la liste des messages pris en charge sur l’entité de visualisation appartenant à une organisation, voir Messages et méthodes d’entités SavedQueryVisualization (graphique système).
Actions sur les visualisations appartenant à un utilisateur
Vous pouvez effectuer les actions suivantes sur une visualisation appartenant à un utilisateur (UserQueryVisualization) :
Créer, récupérer, mettre à jour et supprimer une visualisation appartenant à un utilisateur.Pour plus d'informations :Créer une visualisation (graphique)
Interroger et récupérer toutes les visualisations appartenant à un utilisateur qui sont liées à une entité à l’aide de l’attribut UserQueryVisualization.PrimaryEntityTypeCode. Plusieurs visualisations détenues par un utilisateur peuvent être jointes à une entité. Pour une liste d’entités avec laquelle vous pouvez joindre une visualisation, voir Entités prises en charge pour les visualisations.
Notes
Vous ne pouvez pas modifier ni mettre à jour une visualisation pour la joindre à une autre entité après avoir créé la visualisation. Cela implique que l’attribut UserQueryVisualization.PrimaryEntityTypeCode n’est pas valide pour l’action de mise à jour sur la visualisation appartenant à un utilisateur.
Modifier la propriété d’une visualisation appartenant à un utilisateur en l’attribuant à un autre utilisateur ou à une autre équipe à l’aide de AssignRequest.
Récupérer l’accès dont le principal de sécurité (utilisateur ou équipe) spécifié dispose sur une visualisation appartenant à un utilisateur à l’aide de RetrievePrincipalAccessRequest. Vous pouvez également récupérer tous les principaux de sécurité (utilisateurs ou équipes) ayant accès à une visualisation appartenant à un utilisateur, ainsi que leurs droits d’accès à la visualisation utilisateur à l’aide de RetrieveSharedPrincipalsAndAccessRequest.
Collaborer avec d’autres utilisateurs et équipes dans des domaines spécifiques en partageant avec eux une visualisation appartenant à un utilisateur à l’aide de GrantAccessRequest, ModifyAccessRequest et RevokeAccessRequest.
Pour obtenir la liste des messages pris en charge sur l’entité de visualisation appartenant à un utilisateur, voir Messages et méthodes de l’entité UserQueryVisualization (graphique utilisateur).
Voir aussi
Afficher des données avec les visualisations (graphiques)
Comprendre les graphiques : représentation des données et des graphiques sous-jacents
Créer une visualisation (graphique)
Exemples de graphiques
Exemple : créer, extraire, mettre à jour et supprimer un graphique
Exemple : Extraire tous les graphiques associés à une entité
Exemple : Attribuer un graphique à un autre utilisateur
Messages et méthodes d’entités SavedQueryVisualization (graphique système)
Messages et méthodes de l’entité UserQueryVisualization (graphique utilisateur)
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright