Carregando e gerenciando temas
Adicione temas personalizados, incluindo cores e fundos com base nos padrões da sua empresa para estilizar seus aplicativos. Você pode carregar e gerenciar temas no centro de atividades de Administração.
O que você pode personalizar
Com os temas personalizados, você pode estilizar um aplicativo com precisão:
-
Alterando as cores.
-
Adicionando imagens e planos de fundo.
-
Especificando os tamanhos e cores das fontes globalmente ou em um nível granular.
-
Definindo paletas de cores.
-
Personalizando margens, preenchimento e espaçamento.
Para obter informações sobre como criar seus próprios temas para aplicativos, consulte Qlik Developer: Temas personalizados. Para obter informações sobre aplicativos de estilização, consulte Estilizando um aplicativo.
Funções necessárias
Para carregar e gerenciar temas, você deve ter uma das seguintes funções:
-
Administrador de locatários
-
Administrador de análises
-
Função personalizada com a permissão Gerenciar temas definida como Permitido.
Requisitos e limites do arquivo
Siga estas regras para garantir que seu tema seja carregado e funcione corretamente.
Formatos de arquivo não suportados
Os temas aceitam apenas os seguintes formatos de arquivo:
-
Arquivos HTML
-
Arquivos CSS
-
Arquivos JSON
-
Imagens (PNG, JPEG, GIF e SVG)
-
QEXTArquivos de metadados
-
Arquivos de fontes
Regras de nomenclatura de arquivo
Cada arquivo no tema deve ter um nome e uma extensão. Os arquivos que não estiverem em conformidade serão ignorados. Exemplos de arquivos ignorados incluem .gitignore e README.
Limites de tamanho e contagem de arquivos
Os arquivos ZIP de tema têm estes limites:
-
Tamanho máximo de arquivo ZIP: 30 MB
-
Tamanho máximo para qualquer arquivo individual no ZIP: 30 MB
-
Número máximo de arquivos no arquivo ZIP: 500
-
Tamanho total máximo não compactado: 100 MB
Recursos externos e CSP
Se os seus temas incluírem links para recursos externos, as origens desses recursos deverão ser adicionadas à lista de permissões na Content Security Policy (CSP). Para obter mais informações, consulte Gerenciando a Política de segurança de conteúdo (CSP).
Formatos de arquivo não compatíveis
Por motivos de segurança, os temas não podem incluir arquivos com tipos MIME não permitidos. Os tipos MIME (Multipurpose Internet Mail Extensions) indicam o formato de um arquivo. Se a sua extensão contiver um tipo MIME não permitido (por exemplo, um arquivo executável ou um arquivo ZIP), o upload falhará.
Os seguintes tipos MIME não são permitidos:
- 'application/octet-stream'
- 'application/x-coredump'
- 'application/x-dosexec'
- 'application/x-executable'
- 'application/x-java-applet'
- 'application/x-object'
- 'aplicativo/x-biblioteca-compartilhada'
- 'application/zip'
- 'text/x-shellscript'
- 'text/x-awk'
- 'text/x-gawk'
- 'text/x-msdos-batch'
- 'text/x-nawk'
- 'text/x-php'
Gerenciando temas
Os temas são gerenciados na página Temas do centro de atividades de Administração.
Informações da tabela de temas
-
Nome: nome dos metadados no arquivo QEXT
-
Versão do QEXT: versão dos metadados
-
Nome do arquivo QEXT: identificador único para o arquivo de definição do tema
-
Status: Status do recurso durante a migração
Sobre o status da migração
A Qlik está melhorando a forma como a plataforma lida com temas. Durante essa transição, alguns temas existentes foram movidos para um novo serviço.
-
A partir de 2025-11-17, qualquer tema que você carregar ou acessar usará o novo serviço automaticamente. Se seu tema estiver em uso regular, nenhuma ação será necessária.
-
A partir de 2026-06-30, os temas que ainda estavam armazenados apenas no armazenamento legado são marcados como Não migrado. Você não pode mais migrar esses temas. Você não pode mais migrar esses temas manualmente.
Valores de status de migração:
-
Não migrado: o tema não foi migrado.
-
Na fila para migração: o tema foi enfileirado e será migrado durante a próxima execução de migração agendada.
-
Migração em andamento: o tema está sendo migrado no momento.
-
Migrado: o tema foi migrado com sucesso.
A migração também se aplica a extensões. Para obter detalhes, consulte Carregando e gerenciando extensões de visualização.
Adicionando temas
Faça o seguinte:
- No centro de atividades de Administração, vá para Temas.
- Clique em Adicionar.
-
Clique em Procurar para selecionar um arquivo de tema ou solte um arquivo na área designada.
-
Opcionalmente, adicione tags.
-
Clique em Publicar.
Editando temas
Faça o seguinte:
- No centro de atividades de Administração, vá para Temas.
-
No tema que você deseja editar, clique em
e selecione Editar.
-
Use o painel de edição para substituir o tema ou atualizar as tags.
-
Salve suas alterações.
Baixando temas
Use isso para fazer backup de um tema antes de editá-lo ou para movê-lo para outro locatário.
Faça o seguinte:
- No centro de atividades de Administração, vá para Temas.
-
No tema que você deseja baixar, clique em
e selecione Baixar.
-
Salve o arquivo ZIP.
Excluindo temas
A exclusão de temas pode impactar todos os recursos, afetando todos os usuários dentro do locatário.
Faça o seguinte:
- No centro de atividades de Administração, vá para Temas.
- Selecione os temas que você deseja excluir.
- Clique em Excluir.