Usar temas de relatório no Power BI Desktop

Artigo
07/12/2024

APLICA-SE A: Serviço Power BI do Power BI Desktop

Com os temas de relatório do Power BI Desktop, você pode aplicar alterações de design a todo o relatório, como usar cores corporativas, alterar conjuntos de ícones ou aplicar nova formatação visual padrão. Quando você aplica um tema de relatório, todos os elementos visuais do relatório usam as cores e a formatação do tema selecionado como padrão. Algumas exceções são descritas mais adiante neste artigo.

Você pode selecionar temas de relatório acessando a faixa de opções Exibir . Na secção Temas, selecione a seta pendente e, em seguida, selecione o tema pretendido. Os temas disponíveis são semelhantes aos temas vistos em outros produtos da Microsoft, como o Microsoft PowerPoint.

Os dois tipos de temas de relatório:

Os temas de relatório integrados fornecem diferentes tipos de esquemas de cores predefinidos. Você seleciona temas de relatório internos diretamente no menu do Power BI Desktop.
Os temas de relatório personalizados fornecem controle granular sobre muitos aspetos de um tema de relatório, conforme descrito em Personalizar temas de relatório mais adiante neste artigo. Você pode criar temas de relatório personalizados ajustando um tema atual e salvando-o como um tema personalizado ou criando seu próprio tema personalizado usando um arquivo JSON.

Formas de aplicar um tema de relatório

Para aplicar um tema de relatório a um relatório do Power BI Desktop, você pode selecionar uma das seguintes opções:

Selecione entre os temas de relatório internos disponíveis que estão incorporados no Power BI Desktop.
Personalize um tema usando a caixa de diálogo Personalizar tema .
Importe um arquivo JSON de tema personalizado.

Nota

Você só pode aplicar temas no Power BI Desktop. Não é possível aplicar temas a relatórios existentes no serviço Power BI.

Aplicar um tema de relatório interno

Siga estas etapas para selecionar entre os temas de relatório internos disponíveis. Consulte a tabela Temas de relatório internos para obter a sequência de cores padrão para cada tema.

No friso Ver, selecione a seta pendente junto a Temas .
Selecione entre os temas no menu suspenso exibido, incluindo os novos temas acessíveis.

O tema do relatório agora é aplicado ao relatório.
Você também pode navegar pela coleção de temas criados por membros da Comunidade do Power BI, selecionando Galeria de temas no menu suspenso Temas.

Na galeria, você pode selecionar um tema e baixar seu arquivo JSON associado.

Para instalar o arquivo baixado, selecione Procurar temas no menu suspenso Temas , vá para o local onde você baixou o arquivo JSON e selecione-o para importar o tema para o Power BI Desktop como um novo tema.

Quando bem-sucedida, o Power BI mostra uma caixa de diálogo informando que a importação foi bem-sucedida.

Temas de relatório integrados

A tabela a seguir mostra os temas de relatório internos disponíveis.

Tema de relatório integrado	Sequência de cores padrão
Predefinido
Arranha-céus
Executivo
Fronteira
Inove
Em flor
Marés
Temperatura
Solar
Divergente
Storm
Clássico
Parque da cidade
Sala de Aula
Cofre para daltónicos
Elétrico
Contraste elevado
Pôr-do-sol
Crepúsculo
Padrão acessível
Parque da cidade acessível
Maré acessível
Neutro acessível
Orquídea acessível

Personalizar temas de relatório

Você pode personalizar e padronizar a maioria dos elementos listados na seção Formato do painel Visualizações , por meio de personalizações feitas diretamente no Power BI Desktop ou por meio de um arquivo JSON de tema de relatório. O objetivo é oferecer controle total sobre a aparência padrão do relatório em um nível granular.

Você pode personalizar os temas de relatório das seguintes maneiras:

Personalizar e guardar um tema no Power BI Desktop
Criar e personalizar um arquivo JSON de tema de relatório personalizado

Personalizar e guardar um tema no Power BI Desktop

Para personalizar um tema diretamente no Power BI Desktop, você pode selecionar um tema próximo ao que você gosta e fazer alguns ajustes. Primeiro, selecione o tema que está perto e siga as seguintes etapas:

Na faixa de opções Exibir, selecione o botão suspenso Temas e selecione Personalizar tema atual.
É exibida uma caixa de diálogo onde você pode fazer alterações no tema atual e, em seguida, salvar suas configurações como um novo tema.

Você pode encontrar configurações de tema personalizáveis nas seguintes categorias, refletidas na janela Personalizar tema :

Nome e cores: As configurações de nome e cor do tema incluem cores de tema, cores de sentimento, cores divergentes e cores estruturais (Avançado).
Texto: as configurações de texto incluem família de fontes, tamanho e cor, que define os padrões da classe de texto principal para rótulos, títulos, cartões e KPIs e cabeçalhos de guia.
Elementos visuais: as configurações visuais incluem plano de fundo, borda, cabeçalho e dicas de ferramentas.
Página: As configurações do elemento Page incluem papel de parede e plano de fundo.
Painel de filtro: as configurações do painel de filtros incluem cor de plano de fundo, transparência, cor da fonte e do ícone, tamanho e cartões de filtro.

Depois de fazer as alterações, selecione Aplicar e salvar para salvar o tema. Agora você pode usar o tema no relatório atual e exportá-lo.

Personalizar o tema atual desta forma é rápido e simples. No entanto, você também pode fazer ajustes mais finos nos temas, que exigem a modificação do arquivo JSON do tema.

Gorjeta

Você pode personalizar as opções de tema de relatório mais comuns usando os controles na caixa de diálogo Personalizar tema . Para obter mais controle, você pode exportar o arquivo JSON de um tema e fazer ajustes ajustados modificando manualmente as configurações nesse arquivo. Você pode renomear esse arquivo JSON e depois importá-lo.

Atualizar o tema base

O Power BI faz alterações em temas, incluindo novos padrões para configurações de formatação, como parte de um novo tema base. Para não perturbar os relatórios existentes, essas alterações não se propagam para temas personalizados. Se você personalizou um tema interno, talvez não veja correções para problemas ou atualizações para seus relatórios sem atualizar seus temas básicos.

Para ver se está a utilizar um tema desatualizado, no friso Ver , selecione o botão pendente Temas e selecione Personalizar tema atual. Se o tema estiver desatualizado, você verá um banner na parte superior do tema, incentivando-o a atualizar para o tema base mais recente.

Selecione Atualizar tema para ver as alterações e, em seguida, selecione Aplicar.

Captura de ecrã a mostrar a opção Atualizar tema.

Importar arquivos de tema de relatório personalizados

Você também pode importar um arquivo de tema de relatório personalizado seguindo estas etapas:

No friso Ver, selecione o botão> pendente Temas Procurar temas.

Aparece uma janela que você pode usar para ir para o arquivo de tema JSON.
Na imagem a seguir, você pode ver os arquivos de tema de férias. Veja a seleção de exemplos de um tema de férias para março, St Patricks Day.json.

Quando o arquivo de tema for carregado com êxito, o Power BI Desktop exibirá uma mensagem de êxito.

Consulte a seção Exemplo de arquivo JSON do tema do relatório neste artigo para continuar explorando o arquivo St Patricks Day.json.

Como as cores do tema do relatório permanecem com seus relatórios

Quando você publica seu relatório no serviço do Power BI, as cores do tema do relatório permanecem com ele. A seção Cores do painel Formato reflete o tema do relatório.

Para exibir as cores disponíveis em um tema de relatório:

Selecione a tela de relatório ou um dos elementos visuais na tela.
Na seção Formato do painel Visualização, selecione Cor.

A paleta Cores do tema do relatório é aberta.

No exemplo, depois de aplicar a infinidade de cores verdes e marrons do tema de relatório do Dia de São Patrício, você pode exibir as cores do tema. As cores fazem parte do tema de relatório importado e aplicado.

As cores na paleta de cores são relativas ao tema atual. Por exemplo, suponha que você selecione a terceira cor da linha superior para um ponto de dados. Mais tarde, se você mudar para um tema diferente, a cor desse ponto de dados será atualizada automaticamente para a terceira cor da linha superior do novo tema, assim como você verá ao alterar temas no Microsoft Office.

A definição de um tema de relatório altera as cores padrão usadas em elementos visuais em todo o relatório. O Power BI mantém uma lista composta por centenas de cores para garantir que os elementos visuais tenham muitas cores exclusivas para exibir em um relatório. Quando o Power BI atribui cores à série de um visual, as cores são selecionadas à medida que as cores da série são atribuídas. Quando você importa um tema, o mapeamento de cores para séries de dados é redefinido.

Série dinâmica

O Power BI rastreia a cor de uma série dinâmica e usa a mesma cor para o valor em outros elementos visuais. Em uma série dinâmica, o número de séries apresentadas em visuais pode mudar com base em medidas, valores ou outros aspetos. Por exemplo, se você mostrar Lucro por região em um relatório, poderá ter cinco regiões de vendas ou nove. O número de regiões é dinâmico, por isso é considerado uma série dinâmica.

Membros individuais de uma série dinâmica reivindicam uma cor da paleta de cores de dados à medida que são lidos. Por exemplo, se um visual tem um conjunto de membros Lucro por Região e um segundo visual também tem um conjunto de membros Lucro por Região, mas o conjunto de membros é separado, o primeiro visual a ter sua solicitação de dados concluída reserva as cores anteriores. Como as cores para membros individuais da série dinâmica não são armazenadas explicitamente, esse comportamento pode levar à aparência de que as cores estão mudando aleatoriamente, dependendo de quais elementos visuais são carregados primeiro. Você sempre pode atribuir membros específicos a uma cor específica usando o painel de formatação: veja mais informações sobre como alterar a cor de um único ponto de dados.

Série estática

Inversamente, para as séries estáticas, o número de séries e a sua ordem são conhecidos. Por exemplo, Lucro e Receita são séries estáticas. Em séries estáticas, o Power BI atribui cores por índice dentro das paletas de temas. Você pode substituir a atribuição de cores padrão selecionando uma cor no painel de formatação em Cores de dados. Talvez seja necessário alterar as seleções de segmentação de dados para ver todos os valores potenciais da série e definir suas cores também. Se você definir explicitamente uma cor como um único visual usando o painel Propriedades , o tema importado não se aplicará a nenhuma dessas cores definidas explicitamente.

Para desfazer o aplicativo de cores explícitas e permitir que o tema se aplique a essas cores explicitamente selecionadas, use Reverter para padrão na seção Cores de Dados do visual para o qual a cor foi definida explicitamente.

Situações em que as cores do tema do relatório não se mantêm nos seus relatórios

Suponha que você aplique um conjunto de cores personalizado ou uma cor individual a um ponto de dados em um visual usando a opção Cor personalizada no seletor de cores. Quando você aplica um tema de relatório, ele não substitui essa cor de ponto de dados personalizada.

Ou, suponha que você queira definir a cor de um ponto de dados usando a seção Cores do tema. Quando você aplica um novo tema de relatório, essas cores não são atualizadas. Para recuperar as cores padrão para que elas sejam atualizadas quando você aplicar um novo tema de relatório, selecione Redefinir para padrão ou selecione uma cor na paleta Cores do tema no seletor de cores.

Captura de tela do menu suspenso Visualizações, realçando Redefinir para padrão.

Muitos visuais do Power BI não se aplicam a temas de relatório.

Arquivos de tema de relatório personalizados que você pode usar agora

Quer começar com temas de relatórios? Consulte os temas de relatório personalizados na galeria de temas ou os seguintes arquivos JSON de tema de relatório personalizado prontos, que você pode baixar e importar para seu relatório do Power BI Desktop:

Tema da forma de onda. Este tema de relatório foi introduzido na postagem do blog que anunciou o primeiro lançamento de temas de relatório. Faça o download Waveform.json.
Tema amigável para daltônicos. O tema deste relatório é mais fácil de ler para os deficientes visuais. Faça o download ColorblindSafe-Longer.json.

Tema do Dia dos Namorados.

Captura de tela do tema JSON do Dia dos Namorados.

Aqui está o código para o arquivo JSON do Dia dos Namorados:

     {
         "name": "Valentine's Day",
         "dataColors": ["#990011", "#cc1144", "#ee7799", "#eebbcc", "#cc4477", "#cc5555", "#882222", "#A30E33"],
         "background":"#FFFFFF",
         "foreground": "#ee7799",
         "tableAccent": "#990011"
     }

Aqui estão mais alguns temas de relatório que você pode usar como pontos de partida:

Os temas de relatório podem tornar seus relatórios do Power BI Desktop um reflexo colorido de você, sua organização ou até mesmo da temporada ou feriado atual.

Mais fontes de temas de relatórios

O repositório GitHub a seguir tem JSON de exemplo para todos os diferentes componentes no arquivo de temas JSON: Modelos de Tema do Power BI.

Além disso, tente pesquisar por "Gerador de temas do Power BI" no Bing.

Exportar temas de relatório

Você pode exportar o tema de relatório atualmente aplicado diretamente do Power BI Desktop para um arquivo JSON. Depois de exportar um tema de relatório, você pode reutilizá-lo em outros relatórios. Essa opção permite exportar o arquivo JSON para a maioria dos temas internos. As únicas exceções são os temas base, Clássico e Padrão, que outros temas se baseiam quando importados.

Para exportar o tema atualmente aplicado do Power BI Desktop:

Selecione Exibir e selecione o menu suspenso Temas .
Na parte inferior do menu suspenso, selecione Salvar tema atual.
Na caixa de diálogo Salvar como, vá para um diretório no qual salvar o arquivo JSON e selecione Salvar.

Formato de arquivo JSON do tema do relatório

Em seu nível mais básico, o arquivo JSON tema tem apenas uma linha necessária: name.

{
    "name": "Custom Theme"
}

Além do name, todo o resto é opcional, o que significa que só pode adicionar as propriedades que pretende formatar especificamente ao ficheiro de tema. Você pode continuar a usar os padrões do Power BI para o resto.

Em um arquivo JSON de tema de relatório, você define apenas a formatação que deseja alterar. As configurações que você não especifica no arquivo JSON revertem para as configurações padrão do Power BI Desktop.

Ao criar um arquivo JSON, você pode especificar que todos os gráficos usem um tamanho de fonte de 12, que determinados elementos visuais usem uma família de fontes específica ou que os rótulos de dados sejam desativados para tipos de gráficos específicos. Usando um arquivo JSON, você pode criar um arquivo de tema de relatório que padroniza seus gráficos e relatórios, facilitando a consistência dos relatórios da sua organização.

Quando você importa seu arquivo de tema, o Power BI o valida para garantir que ele possa ler com êxito todo o conteúdo. Se o Power BI encontrar campos que não compreende, ele mostrará uma mensagem informando que o arquivo de tema é inválido e convidando você a reimportar com um arquivo de tema corrigido. O Power BI também publica o esquema que usa para verificar seu arquivo de tema em um local público, atualizando-o automaticamente sempre que o alteramos no Power BI, para que você possa garantir que seus arquivos de tema estejam sempre atualizados.

O Power BI valida temas personalizados com base em um esquema JSON. Esse esquema JSON está disponível para download para uso com um IDE que suporta validação JSON, que pode ajudar a identificar opções de formatação disponíveis e destacar formatação de tema inválida. Mais informações estão disponíveis no repositório do esquema JSON do tema do relatório.

Nota

Modificar um tema de relatório JSON personalizado na caixa de diálogo Personalizar tema é seguro. A caixa de diálogo não modifica as configurações do tema que não pode controlar e atualiza as alterações feitas no tema do relatório que está em vigor.

Um arquivo de tema tem quatro componentes principais:

Cores do tema
Cores estruturais
Classes de texto
Estilos visuais

As seções a seguir descrevem cada uma delas em detalhes.

Definir cores do tema

Em name, você pode adicionar as seguintes propriedades básicas relacionadas à cor dos dados:

dataColors: Esses códigos hexadecimais determinam a cor das formas que representam dados nos visuais do Power BI Desktop. Esta lista pode ter quantas cores quiser. Depois de todas as cores desta lista terem sido usadas, se o visual ainda precisar de mais cores, ele gira ligeiramente a paleta de cores do tema com ajuste de saturação/matiz e alterna várias vezes para gerar cores únicas sem repetição.
good, neutral, bad: Essas propriedades definem as cores de status usadas pelo gráfico de cascata e pelo visual do KPI.
maximum, center, minimum, null: Essas cores definem as várias cores de gradiente na caixa de diálogo de formatação condicional.

Um tema básico que define essas cores pode aparecer da seguinte maneira:

{
    "name": "Custom Theme",
    "dataColors": [
        "#118DFF",
        "#12239E",
        "#E66C37",
        "#6B007B",
        "#E044A7",
        "#744EC2",
        "#D9B300",
        "#D64550",
        "#197278",
        "#1AAB40"
    ],
    "good": "#1AAB40",
    "neutral": "#D9B300",
    "bad": "#D64554",
    "maximum": "#118DFF",
    "center": "#D9B300",
    "minimum": "#DEEFFF",
    "null": "#FF7F48"
}

Definir cores estruturais

Em seguida, você pode adicionar várias classes de cores, como background e firstLevelElements. Essas classes de cores definem as cores estruturais para elementos no relatório, como linhas de grade de eixo, cores de realce e cores de plano de fundo para elementos visuais.

A tabela a seguir mostra as seis classes de cores que você pode formatar. Os nomes da classe Color correspondem aos nomes na subseção "Avançado" da seção "Nome e cores" na caixa de diálogo Personalizar tema.

Nome preferido da classe de cor	Também chamado	O que formata
firstLevelElements	primeiro plano	Cor de fundo do rótulo (quando fora dos pontos de dados) Cor da linha de tendência Cor padrão da caixa de texto Valores de tabela e matriz e cores totais de fontes Cor do eixo das barras de dados Etiquetas de dados do cartão Cor do valor do texto explicativo do medidor Cor da meta do KPI Cor do texto KPI Cor do item de segmentação de dados (quando no modo de foco) Cor da fonte do item suspenso de segmentação de dados Cor da fonte de entrada numérica da segmentação de dados Cor da fonte do cabeçalho da segmentação de dados Cor da linha de proporção do gráfico de dispersão Cor da linha de previsão do gráfico de linhas Cor da linha líder do mapa Painel de filtro e cor do texto do cartão Texto de dicas de ferramentas visuais modernas e cor do ícone (Visualização)
secondLevelElements	primeiro planoNeutroSecundário	Aulas de texto secundário leve Cores da etiqueta Cor da etiqueta da legenda Cor da etiqueta do eixo Cor da fonte do cabeçalho da tabela e da matriz Medidor de destino e cor da linha líder de destino Cor do eixo de tendência KPI Cor do controle deslizante da segmentação de dados Cor da fonte do item de segmentação de dados Cor do contorno da segmentação de dados Cor do cursor do gráfico de linhas Cor do título do cartão de várias linhas Cor do traçado do gráfico da faixa de opções Cor da borda do mapa de formas Cor da fonte do texto do botão Cor da linha do ícone do botão Cor do contorno do botão
thirdLevelElements	luz de fundo	Cor da linha de grade do eixo Cor da tabela e da grelha matricial Cor de fundo do cabeçalho da segmentação de dados (quando no modo de foco) Cor do contorno do cartão de várias linhas Cor de preenchimento da forma Cor de fundo do arco do medidor Cor de fundo do cartão de filtro aplicada Cor de preenchimento do botão desativado (quando o plano de fundo é `FFFFFF`) Cor do contorno do botão desativado (quando o plano de fundo é `FFFFFF`)
fourthLevelElements	primeiro planoTerciário neutro	Legenda cor esmaecida Cor da etiqueta da categoria do cartão Cor das etiquetas de categoria de cartão de várias linhas Cor da barra de cartão de linha mulit Cor do traçado da taxa de conversão do gráfico de funil Cor da fonte do texto do botão desativado Cor da linha do ícone do botão desativado
Contexto geral		Cor do plano de fundo do rótulo (quando dentro de pontos de dados) Cor de fundo dos itens pendentes da segmentação de dados Cor do traçado do gráfico Donut Cor do traçado do mapa de árvore Cor de fundo do gráfico de combinação Cor de preenchimento do botão Painel de filtro e cor de fundo do cartão de filtro disponível Dicas de ferramentas visuais modernas cor de fundo (Pré-visualização)
secundárioAntecedentes	fundoNeutro	Cor do contorno da tabela e da grade da matriz Cor padrão do mapa de formas Cor de preenchimento da faixa de opções do gráfico da faixa de opções (quando a opção de correspondência de séries está desativada) Cor de preenchimento do botão desativado (quando a cor do plano de fundo não `FFFFFF`é). Cor do contorno do botão desativado (quando a cor do plano de fundo não `FFFFFF`é). Dicas de ferramentas visuais modernas, linha separadora e cor do foco (Visualização)
tableAccent [en]		Cor do contorno da tabela e da grade da matriz (quando presente).

Aqui está um tema de exemplo que define as classes de cores:

{
    "name": "Custom Theme",
    "firstLevelElements": "#252423",
    "secondLevelElements": "#605E5C",
    "thirdLevelElements": "#F3F2F1",
    "fourthLevelElements": "#B3B0AD",
    "background": "#FFFFFF",
    "secondaryBackground": "#C8C6C4",
    "tableAccent": "#118DFF"
}

Gorjeta

Se você usar um tema escuro ou outro tema colorido que divirja do estilo preto firstLevelElements sobre branco background típico, defina os valores para outras cores estruturais e as cores da classe de texto principal. Isso garante que os rótulos de dados em gráficos com um plano de fundo de rótulo correspondam ao estilo previsto, sejam legíveis e tenham linhas de grade de eixo visíveis.

Definir padrões de texto formatado

Em seguida, você pode adicionar classes de texto ao seu arquivo JSON. As classes de texto são semelhantes às classes de cores, mas permitem atualizar o tamanho da fonte, a cor e a família para grupos de texto no relatório.

Você só precisa definir quatro das 12 classes, chamadas classes primárias, para alterar toda a formatação de texto no relatório. Essas quatro classes principais podem ser definidas na caixa de diálogo Personalizar tema na seção Texto: Geral corresponde ao rótulo, Título ao título, Cartões e KPIs ao texto explicativo e Cabeçalhos de tabulação ao cabeçalho.

Outras classes de texto, consideradas classes secundárias, derivam automaticamente suas propriedades de suas classes primárias associadas. Muitas vezes, uma classe secundária seleciona um tom mais claro de cor de texto ou uma porcentagem maior ou menor tamanho de texto em comparação com a classe primária.

Tomemos a classe label como exemplo. A formatação padrão para a classe label é Segoe UI, #252423 (uma cor cinza escuro), com uma fonte de 12 pontos. Essa classe é usada para formatar os valores na tabela e na matriz. Normalmente, os totais em uma tabela ou matriz têm formatação semelhante, mas são colocados em negrito com a classe de rótulo em negrito para que se destaquem. No entanto, você não precisa especificar essa classe no tema JSON. O Power BI faz isso automaticamente. Se você decidir especificar rótulos que tenham uma fonte de 14 pontos em seu tema, não será necessário atualizar também a classe de rótulo em negrito porque ela herda a formatação de texto da classe de rótulo .

A tabela seguinte mostra:

Cada uma das quatro classes de texto primárias, o que formata e suas configurações padrão.
Cada classe secundária, o que ela formata e sua configuração padrão que é exclusiva em comparação com a classe primária.

Classe primária	Classes secundárias	Nome da classe JSON	Configurações padrão	Objetos visuais associados
Chamada	N/A	Texto explicativo	DIN #252423 45 pt	Etiquetas de dados do cartão Indicadores KPI
Cabeçalho	N/A	cabeçalho	Segoe UI Semibold #252423 12 pt	Principais cabeçalhos de influenciadores
Título		title	DIN #252423 12 pt	Título do eixo das categorias Título do eixo dos valores Título do cartão de várias linhas * Cabeçalho de segmentação de dados
-	Título grande	grandeTítulo	14 pt	Título visual
Etiqueta		etiqueta	Segoe UI #252423 10 pt	Cabeçalhos de colunas de tabela e matriz Cabeçalhos de linha de matriz Tabela e grelha matricial Valores de tabela e matriz
-	Semibold	semiboldLabel	Segoe UI Semibold	Texto do perfil dos principais influenciadores
-	Grande	grandeRótulo	12 pt	Etiquetas de dados de cartão de várias linhas
-	Pequena	pequenoLabel	9 pt	Rótulos de linha de referência * Rótulos de intervalo de datas da segmentação de dados Estilo de texto de entrada numérica da segmentação de dados Caixa de pesquisa da segmentação de dados Principais influenciadores texto influenciador
-	Claro	lightLabel [en]	#605E5C	Texto da legenda Botão de texto Rótulos do eixo da categoria Rótulos de dados do gráfico de funil Rótulos de taxa de conversão do gráfico de funil Alvo do medidor Rótulo da categoria do gráfico de dispersão Itens de segmentação de dados
-	Negrito	boldLabel	Segoe UI Ousado	Subtotais matriciais Totais gerais da matriz Totais da tabela
-	Grande e leve	grandeLightLabel	#605E5C 12 pt	Etiquetas de categoria de cartão Etiquetas de medidor Etiquetas de categoria de cartão de várias linhas
-	Pequeno e leve	pequenoLightLabel	#605E5C 9 pt	Etiquetas de dados Rótulos do eixo dos valores

* Os itens estrelados são baseados na primeira cor de dados do tema do relatório.

Você pode usar a bold configuração booleana para ajustar o formato. Para colocar o texto em negrito, use as seguintes configurações:

bold: verdadeiro
titleBold: verdadeiro

Gorjeta

As variações de luz das classes de texto tomam sua cor clara das cores estruturais definidas anteriormente. Se você estiver criando um dark theme, defina a cor (correspondente à cor do texto principal), secondLevelElements (correspondente à cor de luz prevista para o texto) e background (com contraste suficiente para as cores dos firstLevelElements elementos de primeiro e segundo nível).

Consulte o seguinte exemplo de tema que define apenas as classes de texto primárias:

{
    "name": "Custom Theme",
    "textClasses": {
        "callout": {
            "fontSize": 45,
            "fontFace": "DIN",
            "color": "#252423"
        },
        "title": {
            "fontSize": 12,
            "fontFace": "DIN",
            "color": "#252423"
        },
        "header": {
            "fontSize": 12,
            "fontFace": "Segoe UI Semibold",
            "color": "#252423"
        },
        "label": {
            "fontSize": 10,
            "fontFace": "Segoe UI",
            "color": "#252423"
        }
    }
}

Como as classes secundárias herdam das classes primárias, não é necessário defini-las no arquivo de tema. No entanto, se você não gostar das regras de herança (por exemplo, se não quiser totais em negrito), poderá formatar explicitamente as classes secundárias no arquivo de tema, assim como formatar as classes primárias.

Definir padrões de propriedade visual (`visualStyles`)

Para criar um arquivo JSON de formato estendido, com controle mais detalhado e granular sobre toda a formatação visual em um relatório, adicione uma visualStyles seção ao arquivo JSON para aninhar os detalhes de formatação. Veja o seguinte exemplo da visualStyles seção:

    "visualStyles": {
        "<visualName>": {
            "<styleName>": {
                "<cardName>": [{
                    "<propertyName>": <propertyValue>
                }]
            }
        }
    }

Para as visualName seções e cardName , use um nome visual e de cartão específico. Atualmente, o styleName é sempre um asterisco (*), mas em uma versão futura você poderá criar estilos diferentes para seus visuais e dar-lhes nomes (semelhante ao recurso de estilo de tabela e matriz). O propertyName é uma opção de formatação e propertyValue é o valor dessa opção de formatação.

Para visualName e cardName, use um asterisco entre aspas se quiser que essa configuração se aplique a todos os elementos visuais ou cartões que tenham uma propriedade. Se você usar um asterisco para os nomes visuais e de cartão, estará efetivamente aplicando uma configuração globalmente em seu relatório, como um tamanho de fonte ou uma família de fontes específica para todo o texto em todos os elementos visuais.

Veja o exemplo a seguir que define algumas propriedades através dos estilos visuais:

{
   "name":"Custom Theme",
   "visualStyles":{
      "*": {
         "*": {
            "*": [{
                "wordWrap": true
            }],
            "categoryAxis": [{
                "gridlineStyle": "dotted"
            }],
            "filterCard": [
              {
                "$id": "Applied",
                "foregroundColor": {"solid": {"color": "#252423" } }
              },
              {
                "$id":"Available",
                "border": true
              }
            ]
         }
      },
      "scatterChart": {
         "*": {
            "bubbles": [{
                  "bubbleSize": -10
            }]
         }
      }
   }
}

Este exemplo faz as seguintes configurações:

Ativa o word wrap em todos os lugares.
Define o estilo da linha de grade como pontilhado para todos os elementos visuais com um eixo de categorias.
Define alguma formatação para os cartões de filtro disponíveis e aplicados (observe o formato usando "$id" para definir as diferentes versões dos cartões de filtro).
Define o tamanho da bolha para gráficos de dispersão como -10.

Nota

Você só precisa especificar os elementos de formatação que deseja ajustar. Todos os elementos de formatação que não estão incluídos no arquivo JSON revertem para seus valores e configurações padrão.

Encontrar propriedades visuais para definir

O esquema de tema de relatório pode ajudá-lo a identificar quais propriedades estão disponíveis para estilizar com um tema de relatório. Usando o esquema como uma referência local em seu arquivo de tema, você pode usar a funcionalidade de preenchimento automático do IDE para identificar as opções de formatação disponíveis.

Por exemplo, usando o suporte do Visual Studio Code para o esquema JSON, podemos definir um tema da seguinte forma com "reportThemeSchema.json" baixado do repositório de esquema e colocado na mesma pasta:

{
    "name": "My custom theme",
    "$schema": "reportThemeSchema.json"
}

Com isso definido, você pode usar o preenchimento automático no Visual Studio Code para entender a estrutura e as opções de formatação disponíveis disponíveis. Acione o preenchimento automático explicitamente usando a combinação de teclas Ctrl + Space. O pop-up de descrição mostrará o nome para exibição e a descrição do item de formatação conforme eles mostram no painel Formatação, se disponível:

Captura de tela mostrando o uso do esquema de tema de relatório para identificar as opções de formatação disponíveis. O menu de preenchimento automático no Visual Studio Code mostra as opções de formatação disponíveis.

Dicas para definir valores

Aqui estão algumas dicas úteis sobre como definir valores.

Os booleanos são verdadeiros ou falsos.
As cadeias de caracteres devem estar entre aspas duplas, como em "this is a string".
Os números são apenas o valor em si, não entre aspas.
Quando você usa dateTimeo , a data deve ser uma data ISO entre aspas simples, com "datetime" no início. Veja o seguinte exemplo:

"datetime'2022-10-05T14:48:00.000Z'"
As cores que usam um código hexadecimal personalizado para substituir FFFFFF usam o seguinte formato. Valores hexadecimais de 3 ou 6 dígitos são aceitáveis:
```
{ "solid": { "color": "#FFFFFF" } }
```

Você pode usar uma enumeração para formatar menus suspensos definindo opções de menu para qualquer uma das opções no painel, por exemplo, RightCenter para posição da legenda ou Data value, percent of total para rótulo de dados de pizza. As enumerações são geralmente formatadas como cadeias de caracteres.

Exemplo de arquivo JSON de tema de relatório

Aqui está o arquivo St Patricks Day.json na íntegra:

   {
       "name": "St Patrick's Day",
       "dataColors": ["#568410", "#3A6108", "#70A322", "#915203", "#D79A12", "#bb7711", "#114400", "#aacc66"],
       "background":"#FFFFFF",
       "foreground": "#3A6108",
       "tableAccent": "#568410"
   }

Este arquivo JSON tema de relatório tem as seguintes linhas:

name: O nome do tema do relatório. Este campo é o único campo obrigatório.
dataColors: A lista de códigos hexadecimais coloridos a serem usados para dados em visuais do Power BI Desktop. Esta lista pode ter quantas ou quantas cores quiser.
background, foregrounde tableAccent: Classes de cores. As classes de cores permitem que você defina muitas cores estruturais em seu relatório de uma só vez.

Você pode copiar esse JSON e usá-lo como base para criar seu próprio arquivo de tema de relatório personalizado para importar. Se quiser ajustar apenas as cores básicas do relatório, altere o nome e os códigos hexadecimais no arquivo.

Considerações e limitações

Se você usar um dos temas originais, o tema Clássico ou um tema personalizado importado sobre um deles, a seção de texto da caixa de diálogo do tema não estará disponível para configuração.

Os temas incorporados afetados por esta limitação incluem os seguintes temas:
- Clássico
- Parque da cidade
- Sala de Aula
- Seguro para daltónicos
- Elétrico
- Contraste elevado
- Pôr-do-sol
- Crepúsculo
Se você usar um dos temas afetados e não precisar modificar as configurações de texto, poderá usar com segurança as outras guias da caixa de diálogo sem problemas. No entanto, se você quiser usar as classes de texto com um dos temas afetados, você tem as seguintes opções:
- A maneira mais rápida e fácil de habilitar as classes de texto é selecionar as opções de tema padrão.
- Se você quiser manter seu tema personalizado atual para habilitar a guia de texto:
1. Exporte seu tema atual.
2. Selecione o tema padrão.
3. Importe o tema personalizado exportado na primeira etapa.
O texto no relatório terá uma aparência diferente, mas você poderá acessar a guia de texto na caixa de diálogo do tema.
Os elementos considerados parte da interface não podem ser alterados usando um tema de relatório. Isso inclui os painéis Filtro, Formato e Dados e a matriz visual em cálculos visuais.

Partilhar via

Usar temas de relatório no Power BI Desktop

Formas de aplicar um tema de relatório

Aplicar um tema de relatório interno

Temas de relatório integrados

Personalizar temas de relatório

Personalizar e guardar um tema no Power BI Desktop

Atualizar o tema base

Importar arquivos de tema de relatório personalizados

Como as cores do tema do relatório permanecem com seus relatórios

Série dinâmica

Série estática

Situações em que as cores do tema do relatório não se mantêm nos seus relatórios

Arquivos de tema de relatório personalizados que você pode usar agora

Mais fontes de temas de relatórios

Exportar temas de relatório

Formato de arquivo JSON do tema do relatório

Definir cores do tema

Definir cores estruturais

Definir padrões de texto formatado

Definir padrões de propriedade visual (`visualStyles`)

Encontrar propriedades visuais para definir

Dicas para definir valores

Exemplo de arquivo JSON de tema de relatório

Considerações e limitações

Comentários

Recursos adicionais

Partilhar via

Usar temas de relatório no Power BI Desktop

Formas de aplicar um tema de relatório

Aplicar um tema de relatório interno

Temas de relatório integrados

Personalizar temas de relatório

Personalizar e guardar um tema no Power BI Desktop

Atualizar o tema base

Importar arquivos de tema de relatório personalizados

Como as cores do tema do relatório permanecem com seus relatórios

Série dinâmica

Série estática

Situações em que as cores do tema do relatório não se mantêm nos seus relatórios

Arquivos de tema de relatório personalizados que você pode usar agora

Mais fontes de temas de relatórios

Exportar temas de relatório

Formato de arquivo JSON do tema do relatório

Definir cores do tema

Definir cores estruturais

Definir padrões de texto formatado

Definir padrões de propriedade visual (visualStyles)

Encontrar propriedades visuais para definir

Dicas para definir valores

Exemplo de arquivo JSON de tema de relatório

Considerações e limitações

Comentários

Recursos adicionais

Definir padrões de propriedade visual (`visualStyles`)