Requête et modification d'un thème de l'organisation

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Vous pouvez définir et appliquer des thèmes visuels pour une organisation. Il s'agit d'une solution pour appliquer le logo et les choix de couleur d'une organisation à l'application. Vous pouvez créer un thème personnalisé pour votre application en modifiant les couleurs et les éléments visuels par défaut du système Dynamics 365 non personnalisé. Par exemple, vous pouvez créer votre marquage personnel, ajouter un logo de la société et indiquer des couleurs spécifiques aux entités. Les couleurs de thème sont appliquées globalement dans toute l'application, à l'exception de certaines zones héritées.

Notes

Cette fonctionnalité a été introduite dans la mise à jour 1 de CRM Online 2015 et CRM 2016 (local).

La personnalisation du thème est prise en charge par cette version uniquement pour l'application Web. Les modifications apportées au thème d'une organisation ne sont pas incluses dans les solutions exportées de l'organisation. Vous pouvez définir plusieurs thèmes, mais un seul peut être défini et publié comme thème par défaut.

Vidéo : Choix des thèmes dans Microsoft Dynamics CRM

Contenu de la rubrique

Requête sur le thème actuel

Modifier et publier des données de thème

Exportation et importation de thèmes

Requête sur le thème actuel

Vous devrez peut-être interroger le thème actuel à l'aide du code côté client si vous disposez d'une solution avec des ressources Web HTML à adapter aux choix de thèmes faits pour une organisation. Vous pouvez utiliser la requête suivante avec l'API Web pour récupérer ces informations.

Demande :

GET <client_URL>/api/data/v8.0/themes?$filter=isdefaulttheme eq true&$select=defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor

Réponse :

    {
        "@odata.context": "<client_URL>/api/data/v8.0/$metadata#themes(defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor)",
        "value": [
            {
                "defaultentitycolor": "#001CA5",
                "defaultcustomentitycolor": "#006551",
                "controlborder": "#CCCCCC",
                "controlshade": "#F3F1F1",
                "selectedlinkeffect": "#B1D6F0",
                "globallinkcolor": "#1160B7",
                "processcontrolcolor": "#D24726",
                "headercolor": "#1160B7",
                "logotooltip": "Microsoft CRM",
                "hoverlinkeffect": "#D7EBF9",
                "navbarshelfcolor": "#DFE2E8",
                "navbarbackgroundcolor": "#002050",
                "themeid": "f499443d-2082-4938-8842-e7ee62de9a23"
            }
        ]
    }

Pour plus d'informations :Interroger les données à l'aide de l'API Web.

Modifier et publier des données de thème

Les thèmes sont créés à l'aide des outils de personnalisation de l'interface utilisateur sans qu'un développeur doive rédiger du code. Les détails concernent l'application de ces personnalisations sont disponibles dans TechNet : Modifier le modèle de couleurs ou ajouter un logo à la marque de votre organisation.

La plupart des données de thème sont stockées dans l'entité de thème. Les couleurs personnalisées d'entités spécifiques sont incluses dans la propriété EntityMetadata.EntityColor. Ces données sont exportées avec l'entité si l'entité est incluse dans une solution.

Le tableau suivant décrit les attributs d'entités Theme valides pour la mise à jour et contient les données appliquées par le thème :

Nom du schéma	Type	Valeur du thème par défaut	Description
ControlBorder	Chaîne	#CCCCCC	Couleur que les contrôles vont utiliser pour les bordures.
ControlShade	Chaîne	#F3F1F1	Couleur que les contrôles doivent utiliser lorsque vous pointez sur des éléments.
DefaultCustomEntityColor	Chaîne	#006551	Couleur par défaut pour les entités personnalisées si aucune couleur n'est attribuée.
DefaultEntityColor	Chaîne	#8B98AB	Couleur par défaut pour les entités système si aucune couleur n'est attribuée.
GlobalLinkColor	Chaîne	#1160B7	Couleur pour les liens, tels que les adresses de messagerie ou les recherches.
HeaderColor	Chaîne	#1160B7	Couleur pour le texte d'en-tête, comme les étiquettes d'onglet de formulaire.
HoverLinkEffect	Chaîne	#D7EBF9	Couleur que les commandes ou listes vont utiliser lorsque vous pointez sur les éléments.
LogoId	Chaîne	null	Nom d'une ressource Web à utiliser comme logo. Les dimensions recommandées sont : hauteur de 50 pixels et largeur maximale de 400 pixels.
LogoToolTip	Chaîne	Microsoft Dynamics 365	Texte qui servira d'info-bulle et le texte alternatif du logo.
Name	Chaîne	Thème par défaut Dynamics 365	Nom de l'entité de thème.
NavBarBackgroundColor	Chaîne	#002050	Couleur principale dans la barre de navigation.
NavBarShelfColor	Chaîne	#DFE2E8	Couleur secondaire dans la barre de navigation.
ProcessControlColor	Chaîne	#0755BE	Couleur principale pour les contrôles du processus.
SelectedLinkEffect	Chaîne	#B1D6F0	Couleur que les commandes ou listes vont utiliser pour indiquer les éléments sélectionnés.

Après avoir appliqué les modifications, utilisez le message PublishThemeRequest pour définir l'un des enregistrements de thème comme thème actuel.

Exportation et importation de thèmes

Étant donné que les thèmes ne sont pas inclus dans le cadre d'une solution, si vous souhaitez transférer des thèmes d'une organisation à une autre, vous pouvez utiliser l'outil Configuration Migration pour générer un schéma, exporter les données de thème et les importer dans une autre organisation. Pour plus d'informations sur l'utilisation de cet outil, voir Gestion des données de configuration.

Voir aussi

Messages et méthodes de l'entité Theme
Personnaliser les applications Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright