Eseguire query e modificare un tema dell'organizzazione

  • Articolo

 

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