Query uitvoeren op het thema van een organisatie en dit bewerken

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

U kunt visuele thema's definiëren voor een organisatie. Dit biedt een ondersteunde manier om het logo en de kleurkeuzen van een organisatie toe te passen op de toepassing. U kunt een aangepast thema voor uw toepassing maken door de standaardkleuren en visuele elementen van het niet-aangepaste Dynamics 365-systeem te wijzigen. U kunt bijvoorbeeld uw persoonlijke producthuisstijl maken, een bedrijfslogo toevoegen en entiteitspecifieke kleuren bieden. De themakleuren worden globaal toegepast in de toepassing, met uitzondering van bepaalde legacygebieden.

Notitie

Deze functie werd geïntroduceerd in update 1 van CRM Online 2015 en in CRM 2016 (on-premises).

Thema-aanpassing wordt in deze versie allen ondersteund voor de webtoepassing. De wijzigingen in het thema van een organisatie worden niet opgenomen in oplossingen die uit de organisatie worden geëxporteerd. U kunt meerdere thema's definiëren, maar er kan er slechts één zijn ingesteld en worden gepubliceerd als het standaardthema.

Video: Themagebruik in Microsoft Dynamics CRM

In dit onderwerp

Query uitvoern op het huidige thema

Themagegevens bewerken en publiceren

Thema's exporteren en importeren

Query uitvoern op het huidige thema

Mogelijk moet u een query uitvoeren op het huidige thema via clientcode als u een oplossing hebt met HTML-webresources die u wilt aanpassen aan themakeuzen die zijn uitgevoerd voor een organisatie. U kunt de volgende query uitvoeren met de Web API om die informatie op te halen.

Aanvraag:

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

Respons:

 {
     "@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"
         }
     ]
 }

Meer informatie:Querygegevens met behulp van de web-API.

Themagegevens bewerken en publiceren

Een thema wordt gemaakt met de aanpassingshulpmiddelen in de UI, zonder dat een ontwikkelaar code hoeft te schrijven. Details over het toepassen van deze aanpassingen is te vinden in TechNet: Het kleurenschema wijzigen of een logo toevoegen met het merk van uw organisatie.

De meeste themagegevens zijn opgeslagen binnen de entiteit Thema. Aangepaste kleuren voor specifieke entiteiten zijn opgenomen in de eigenschap EntityMetadata.EntityColor. Deze gegevens worden geëxporteerd met de entiteit als de entiteit wordt opgenomen in een oplossing.

In de volgende tabel worden de kenmerken van de entiteit Theme beschreven die geldig updates en die gegevens bevatten die worden toegepast door het thema:

Schemanaam	Type	Waarde van standaardthema	Beschrijving
ControlBorder	Tekenreeks	#CCCCCC	De kleur die voor de randen van besturingselementen worden gebruikt.
ControlShade	Tekenreeks	#F3F1F1	De kleur die voor besturingselementen wordt gebruikt om aangewezen items aan te duiden.
DefaultCustomEntityColor	Tekenreeks	#006551	De standaardkleur voor aangepaste entiteiten als geen kleur is toegewezen.
DefaultEntityColor	Tekenreeks	#8B98AB	De standaardkleur voor systeementiteiten als geen kleur is toegewezen.
GlobalLinkColor	Tekenreeks	#1160B7	De kleur voor koppelingen, zoals e-mailadressen of opzoekacties.
HeaderColor	Tekenreeks	#1160B7	De kleur voor koptekst, zoals bijschriften van formuliertabs.
HoverLinkEffect	Tekenreeks	#D7EBF9	De kleur die in opdrachten of lijsten wordt gebruikt wanneer u de muis boven de items houdt.
LogoId	Tekenreeks	null	De naam van een webresource die u als logo wilt gebruiken. Aanbevolen afmetingen zijn een hoogte van 50 pixels en een breedte van maximaal 400 pixels.
LogoToolTip	Tekenreeks	Microsoft Dynamics 365	De tekst die als knopinfo en als alt-tekst voor het logo kan worden gebruikt.
Name	Tekenreeks	Standaardthema Dynamics 365	De naam van de entiteit Thema.
NavBarBackgroundColor	Tekenreeks	#002050	De primaire navigatiebalkkleur.
NavBarShelfColor	Tekenreeks	#DFE2E8	De secundaire kleur van de navigatiebalk.
ProcessControlColor	Tekenreeks	#0755BE	De primaire kleur voor procesbesturingselementen.
SelectedLinkEffect	Tekenreeks	#B1D6F0	De kleur die in opdrachten of lijsten wordt gebruikt om geselecteerde items aan te duiden.

Nadat u wijzigingen hebt aangebracht, gebruikt u het bericht PublishThemeRequest om een van de themarecords tot het huidige thema te maken.

Thema's exporteren en importeren

Aangezien thema's geen deel uitmaken van een oplossing, kunt u als u thema's wilt overdragen van de ene organisatie naar de andere, het hulpprogramma voor configuratiemigratie gebruiken om een schema te genereren, de themagegevens te exporteren en deze te importeren in een andere organisatie. Zie Configuratiegegevens beheren voor meer informatie over het gebruik van dit hulpprogramma.

Zie ook

Berichten en methoden van de entiteit Theme
Microsoft Dynamics 365-toepassingen aanpassen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht