Temas personalizados no LuckyTemplates

Para a postagem de hoje, farei uma revisão rápida das personalizações que você pode fazer editando e aplicando diretamente um arquivo de tema JSON. Na verdade, essa não é uma descrição do que pode ser feito dentro do próprio LuckyTemplates, mas sim um exemplo do que pode ser feito fora do LuckyTemplates quando você cria temas personalizados. Você pode assistir ao vídeo completo deste tutorial na parte inferior deste blog.

Este tópico não se destina a consumidores de relatórios do LuckyTemplates ou desenvolvedores casuais do LuckyTemplates, mas sim para aqueles familiarizados e confortáveis ​​com a edição e criação de códigos JSON diretamente.

Para implementar temas personalizados, você precisa estar familiarizado com a sintaxe e a estrutura dos arquivos JSON e também com as ferramentas do ambiente de desenvolvimento. Usarei o código do Visual Studio para desenvolver arquivos de tema JSON.

Vamos dar uma olhada nas personalizações disponíveis que já estão incorporadas ao aplicativo de desktop do LuckyTemplates. Primeiro, precisamos de uma tela para mostrar nosso trabalho. Eu usei o conjunto de dados de prática LuckyTemplates, que é um conjunto de dados de vendas simples onde os visuais podem ser facilmente construídos. Um arquivo PBIX de demonstração é uma única página de relatório e as dimensões personalizadas de 1600 x 900 foram usadas para fornecer um pouco mais de espaço do que o relatório padrão de 1280 x 720.

Índice

• Usando o tema padrão
• Uma revisão rápida dos fundamentos do JSON para temas personalizados
• Mudando o plano de fundo para temas personalizados
• Mudando o fundo do texto do título
• Adicionando sombras aos visuais
• Adicionando Texto do Título
• Outras coisas a serem lembradas em temas personalizados
• Conclusão

Usando o tema padrão

Vamos dar uma olhada no nosso tema padrão aqui. Se procurarmos temas e aplicarmos o tema padrão…

… podemos ver que ele está usando apenas as cores padrão azul, laranja e roxo.

E se eu selecionar o tema White Text on Dark Background …

… este é o tema que veremos.

Uma revisão rápida dos fundamentos do JSON para temas personalizados

Definitivamente, esta não é uma revisão abrangente sobre como desenvolver um arquivo JSON para LuckyTemplates, mas sim alguns comentários rápidos sobre arquivos JSON.

JSON significa JavaScript Object Notation ; este é um formato de texto simples para arquivos de dados, consistindo em objetos aninhados ou blocos de código. Cada um deles tem sua própria coleção de pares nome-valor.

Dois pontos são usados ​​para separar pares nome-valor. Chaves são usadas para cercar um objeto. Os elementos da lista são separados por vírgulas e as listas podem ser apagadas. Uma lista também pode ser um array, que neste caso está entre colchetes.

Um arquivo JSON do LuckyTemplates geralmente consiste em três seções principais: name , colors e visuals . A seção de nomes é, na verdade, a única seção obrigatória e, como você pode ver, é aqui que começaremos nossa investigação hoje.

Vamos apenas aplicar este arquivo de tema procurando por temas.

Iremos para o tema padrão. Você verá que as cores padrão são usadas.

Vamos para a seção do bloco de código e copie o conjunto de cores alternativas.

Podemos colá-lo em nosso arquivo de tema JSON adicionando uma vírgula após o bloco de nome e colando o código.

Salvaremos o arquivo de tema JSON, voltaremos ao LuckyTemplates e aplicaremos o tema de rascunho.

Agora, podemos ver que as cores mudaram.

A seção visual é de longe a maior, e é aqui que fazemos o resto do nosso trabalho. Você pode alterar o texto facilmente, incluindo a fonte, o tamanho da família e a cor.

Vamos para o nosso bloco de notas para copiar o bloco de código para nossas classes de texto e fontes definidas para tamanhos diferentes.

Em seguida, passaremos para o Visual Studio Code, adicionaremos uma coluna para separar os códigos e colaremos o código.

Mais uma vez, salvaremos nosso arquivo de tema. Em seguida, voltaremos ao LuckyTemplates e aplicaremos os arquivos do tema. Podemos ver que todos os textos agora ficaram azuis.

Uma das coisas que podemos fazer facilmente é alterar a cor do texto. Vamos voltar ao arquivo JSON novamente, selecionar a cor azul e substituí-la por vermelho.

Vamos salvar isso novamente, voltar ao LuckyTemplates e importar o arquivo de tema JSON mais uma vez. Agora, podemos ver que todos os textos mudaram para vermelho.

Mudando o plano de fundo para temas personalizados

Agora vamos olhar para o plano de fundo da página e defini-lo com a segunda cor mais escura em nossa paleta. Iremos para o Notepad++, pegaremos nosso bloco de código de plano de fundo da página e o copiaremos.

Em seguida, iremos para o Visual Studio Code e colaremos o código lá.

Em seguida, vá para o LuckyTemplates e, mais uma vez, aplique o tema de rascunho para ver o novo plano de fundo.

Mudando o fundo do texto do título

Vamos concluir nossa demonstração alterando o plano de fundo do texto do título para a cor mais escura do tema e a cor do texto para branco. Como você pode ver, não descobri a sintaxe adequada para definir o estilo da tabela e da matriz por meio do arquivo de tema JSON. Então, usei a interface para alterar o estilo de ambos os visuais para nenhum .

Vamos voltar ao Notepad++ para copiar o bloco de código JSON para o plano de fundo do título.

E então vamos ao Visual Studio Code para colar o código lá.

Novamente, salvaremos nosso tema, voltaremos ao LuckyTemplates e aplicaremos o tema mais uma vez.

Adicionando sombras aos visuais

Também tenho algumas pequenas demonstrações independentes que mostram algumas opções de tema. Vamos redefinir nosso tema de volta para a opção padrão. Se quisermos adicionar sombras a todos os nossos visuais, podemos usar visualStyles e a sintaxe dropShadow.

Se formos para o LuckyTemplates e aplicarmos esse arquivo de tema, você verá que todos os nossos visuais têm sombras.

Adicionando Texto do Título

Se quisermos garantir que todos os nossos visuais tenham texto de título, podemos adicionar algum texto de título de espaço reservado usando visualStyles, title, show e sintaxe de texto no Visual Studio Code.

Se formos ao LuckyTemplates e aplicarmos esse arquivo de tema, veremos que apenas um de nossos visuais foi alterado porque todos os demais já estão modificados com títulos.

Se quisermos ir para uma nova página, criar uma nova tabela e trazer os canais e medidas que desejamos, temos o texto do título padrão.

Outra coisa que podemos fazer é afetar a maneira como as novas imagens são dimensionadas para seu contêiner. Se redefinirmos para o tema padrão e inserirmos uma imagem, veremos que ela mantém sua proporção.

Se quisermos usar um arquivo de tema para definir a escala da imagem, podemos usar a sintaxe visualStyles, image, imageScaling e image ScalingType.

Se mudarmos para o LuckyTemplates e adicionarmos esse tema, veremos que a proporção agora pode ser alterada para o visual existente.

E se adicionarmos novos visuais, podemos ver novamente que o dimensionamento agora está definido para caber.

Outras coisas a serem lembradas em temas personalizados

A configuração de transparência do plano de fundo da página no arquivo JSON não parece ser levada em consideração, então usei a interface para definir o nível de transparência do plano de fundo da página como 0 antes do início da demonstração.

As configurações de estilo de tabela e matriz também não parecem ser levadas em consideração. Então, usei a interface para definir o estilo da tabela e da matriz como nenhum.

A ordem parece ser importante nos arquivos de tema JSON, portanto, se você achar que uma configuração específica não está sendo levada em consideração, tente reordenar a configuração de interesse superior ou anterior no código.

Os visuais existentes podem não responder totalmente aos arquivos de tema, especialmente se eles tiverem configurações de formato já aplicadas.

Criando temas, logotipos de empresas, ícones e planos de fundo
Como selecionar o tema de cores do LuckyTemplates para seus relatórios
Como criar uma paleta de cores atraente do LuckyTemplates

Conclusão

Se você é um neófito relativo em codificação JSON, especialmente em LuckyTemplates, considere todos os exemplos que usei com cautela. Espero que os mais experientes e familiarizados com a codificação de temas JSON no LuckyTemplates produzam um código muito melhor e mais legível.

Por fim, gostaria apenas de compartilhar algumas de minhas experiências iniciais e mostrar algumas das personalizações que encontrei em temas personalizados. Há uma infinidade de configurações disponíveis para temas LuckyTemplates JSON, e aqueles que estão dispostos a investir tempo e esforço para pesquisar os recursos online disponíveis podem desenvolver iterativamente arquivos de temas úteis.

Um excelente ponto de partida é a guia de propriedades do gerador de temas avançado do PowerBI.tips, onde você pode usar a interface do usuário para gerar arquivos de temas JSON para todos ou para tipos visuais específicos. Felizmente, você pode adicionar codificação de tema JSON personalizada à sua caixa de ferramentas do LuckyTemplates e isso pode ajudar a padronizar seus relatórios e economizar algum trabalho no futuro.

grego