Partilhar via


Usar temas de relatório no Power BI Desktop

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.

Screenshot of the Themes dropdown menu.

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:

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.

  1. No friso Ver, selecione a seta pendente junto a Temas .

  2. Selecione entre os temas no menu suspenso exibido, incluindo os novos temas acessíveis.

    Screenshot of the Power BI themes dropdown menu, highlighting all of the selections.

    O tema do relatório agora é aplicado ao relatório.

  3. 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.

    Screenshot of the Power BI Themes dropdown menu, highlighting Theme gallery.

    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.

    Screenshot of the successful Import theme dialog.

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 Diagram of the color sequence for the Default theme.
Arranha-céus Diagram of the color sequence for the Highrise theme.
Executivo Diagram of the color sequence for the Executive theme.
Fronteira Diagram of the color sequence for the Frontier theme.
Inove Diagram of the color sequence for the Innovate theme.
Em flor Diagram of the color sequence for the Bloom theme.
Marés Diagram of the color sequence for the Tidal theme.
Temperatura Diagram of the color sequence for the Temperature theme.
Solar Diagram of the color sequence for the Solar theme.
Divergente Diagram of the color sequence for the Divergent theme.
Storm Diagram of the color sequence for the Storm theme.
Clássico Diagram of the color sequence for the Classic theme.
Parque da cidade Diagram of the color sequence for the City park theme.
Sala de Aula Diagram of the color sequence for the Classroom theme.
Cofre para daltónicos Diagram of the color sequence for the Color blind safe theme.
Elétrico Diagram of the color sequence for the Electric theme.
Alto contraste Diagram of the color sequence for the High contrast theme.
Pôr-do-sol Diagram of the color sequence for the Sunset theme.
Crepúsculo Diagram of the color sequence for the Twilight theme.
Padrão acessível Diagram of the color sequence for the Accessible default theme.
Parque da cidade acessível Diagram of the color sequence for the Accessible city park theme.
Maré acessível Diagram of the color sequence for the Accessible tidal theme.
Neutro acessível Diagram of the color sequence for the Accessible neutral theme.
Orquídea acessível Diagram of the color sequence for the Accessible orchid theme.

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

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:

  1. Na faixa de opções Exibir, selecione o botão suspenso Temas e selecione Personalizar tema atual.

    Screenshot of the Power BI Themes dropdown menu, highlighting Customize current theme.

  2. É 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.

    Screenshot of the Customize theme dialog.

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

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.

Screenshot showing the Update theme option.

Importar arquivos de tema de relatório personalizados

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

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

    Screenshot of the Power BI Themes dropdown menu, highlighting Browse for themes.

    Aparece uma janela que você pode usar para ir para o arquivo de tema JSON.

  2. Na imagem a seguir, você pode ver os arquivos de tema de férias. Veja a seleção de exemplo de um tema de feriado para março, St Patricks Day.json.

    Screenshot of the dialog listing Holiday theme JSON files.

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

    Screenshot of the Import theme successful dialog.

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:

  1. Selecione a tela de relatório ou um dos elementos visuais na tela.

  2. Na seção Formato do painel Visualização, selecione Cor.

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

    Screenshot of the Theme colors palette with default selections.

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.

Screenshot of the Visualizations dropdown menu, highlighting Reset to default.

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. Baixar Waveform.json.

    Screenshot that shows the Waveform JSON theme.

  • Tema amigável para daltônicos. O tema deste relatório é mais fácil de ler para os deficientes visuais. Baixar ColorblindSafe-Longer.json.

    Screenshot of the Color-blind Safe Longer JSON theme.

  • Tema do Dia dos Namorados.

    Screenshot of the Valentine's Day JSON theme.

    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:

  1. Selecione Exibir e selecione o menu suspenso Temas .

    Screenshot of the Themes dropdown menu, highlighting Save current theme.

  2. Na parte inferior do menu suspenso, selecione Salvar tema atual.

  3. 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:

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, , , centerminimumnull: 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
Cargo cargo 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
Label 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 (com contraste suficiente para as cores dos firstLevelElements elementos de primeiro e background 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 , use um nome visual e cardName 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:

Screenshot of using the report theme schema to identify available formatting options. The autocomplete menu within Visual Studio Code shows available formatting options.

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 em sua totalidade:

   {
       "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
  • Alto contraste
  • 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.