Requête et modification d’un thème de l’organisation
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 for Customer Engagement 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.
Note
Cette fonctionnalité a été introduite dans Dynamics CRM Online 2015 Update 1 et CRM 2016 (on-premises).
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 : Thématique dans Microsoft Dynamics 365 Customer Engagement
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 [Organization URI]/api/data/v9.1/themes?$filter=isdefaulttheme eq true&$select=defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor
Réponse :
HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0
{
"@odata.context": "[Organization URI]/api/data/v9.1/$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, consultez 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 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 |
|---|---|---|---|
| AccentColor | Chaîne | #E83D0F | Couleur de thème secondaire de Unified Interface à utiliser sur le contrôle du processus. |
| BackgroundColor | Chaîne | #FFFFFF | Utilisation interne uniquement. |
| ControlBorder | Chaîne | #BDC3C7 | Couleur que les contrôles vont utiliser pour les bordures. |
| ControlShade | Chaîne | #FFFFFF | Couleur que les contrôles doivent utiliser lorsque vous pointez sur des éléments. |
| DefaultCustomEntityColor | Chaîne | #00CCA3 | Couleur par défaut pour les entités personnalisées si aucune couleur n’est attribuée. |
| DefaultEntityColor | Chaîne | #666666 | 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 | #E7EFF7 | Couleur que les commandes ou listes vont utiliser lorsque vous pointez sur les éléments. |
| ImportSequenceNumber | Entier | null | Numéro séquentiel de l’importation ayant créé cet enregistrement. |
| IsDefaultTheme | Booléen | True | La valeur par défaut pour un thème personnalisé est false. |
| 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 | String | Microsoft Dynamics 365 Customer Engagement | Texte qui servira d’info-bulle et le texte alternatif du logo. |
| MainColor | Chaîne | #3B79B7 | La couleur de thème principale de Unified Interface à utiliser pour la barre de commandes principale, les boutons et les onglets. |
| Nom | Chaîne | Thème CRM par défaut | 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. |
| OverriddenCreatedOn | Date/Heure | null | Date et heure de migration de l’enregistrement. |
| PageHeaderBackgroundColor | Chaîne | #E0E0E0 | Couleur d’arrière-plan d’en-tête de page. |
| PanelHeaderBackgroundColor | Chaîne | #F3F3F3 | Couleur d’arrière-plan d’en-tête de volet. |
| ProcessControlColor | Chaîne | #41A053 | Couleur principale pour les contrôles du processus. |
| SelectedLinkEffect | Chaîne | #F8FAFC | Couleur que les commandes ou listes vont utiliser pour indiquer les éléments sélectionnés. |
| TransactionCurrencyId | Recherche | null | Taux de change de la devise associée au thème par rapport à la devise de base. |
Après avoir appliqué les modifications, utilisez la classe Action PublishTheme ou 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 de migration de la configuration 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 Déplacer les données de configuration à l’aide de l’outil de migration de la configuration.
Voir aussi
Entité Theme
Créer un thème
Guide pour les développeurs sur la personnalisation de Microsoft Dynamics 365 Customer Engagement