Eseguire query e modificare un tema dell'organizzazione

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Con Aggiornamento 1 di Microsoft Dynamics CRM Online 2015 puoi definire e applicare i temi grafici per un'organizzazione. Questo costituisce un modo utile per applicare il logo e i colori di un'organizzazione all'applicazione. Puoi creare un tema personalizzato per l'applicazione apportando le modifiche ai colori predefiniti e agli elementi grafici disponibili nel sistema CRM non personalizzato. Ad esempio, puoi creare un marchio di prodotto personale, aggiungere il logo di una società e applicare i colori specifici dell'entità. I colori del tema vengono applicati a livello globale nell'applicazione, ad eccezione di alcune aree legacy.

Importante

Per le organizzazioni di Microsoft Dynamics CRM Online, questa funzionalità è disponibile solo se nell'organizzazione è stato eseguito l'Aggiornamento 1 di Dynamics CRM Online 2015. Questa funzionalità non è disponibile per Dynamics CRM (locale).

La personalizzazione del tema è supportata in questa versione solo per l'applicazione web. Le modifiche apportate al tema di un'organizzazione non vengono incluse nelle soluzioni esportate dall'organizzazione. È possibile definire più temi, ma solo uno può essere impostato e pubblicato come tema predefinito.

Video: Tema in Microsoft Dynamics CRM

In questo argomento

Eseguire una query sul tema corrente

Modificare e pubblicare i dati del tema

Esportare e importare temi

Eseguire una query sul tema corrente

Potrebbe essere necessario eseguire query sul tema corrente tramite il codice sul lato client se hai una soluzione con le risorse Web HTML in cui desideri adattare le scelte del tema effettuate per un'organizzazione. Puoi utilizzare la seguente query con l'endpoint OData per recuperare le informazioni.

<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

Ulteriori informazioni:Utilizzare l'endpoint OData con risorse Web.

Modificare e pubblicare i dati del tema

Il tema viene creato tramite gli strumenti di personalizzazione dell'interfaccia utente, senza la necessità che lo sviluppatore scriva il codice. I dettagli su come applicare tali personalizzazioni sono disponibili in Technet: Modificare la combinazione di colori o aggiungere un logo con il marchio dell'organizzazione.

La maggior parte dei dati sono archiviati all'interno dell'entità tema. I colori personalizzati per entità specifiche sono inclusi nella proprietà EntityMetadata.EntityColor. Questi dati vengono esportati con l'entità se l'entità è inclusa in una soluzione.

Nella tabella seguente vengono descritti gli attributi dell'entità Theme che sono validi per l'aggiornamento e contengono i dati applicati dal tema:

Nome schema	Tipo	Valore del tema predefinito	Descrizione
ControlBorder	String	#CCCCCC	Colore utilizzato dai controlli per i bordi.
ControlShade	String	#F3F1F1	Colore utilizzato dai controlli per indicare quando si posiziona il puntatore del mouse sugli elementi.
DefaultCustomEntityColor	String	#006551	Colore di entità personalizzato predefinito se non è assegnato alcun colore.
DefaultEntityColor	String	#8B98AB	Colore predefinito per le entità di sistema se non è assegnato alcun colore.
GlobalLinkColor	String	#1160B7	Colore per i collegamenti, ad esempio indirizzi e-mail o ricerche.
HeaderColor	String	#1160B7	Colore per il testo dell'intestazione, ad esempio etichette di scheda del modulo.
HoverLinkEffect	String	#D7EBF9	Colore utilizzato da comandi o elenchi per gli elementi su cui è posizionato il puntatore del mouse.
LogoId	String	null	Nome di una risorsa Web da utilizzare come logo. Le dimensioni consigliate sono 50 pixel per l'altezza e un massimo di 400 pixel per la larghezza.
LogoToolTip	String	Microsoft Dynamics CRM	Testo che verrà utilizzato come testo alternativo e della descrizione del logo.
Name	String	Tema predefinito CRM	Nome dell'entità tema.
NavBarBackgroundColor	String	#002050	Colore primario per la barra di spostamento.
NavBarShelfColor	String	#DFE2E8	Colore secondario per la barra di spostamento.
ProcessControlColor	String	#0755BE	Colore primario per i controlli di processo.
SelectedLinkEffect	String	#B1D6F0	Colore utilizzato da comandi o elenchi per indicare elementi selezionati.

Dopo aver applicato le modifiche, utilizza il messaggio PublishThemeRequest per rendere corrente un record di tema.

Esportare e importare temi

Dal momento che i temi non sono inclusi nell'ambito di una soluzione, per trasferire i temi da un'organizzazione a un'altra puoi utilizzare lo strumento Configuration Migration per generare uno schema, esportare i dati del tema e importarli in un'organizzazione diversa. Per informazioni dettagliate su come utilizzare questo strumento, vedi Gestione dei dati di configurazione.

Vedere anche

Metodi e messaggi dell'entità tema
Theme entity privileges
Guida per sviluppatori sulla personalizzazione per Microsoft Dynamics CRM 2015

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright