Dados e recarregamento
Última atualização: 14/10/2026O QV2QS converte a interface de usuário do QlikView e pode carregar dados automaticamente no aplicativo convertido usando a opção Auto-binary. Habilite Reload e Auto-binary no assistente ou na linha de comando, e o QV2QS gerencia a transferência de dados automaticamente. Se o Auto-binary não for usado, o aplicativo convertido deve ser recarregado separadamente para preencher os dados.
O QV2QS converte os metadados da interface do usuário do QlikView (PRJ XML) em JSON do Qlik Sense e cria o aplicativo diretamente no locatário do Qlik Cloud. O processo de conversão lida com layouts de pasta, objetos de visualização, expressões e estilização. Sem uma recarga, o aplicativo Qlik Sense resultante não contém dados após a conclusão da etapa de compilação.
Para preencher dados no aplicativo convertido, o aplicativo deve ser recarregado. Há três abordagens:
- Carga binária automática — O QV2QS faz o upload do arquivo QVW original para o Qlik Cloud e usa uma instrução
Binarypara carregar os dados durante a compilação. Essa abordagem é a maneira mais rápida de ver um aplicativo funcionando com dados imediatamente após a conversão. Para obter detalhes, consulte Carga binária automática abaixo. - Recarregamento manual — Se conexões de dados já tiverem sido criadas no Qlik Cloud e os arquivos QVD ou fontes de dados estiverem acessíveis, o aplicativo poderá ser recarregado após o ajuste do script de carregamento. O QV2QS aplica normalização básica de caminho de script de carregamento, mas os nomes de conexão e os caminhos de fonte de dados podem exigir atualizações manuais.
- Recarregamento acionado — Use a flag
--reloadpara acionar um recarregamento como parte da implementação. A recarga executa o script de carregamento como está. A recarga só é bem-sucedida se as conexões de dados e as fontes de dados referenciadas no script de carregamento já estiverem disponíveis no ambiente do Qlik Cloud.
Duas flags controlam os dados em diferentes etapas. A flag --noData ignora dados durante a etapa de compilação para que a estrutura do aplicativo possa ser testada sem aguardar um recarregamento. A flag --exportQvfNoData exporta o QVF sem dados após a conclusão do build, gerando um arquivo menor para compartilhamento. As flags podem ser usadas de forma independente ou em conjunto.
Carga binária automática
A carga binária automática faz o upload do arquivo QVW original para o Qlik Cloud, usa uma instrução Binary para carregar os dados no aplicativo convertido e, em seguida, remove o arquivo carregado. O aplicativo convertido recebe os mesmos dados que o QlikView original sem exigir configuração manual de conexão de dados.
Para habilitar a carga binária automática, use --autoBinary na linha de comando ou habilite Auto-binary na interface do usuário.
O QV2QS executa as seguintes etapas quando a carga binária automática está habilitada:
- Faça upload do arquivo QVW para o Qlik Cloud como um aplicativo temporário.
- Adicione uma instrução
Binary [<appId>];e uma instruçãoExit Script;ao início do script de carregamento do aplicativo convertido. - Crie o aplicativo (e recarregue se
--reloadfor especificado), que carrega dados do QVW enviado. - Excluir o aplicativo temporário carregado do Qlik Cloud.
- Restaure o script de carregamento original no aplicativo Qlik Cloud, removendo as instruções Binary e Exit Script.
Após a limpeza, o aplicativo Qlik Cloud contém os dados carregados, mas o script de carregamento não faz mais referência ao aplicativo temporário.
A etapa de upload está sujeita aos limites de tamanho de arquivo do Qlik Cloud. Arquivos QVW grandes podem exceder o limite de upload para o nível de assinatura do locatário. Se o upload falhar, implemente o aplicativo em um espaço com suporte a aplicativos grandes habilitado ou use o argumento --binaryAppId para fazer referência a um aplicativo existente já no Qlik Cloud. Para obter detalhes sobre os limites de recursos do locatário, consulte Limites de recursos do Qlik Cloud.
Limpeza em caso de falha
Se a etapa de build ou recarga falhar após o arquivo QVW ter sido carregado, o QV2QS tenta automaticamente fazer a limpeza antes de sair. A limpeza inclui excluir o aplicativo temporário carregado do Qlik Cloud e restaurar o script de carregamento original tanto localmente quanto no aplicativo do Cloud.
Se a própria limpeza falhar (por exemplo, devido a uma interrupção de rede), o aplicativo temporário poderá permanecer no locatário do Qlik Cloud. Aplicativos temporários órfãos são nomeados como QV2QS_Binary_YYYYMMDD_HHMMSS (por exemplo, QV2QS_Binary_20260219_143025). Verifique o espaço de destino quanto a aplicativos correspondentes a esse padrão e exclua-os manualmente. O arquivo local script.qvs no diretório de compilação também pode conter a instrução temporária Binary. Execute a conversão novamente para regenerá-lo.
A carga binária automática requer a flag --reload e um caminho --qvw. O QV2QS rejeita o comando e encerra com o código 1 se qualquer um dos requisitos estiver ausente.
O arquivo QVW original na máquina local nunca é modificado ou excluído. Apenas a cópia temporária no Qlik Cloud é removida após a conclusão da carga de dados.
A carga binária automática não é suportada para aplicativos que usam Acesso à Seção. O mecanismo de recarga do Qlik Cloud não consegue autenticar na tabela de Acesso à Seção no arquivo QVW de origem. Quando o QV2QS detecta o Acesso à Seção no aplicativo de origem, as etapas de upload binário e recarga são ignoradas e um aviso é registrado. O aplicativo é implantado sem dados. Para carregar dados, crie conexões de dados do Qlik Cloud e atualize o script de carregamento manualmente ou remova o Acesso à Seção de uma cópia do QVW de origem e execute novamente com --autoBinary.
Quando --preserveTargetAppScript é combinado com --reload, a recarga executa o script de carregamento existente no aplicativo de destino, e não o script convertido. Isso é útil quando o aplicativo de destino já possui conexões de dados do Qlik Cloud em funcionamento e apenas a camada da interface do usuário precisa ser atualizada. Para obter detalhes, consulte Reutilizar um aplicativo existente.