Requête et modification d'un thème de l'organisation
Date de publication : novembre 2016
S’applique à : Dynamics CRM 2015
Avec Mise à jour 1 de Microsoft Dynamics CRM Online 2015 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 CRM 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.
Important
Pour les organisations Microsoft Dynamics CRM Online, cette fonctionnalité n'est disponible que si votre organisation a effectué la mise à jour vers la mise à jour 1 de Dynamics CRM Online 2015. Cette fonctionnalité n'est pas disponible pour Dynamics CRM (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 le point de terminaison OData pour récupérer ces informations.
<client_URL>/xrmservices/2011/organizationdata.svc/ThemeSet?$select=ControlBorder,ControlShade,DefaultCustomEntityColor,Name,DefaultEntityColor,GlobalLinkColor,HeaderColor,HoverLinkEffect,NavBarBackgroundColor,LogoToolTip,NavBarShelfColor,ProcessControlColor,SelectedLinkEffect&$filter=IsDefaultTheme eq true
Pour plus d'informations :Utiliser le point de terminaison OData avec les ressources 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 CRM |
Texte qui servira d'info-bulle et le texte alternatif du logo. |
Name |
Chaîne |
Thème par défaut de CRM |
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
Theme entity privileges
Guide destiné aux développeurs chargés de la personnalisation de Microsoft Dynamics CRM 2015
© 2017 Microsoft. Tous droits réservés. Copyright