Carregando e gerenciando extensões de visualização
Extensões adicionam recursos de visualização personalizados a aplicativos Qlik Cloud. Você pode carregar e gerenciar extensões no centro de atividades de Administração.
Usando extensões
Extensões de visualização no Qlik Cloud adicionam novos componentes visuais além das visualizações padrão. Use-as para personalizar como você apresenta e explora dados.
Para obter mais informações, consulte Qlik Developer: Estendendo o Qlik. Para obter uma demonstração visual, consulte Usando extensões de visualização de terceiros no Qlik Cloud e Extensões e chaves de API.
Funções necessárias
Para carregar e gerenciar extensões, você deve ter uma das seguintes funções:
-
Administrador de locatários
-
Administrador de análises
-
Função personalizada com a permissão Gerenciar extensões definida como Permitido
Requisitos e limites do arquivo
Siga estas regras para garantir que sua extensão seja carregada e funcione corretamente.
Limites de arquivo
Os arquivos ZIP de extensão 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
Arquivos base necessários para uma extensão
Certifique-se de que seu arquivo ZIP de extensão inclua os seguintes arquivos:
-
.qext: arquivo de metadados
-
.js: código JavaScript
-
.html: código de renderização HTML
-
.css: estilo personalizado
Regras de nomenclatura de arquivo
Cada arquivo na extensão 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.
Melhores práticas
-
Minimize seus arquivos de código.
-
Inclua apenas os arquivos necessários para a execução da sua extensão.
-
Analise a extensão e seu código antes de fazer o upload.
Recursos externos e CSP
Hospedar arquivos de imagem externamente
Não inclua arquivos de imagem (como GIF, PNG, JPG) no arquivo ZIP de extensão. Em vez disso, hospede as imagens externamente (por exemplo, em um servidor de aplicativos, um compartimento S3 ou um sistema público de gerenciamento de conteúdo) e faça referência a elas no código da sua extensão.
Referenciar código e conteúdo externos
Para referenciar código ou conteúdo externo em sua extensão, configure uma Content Security Policy do locatário (CSP) e adicione à lista de permissões as origens externas que sua extensão precisa acessar.
Se uma origem não estiver na lista de permissões, sua extensão não será renderizada.
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, as extensões 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'
Recursos não compatíveis
Os seguintes recursos não são compatíveis:
-
Extensões agrupadas: arquivos ZIP contendo outros arquivos ZIP de extensão não são suportados.
-
Arquivos QVF e QVD: esses arquivos não são acessíveis pelo serviço de extensão.
Para carregar arquivos QVF ou QVD, use um dos seguintes métodos:
-
Carregue um aplicativo na página Criar do centro de atividades do Análises.
-
Carregue um aplicativo usando qlik-cli.
-
Carregue um QVD na página Criar do centro de atividades do Análises.
-
Carregue um QVD usando o Qlik DataTransfer.
Gerenciando extensões
Extensões são gerenciadas na página Extensões do centro de atividades de Administração.
Informações da tabela de extensões
-
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 da extensão
-
Status: status da migração (temporário)
Sobre o status da migração
A Qlik está melhorando a forma como a plataforma lida com extensões. Durante essa transição, as extensões existentes são movidas 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 extensão que você carregar ou acessar usará o novo serviço automaticamente. Se sua extensão estiver em uso regular, nenhuma ação será necessária.
A maioria das extensões migra automaticamente quando são usadas. Extensões que você não usou recentemente podem precisar ser adicionadas manualmente à fila para serem incluídas em uma migração agendada. Para proteger o conteúdo de propriedade do cliente, a Qlik não migra extensões, a menos que elas sejam acessadas ou que você confirme a migração. Se você quiser manter uma extensão não utilizada (status Não migrada) disponível, você pode migrá-la manualmente.
Valores de status de migração:
-
Não migrada: a extensão não foi migrada.
-
Na fila para migração: a extensão foi enfileirada e será migrada durante a próxima execução de migração agendada.
-
Migração em andamento: a extensão está sendo migrada no momento.
-
Migrado: a extensão foi migrada com sucesso.
A migração também se aplica a temas. Para obter detalhes, consulte Carregando e gerenciando temas.
Adicionando extensões
Faça o seguinte:
- No centro de atividades de Administração, vá para Extensões.
-
Clique em Adicionar.
-
Clique em Procurar para selecionar um arquivo de extensão ou solte um arquivo na área designada.
-
Opcionalmente, adicione tags.
-
Clique em Publicar.
Editando extensões
Faça o seguinte:
- No centro de atividades de Administração, vá para Extensões.
-
Na extensão que você deseja editar, clique em
e selecione Editar. -
Use o painel de edição para substituir a extensão ou atualizar as tags.
-
Salve suas alterações.
Baixando extensões
Use isso para fazer backup de uma extensão antes de editá-la ou para movê-la para outro locatário.
Faça o seguinte:
- No centro de atividades de Administração, vá para Extensões.
-
Na extensão que você deseja baixar, clique em
e selecione Baixar. -
Salve o arquivo ZIP.
Migrando extensões
Use as etapas a seguir para migrar extensões com status Não migrado.
Faça o seguinte:
- No centro de atividades de Administração, vá para Extensões.
-
Na extensão 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, Migrada.
Excluindo extensões
A exclusão de extensões pode afetar todos os recursos, afetando todos os usuários do locatário.
Faça o seguinte:
- No centro de atividades de Administração, vá para Extensões.
- Selecione as extensões que você deseja excluir.
- Clique em Excluir.