Consultar y editar un tema de organización

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Puede definir y aplicar temas visuales a una organización. Esto proporciona una forma compatible de aplicar el logotipo y las opciones de color de una organización a la aplicación. Puede crear un tema personalizado para su aplicación realizando cambios en los colores predeterminados y los elementos visuales proporcionados en el sistema de Dynamics 365 no personalizado. Por ejemplo, puede crear su marca de producto personal, agregar un logotipo de compañía y proporcionar colores específicos de la entidad. Los colores de tema se aplican globalmente en toda la aplicación, con la excepción de algunas áreas heredadas.

Nota

Esta característica se introdujo en la actualización 1 de CRM Online 2015 y CRM 2016 (local).

La personalización del tema se admite en esta versión solo para la aplicación web. Los cambios realizados en el tema de una organización no están incluidos en soluciones exportadas desde la organización. Puede definir varios temas, pero solo puede establecer y publicar uno como tema predeterminado.

Vídeo: Temas en Microsoft Dynamics CRM

En este tema

Consulte el tema actual

Editar y publicar datos de temas

Exportar e importar temas

Consulte el tema actual

Es posible que necesite consultar el tema actual utilizando código del lado cliente si tiene una solución con recursos web HTML que desea adaptar a las decisiones de tema tomadas para una organización. Puede usar la siguiente consulta con la API web para recuperar esa información.

Solicitud:

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

Respuesta:

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

Más información:Consultar datos utilizando la API web.

Editar y publicar datos de temas

Un tema se crea mediante las herramientas de personalización de la interfaz de usuario, sin necesidad de que un programador escriba código. Encontrará información sobre cómo aplicar estas personalizaciones en TechNet: Cambiar la combinación de colores o agregar un logotipo para que coincida con la marca de la organización.

La mayoría de datos del tema se almacenan en la entidad de tema. Los colores personalizados de entidades específicas se incluyen en la propiedad EntityMetadata. deEntityColor. Estos datos se exportan con la entidad si la entidad se incluye en una solución.

La siguiente tabla describe los atributos de entidad de Theme que son válidos para la actualización y contienen datos que aplica el tema:

Nombre de esquema	Tipo	Valor del tema predeterminado	Descripción
ControlBorder	Cadena	#CCCCCC	El color que los controles usarán para los bordes.
ControlShade	Cadena	#F3F1F1	El color que los controles usarán para indicar cuándo pasa el puntero sobre elementos.
DefaultCustomEntityColor	Cadena	#006551	El color predeterminado de entidad personalizada si no se asigna ningún color.
DefaultEntityColor	Cadena	#8B98AB	El color predeterminado para las entidades del sistema si no se asigna ningún color.
GlobalLinkColor	Cadena	#1160B7	El color para vínculos, como direcciones de correo electrónico o búsquedas.
HeaderColor	Cadena	#1160B7	El color para el texto de encabezado, como las etiquetas de las pestañas del formulario.
HoverLinkEffect	Cadena	#D7EBF9	El color que los comandos o listas usarán al pasar el puntero sobre los elementos.
LogoId	Cadena	null	El nombre de un recurso web que desea usar como logotipo. Las dimensiones recomendadas son una altura de 50 píxeles y un ancho máximo de 400 píxeles.
LogoToolTip	Cadena	Microsoft Dynamics 365	El texto que se usará como información en pantalla y texto alternativo para el logotipo.
Name	Cadena	Tema predeterminado de Dynamics 365	El nombre de la entidad de tema.
NavBarBackgroundColor	Cadena	#002050	El color de barra de navegación principal.
NavBarShelfColor	Cadena	#DFE2E8	El color de barra de navegación secundaria.
ProcessControlColor	Cadena	#0755BE	El color principal para los controles de proceso.
SelectedLinkEffect	Cadena	#B1D6F0	El color que los comandos o listas usarán para indicar los elementos seleccionados.

Una vez que haya aplicado los cambios, use el mensaje PublishThemeRequest para crear uno de los registros del tema actual.

Exportar e importar temas

Dado que los temas no se incluyen como parte de una solución, si desea transferir temas de una organización a otra puede usar la herramienta Configuration Migration para generar un esquema, exportar los datos del tema e importarlos a otra organización. Para obtener más información sobre cómo usar esta herramienta, consulte Administrar datos de configuración.

Ver también

Mensajes y métodos de la entidad de tema
Personalizar aplicaciones de Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright