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