Eseguire query e modificare un tema dell'organizzazione

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 Dynamics 365 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.

Nota

Questa funzionalità è stata introdotta nell'Aggiornamento 1 di CRM Online 2015 e in CRM 2016 (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'API Web per recuperare le informazioni.

Richiesta:

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

Risposta:

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

Ulteriori informazioni:Query di dati tramite l'API 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 365	Testo che verrà utilizzato come testo alternativo e della descrizione del logo.
Name	Stringa	Tema predefinito di Dynamics 365	Nome dell'entità tema.
NavBarBackgroundColor	Stringa	#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
Personalizzare le applicazioni di Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright