Consultar e editar um tema da organização

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Você pode definir e aplicar temas visuais a uma organização. Isso oferece uma maneira com suporte para aplicar o logotipo e as opções de cores de uma organização ao aplicativo. Você pode criar um tema personalizado para seu aplicativo fazendo alterações nas cores padrão e nos elementos visuais fornecidos no sistema Dynamics 365 não personalizado. Por exemplo, você pode criar a identidade visual do seu produto pessoal, adicionar um logotipo da empresa e fornecer cores específicas da entidade. As cores do tema são aplicadas globalmente em todo o aplicativo, com a exceção de algumas áreas herdadas.

Observação

Esse recurso foi apresentado na Atualização 1 do CRM Online 2015 e no CRM 2016 (local).

A personalização do tema tem suporte nesta versão somente para o aplicativo Web. As alterações feitas no tema de uma organização não são incluídas em soluções exportadas da organização. Você pode definir vários temas, mas somente um poderá ser definido e publicado como o tema padrão.

Vídeo: Temas no Microsoft Dynamics CRM

Neste tópico

Consultar o tema atual

Editar e publicar os dados do tema

Exportando e importando temas

Consultar o tema atual

Talvez seja necessário consultar o tema atual com o código do cliente se houver uma solução com recursos HTML da Web que você queira adaptar às opções de tema feitas para uma organização. Use a consulta a seguir com a API Web para recuperar essas informações.

Solicitação:

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

Resposta:

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

Para obter mais informações:Consultar dados usando a API da Web.

Editar e publicar os dados do tema

Um tema é criado usando as ferramentas de personalização na interface do usuário, sem exigir que um desenvolvedor escreva códigos. Os detalhes sobre como aplicar essas personalizações se encontram em TechNet: alterar o esquema de cores ou adicionar um logotipo de acordo com o seu tipo da organização.

A maioria dos dados do tema são armazenados na entidade do tema. As cores personalizadas para entidades específicas são incluídas na propriedade EntityMetadata.EntityColor. Esses dados serão exportados com a entidade se a entidade for incluída em uma solução.

A seguinte tabela descreve os atributos da entidade Theme válidos para atualização e contém os dados a serem aplicados pelo tema:

Nome do Esquema	Tipo	Valor do tema padrão	Descrição
ControlBorder	Cadeia de caracteres	#CCCCCC	A cor que controles usarão para as bordas,
ControlShade	Cadeia de caracteres	#F3F1F1	A cor que controles usam para indicar quando você passa o mouse sobre os itens.
DefaultCustomEntityColor	Cadeia de caracteres	#006551	A cor da entidade personalizada padrão se nenhuma cor for atribuída.
DefaultEntityColor	Cadeia de caracteres	#8B98AB	A cor padrão das entidades do sistema se nenhuma cor for atribuída.
GlobalLinkColor	Cadeia de caracteres	#1160B7	A cor dos links, como endereços de email ou consultas.
HeaderColor	Cadeia de caracteres	#1160B7	A cor do texto de cabeçalho, como rótulos de guia de formulário.
HoverLinkEffect	Cadeia de caracteres	#D7EBF9	A cor que os comandos e as listas usarão quando você passar o mouse sobre os itens.
LogoId	Cadeia de caracteres	nulo	O nome de um recurso da Web a ser usado como um logotipo. As dimensões recomendadas são 50 pixels de altura e no máximo 400 pixels de largura.
LogoToolTip	Cadeia de caracteres	Microsoft Dynamics 365	O texto que será usado como a dica de tela e o texto alternativo do logotipo.
Name	Cadeia de caracteres	Tema padrão do Dynamics 365	O nome da entidade do tema.
NavBarBackgroundColor	Cadeia de caracteres	#002050	A cor da barra de navegação principal.
NavBarShelfColor	Cadeia de caracteres	#DFE2E8	A cor da barra de navegação secundária.
ProcessControlColor	Cadeia de caracteres	#0755BE	A cor principal de controles do processo.
SelectedLinkEffect	Cadeia de caracteres	#B1D6F0	A cor que os comandos ou as listas usarão para indicar itens selecionados.

Após aplicar as alterações, use a mensagem PublishThemeRequest para tornar um dos registros de tema o tema atual.

Exportando e importando temas

Como os temas não estão incluídos como parte de uma solução, para transferir temas de uma organização para outra, você pode usar a ferramenta Configuration Migration para gerar um esquema, exportar os dados do tema e importá-los para outra organização. Para obter detalhes sobre como usar essa ferramenta, consulte Gerenciar dados de configuração.

Confira Também

Mensagens e métodos da entidade de tema
Personalizar o aplicativo Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais