Ir para conteúdo principal Pular para conteúdo complementar
Recursos da Qlik

Gerenciando extensões

As extensões ampliam a funcionalidade da plataforma analítica do Qlik Cloud, permitindo visualizações personalizadas para aplicativos do Qlik Sense. Você pode carregar e editar extensões do centro de atividades de Administração.

Nota governamental do Qlik CloudExtensões de terceiros não têm suporte no Qlik Cloud Government. No entanto, o uso de extensões de terceiros pode precisar ser definido e aprovado como parte de uma Autoridade de Agência para Operar, dependendo dos requisitos de segurança e conformidade que sua organização segue.

Diretrizes para criar e carregar extensões

Siga estas orientações ao criar e carregar extensões de visualização para o Qlik Cloud.

Para obter uma demonstração visual sobre como adicionar e usar extensões, consulte Usando extensões de visualização de terceiros no Qlik Cloud e Extensões e chaves de API.

Limites de arquivo ZIP para extensões

  • Tamanho máximo de arquivo ZIP: 30 MB

  • Tamanho máximo de arquivos em ZIP: 30 MB

  • Número máximo de arquivos em ZIP: 500

  • Tamanho máximo total descompactado de arquivos em ZIP: 100 MB

Melhores práticas

  • Minimize seus arquivos de código.

  • Inclua apenas os arquivos necessários. Certifique-se de que o arquivo ZIP contenha apenas os arquivos necessários para que sua extensão funcione corretamente.

  • Revise as extensões e seus códigos antes de fazer o upload. Para obter mais informações, consulte Extensões de visualização (somente em inglês).

Arquivos base necessários para uma extensão

Certifique-se de que seu arquivo ZIP de extensão inclua os seguintes arquivos essenciais:

  • .qext: arquivo de metadados de extensão

  • .js: código JavaScript para a extensão

  • .html: código HTML para renderizar a extensão

  • .css: CSS personalizada para definir o estilo da extensão

Host externo de arquivos de imagem

Não carregue arquivos de imagem (por exemplo, GIF, PNG, JPG) dentro do arquivo ZIP de extensão. Em vez disso, hospede-os externamente em um servidor de aplicativo pessoal, um bucket S3 ou um sistema de gerenciamento de conteúdo público. Faça referência a essas imagens externas em seu código de extensão.

Fazendo referência a arquivos de código e conteúdo externos

Você pode fazer referência a arquivos de código e conteúdo em seu código de extensão principal, mas isso requer a implementação de uma Content Security Policy (CSP) no locatário. Para obter mais informações, consulte Gerenciando o Content Security Policy.

Se sua extensão fizer solicitações a recursos externos, essas origens de recursos devem ser permitidas na CSP, ou a extensão será bloqueada da renderização.

Recursos não compatíveis

Os seguintes recursos não são compatíveis:

Extensões agrupadas

O Qlik Cloud não oferece suporte a arquivos ZIP que contenham outros arquivos ZIP de extensão.

Arquivos QVF e QVD

Não inclua arquivos Qlik Sense QVF ou QVD no arquivo de extensão ZIP, pois esses não são acessíveis pelo serviço de extensão. Remova esses arquivos antes de fazer upload da extensão.

Para fazer upload de um arquivo QVF ou QVD no Qlik Cloud do Qlik Cloud, use um dos seguintes métodos:

  • Carregue um aplicativo na página Criar do Análises do Analytics.

  • Carregue um aplicativo usando o qlik-cli.

  • Carregue um QVD na página Criar do centro de atividades do Análises.

  • Fazer upload de um QVD usando o Qlik DataTransfer.

Formatos de arquivo não compatíveis

Por motivos de segurança, as extensões não podem conter arquivos com tipos MIME não permitidos. Os tipos MIME (Multipurpose Internet Mail Extensions) são uma forma padrão de indicar a natureza e o formato de um arquivo. O upload falhará se sua extensão contiver, por exemplo, um arquivo executável ou um arquivo ZIP.

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'

Todos os arquivos em uma extensão devem ter um nome de arquivo e uma extensão de arquivo. Os arquivos que não estiverem em conformidade serão ignorados. Exemplos de arquivos ignorados incluem .gitignore e README.

Adicionando e gerenciando extensões

Extensões são gerenciadas na página Extensões do centro de atividades de Administração.

Na tabela Extensões:

  • Nome refere-se ao nome dos metadados no arquivo QEXT.

  • Versão QEXT indica a versão dos metadados no arquivo QEXT.

  • Nome do arquivo QEXT é o Identificador exclusivo e o nome do arquivo de definição de extensão.

Você pode filtrar as extensões por tags.

Adicionando uma nova extensão

Faça o seguinte:

  1. No centro de atividades de Administração, vá para Extensões.

  2. Clique em Adicionar.

  3. Clique em Procurar para selecionar um arquivo de extensão ou solte um arquivo na área designada.

  4. Opcionalmente, adicione tags.

  5. Clique em Publicar.

Nota informativaVocê não pode carregar uma extensão com o mesmo nome de arquivo QEXT que um existente.

Editando uma extensão

Faça o seguinte:

  1. No centro de atividades de Administração, vá para Extensões.

  2. Na extensão que você deseja editar, clique em Mais e selecione Editar.

    O painel de edição é exibido com opções para substituir a extensão existente e adicionar ou remover tags.

  3. Salve suas alterações.

Excluindo uma extensão

A exclusão de extensões pode afetar todos os recursos, afetando todos os usuários do locatário.

Faça o seguinte:

  1. No centro de atividades de Administração, vá para Extensões.
  2. Selecione as extensões que você deseja excluir.
  3. Clique em Excluir.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui