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)
-
Arquivos de metadados QEXT
-
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'
- 'application/x-sharedlib'
- '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 da migração (temporário)
Sobre o status da migração
A Qlik está melhorando a forma como a plataforma lida com temas. Durante essa transição, os temas existentes são movidos para um novo serviço. A coluna de status da migração é temporária e aparece apenas enquanto este trabalho está em andamento.
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 maioria dos temas migra automaticamente quando são usados. Temas que você não usou recentemente podem precisar ser adicionados manualmente à fila para serem incluídos em uma migração agendada. Para proteger o conteúdo de propriedade do cliente, a Qlik não migra temas, a menos que eles sejam acessados ou que você confirme a migração. Se você quiser manter um tema não utilizado (status Não migrado) disponível, você pode migrá-lo 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.
Migrando temas
Use as etapas a seguir para migrar temas com status Não migrado.
Faça o seguinte:
- No centro de atividades de Administração, vá para Temas.
-
No tema que você deseja migrar, clique em
e selecione Migrar.
O status é atualizado à medida que a migração avança: Na fila para migração, Migração em andamento e, finalmente, Migrado.
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.