Início rápido
Última atualização: 14/10/2026Execute uma primeira conversão de ponta a ponta usando o assistente ou a linha de comando.
Pré-requisitos
- Uma máquina Windows (Windows 10, 11, ou Windows Server 2019, 2022, 2025)
- Uma cópia do documento QlikView (
.qvwou arquivo.qvfcriado no QlikView) em uma pasta de trabalho local. Os arquivos QVF do Qlik Sense não são entradas de origem válidas. Não aponte o QV2QS para arquivos de produção em unidades compartilhadas ou pontos de montagem do QlikView Server. Para detalhes, consulte Segurança do arquivo de origem. Alternativamente, use um dos projetos de exemplo incluídos. Ver Projetos de exemplo. - Um locatário do Qlik Cloud com acesso à chave de API habilitado (para implementação na nuvem). Para obter instruções de configuração, consulte Configurando o acesso ao Qlik Cloud.
Usando o assistente
Faça o seguinte:
- Dê um duplo clique
QV2QS.exe. No primeiro lançamento, o QV2QS exibe um contrato de licença. Aceite o contrato para continuar. O assistente abre no navegador padrão. - Na etapa de Configuração, selecione Compilar para Qlik Cloud.
- Na etapa Projeto, selecione o arquivo QVW. Mantenha Auto-gerar PRJ ativado (extrai o QVW para um conjunto de arquivos XML e de texto que o QV2QS lê durante a conversão).
- Na etapa Saída, selecione uma pasta raiz de saída. QV2QS cria automaticamente uma subpasta com o nome do arquivo QVW.
- Na etapa de autenticação do Qlik Cloud, insira o URL do locatário e a chave da API. O assistente valida a conexão.
- Na etapa do aplicativo Qlik Cloud, insira um nome de aplicativo. Habilite Recarregar e Binário automático para preencher o aplicativo com dados.
- Na etapa Revisão, verifique o resumo da configuração. O assistente também inclui as etapas Estilização, Avançado e Relatório de conversão com padrões sensatos. Ajuste estas etapas conforme necessário antes de executar.
- Clique em Executar. QV2QS gera a pasta PRJ, converte a interface do usuário do QlikView, implanta o aplicativo no Qlik Cloud e gera um relatório de conversão.
Após a conclusão da conversão, o painel de resumo executivo exibe métricas de conversão e itens de seguimento. Abra o aplicativo Qlik Cloud diretamente do resumo para revisar as planilhas convertidas.
Usando a linha de comando
O exemplo a seguir gera uma pasta PRJ a partir de um arquivo QVW, converte a interface do usuário, implanta o aplicativo no Qlik Cloud com dados e gera um relatório do Excel:
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
O --autoBinary sinalizador carrega temporariamente o arquivo QVW para o Qlik Cloud para que o aplicativo convertido possa carregar dados por meio de uma Binary instrução. Após a recarga ser concluída, QV2QS exclui o arquivo carregado e restaura o script de carregamento original no aplicativo da Nuvem.
QV2QS aplica valores padrão para opções não especificadas na linha de comando. A saída do console usa formatação rica no modo escuro, um relatório de conversão é gerado automaticamente, e o layout da grade dinâmica é usado, a menos que o modo de tela fixa esteja ativado. Para a lista completa de argumentos e padrões, consulte Referência de argumentos.
O que esperar
Uma conversão de aplicativo único com implementação na nuvem e recarregamento de dados geralmente é concluída em dois a cinco minutos de ponta a ponta. A etapa de conversão local (extração de PRJ, análise de XML e geração de JSON) é executada em menos de 30 segundos, mesmo para aplicações complexas. Implementação na nuvem e criação de aplicativo adicionam de um a três minutos. O tempo de recarregamento depende inteiramente do volume de dados e da configuração da fonte de dados. Para uma decomposição detalhada do tempo por etapa da pipeline, consulte Como a conversão funciona.
O que é produzido
Após uma conversão bem-sucedida, a subpasta do projeto (por exemplo, ./output/Sales/) contém a estrutura do aplicativo convertido, mídia extraída, um relatório de conversão e logs de diagnóstico. Para uma descrição completa, consulte Como a conversão funciona.