Como funciona a conversão

Última atualização: 14/10/2026

A pipeline de conversão tem as seguintes fases:

• Extrair — Se --generatePrj estiver ativado, o QV2QS inicia o QlikView Desktop para extrair o arquivo QVW em uma pasta PRJ. QV2QS usa o mecanismo portátil empacotado a menos que uma instalação de sistema do QlikView Desktop seja detectada. Para detalhes, consulte QlikView mecanismo de desktop.
• Analisar — QV2QS lê a pasta PRJ e analisa cada definição de objeto, layout de pasta, script de carregamento, variável e propriedade de documento. O QV2QS também lê o binário QVW/QVF diretamente para extrair metadados, variáveis e qualquer script de carregamento oculto incorporado no arquivo.
• Converter — Cada objeto do QlikView é mapeado para um tipo de visualização do Qlik Sense. Dimensões, medidas, expressões, estilo e posições de layout são traduzidas para o formato JSON do Qlik Sense.
• Escrever — O QV2QS escreve a estrutura do aplicativo convertido na pasta de saída como um conjunto de arquivos JSON.
• Implantar (somente modos de nuvem) — QV2QS cria o aplicativo no locatário, carrega mídia, cria o aplicativo e, opcionalmente, recarrega o aplicativo com dados.
• Relatório — O QV2QS gera um relatório de conversão resumindo os resultados, a pontuação de automação e quaisquer itens que exijam acompanhamento manual.

A fase de Implantação é executada nos modos Compilar para Qlik Cloud e Exportar QVF. No modo Somente local, o QV2QS grava a saída convertida em disco sem se conectar ao Qlik Cloud. A fase de Relatório é executada em todos os modos.

Modos de conversão

QV2QS suporta três modos de conversão. Selecione o modo na etapa Configuração do assistente ou com a flag CLI correspondente.

Compilar para Qlik Cloud é o modo recomendado para migração. Exportar QVF é útil para produzir um arquivo portátil para compartilhar ou importar para um locatário diferente. O modo somente local destina-se à avaliação e revisão. Para detalhes sobre as limitações somente locais, consulte a seção abaixo.

Modo somente local

Modo somente local (--unbuildOnly) executa as fases de Análise, Conversão, Gravação e Relatório sem se conectar ao Qlik Cloud. Nenhum locatário ou chave de API é necessário. QV2QS gera o relatório de conversão completo, o resumo executivo e a pasta de saída da compilação em disco.

Casos de uso

• Avaliação de migração — Execute o modo Somente local para gerar o relatório de conversão, resumo executivo, pontuação de automação e descobertas de expressão sem exigir acesso ao Qlik Cloud. Avalie a qualidade da conversão em todo um ambiente QVW antes de configurar as credenciais do locatário.
• Revisão pré-implementação — Inspecione a saída gerada (script de carregamento, definições de objeto, variáveis, dimensões) antes de confirmar uma implementação na nuvem. Organizações com processos de controle de mudanças podem revisar a saída como um artefato intermediário.
• Ambientes offline ou restritos — Quando a máquina que hospeda os arquivos QVW não tem acesso à internet de saída, execute o modo Somente local para gerar o relatório de conversão localmente. Para implementar o aplicativo convertido, copie os arquivos QVW para uma máquina com acesso ao Qlik Cloud e execute o QV2QS no modo Construir para Qlik Cloud a partir da máquina conectada.

Limitações

A fase de Implantação lida com várias operações que qlik app build sozinha não executa. Executar o modo Somente local e, em seguida, implantar a build/ pasta manualmente com uma instalação autônoma do qlik-cli resulta nas seguintes lacunas.

• Arquivos de mídia não foram carregados. Imagens de fundo e imagens de botão são extraídas para a pasta images/, mas não são incluídas na pasta build/. O qlik app build comando não processa arquivos de mídia. Todas as imagens de fundo e imagens de botão estarão faltando do aplicativo implantado.
• Referências de plano de fundo de planilha e objeto não são resolvidas. QV2QS injeta URLs de imagem de fundo nos arquivos JSON de pasta e objeto durante a fase de Implantação usando o ID do aplicativo na nuvem. A saída da compilação local não contém referências de imagem de fundo. Planilhas e objetos não terão planos de fundo no aplicativo implantado.
• URLs de imagem de botão contêm strings de espaço reservado. Imagens de botão na saída da compilação local usam valores de espaço reservado internos em vez de URLs de mídia resolvidas. O mecanismo do Qlik Sense não consegue interpretar as cadeias de caracteres de espaço reservado. As imagens dos botões aparecerão quebradas.
• Estados alternativos não são criados. Nomes de estado alternativos são gravados em cloud/alternate_states.json fora da pasta build/. O qlik app build comando não processa estados alternados. Objetos que fazem referência a estados não padrão podem não ser exibidos corretamente.
• As planilhas não estão publicadas. O qlik app build comando cria planilhas como objetos pessoais visíveis apenas para o proprietário do aplicativo. QV2QS publica planilhas como planilhas base durante a fase de Implantação. Em um espaço compartilhado, outros usuários não verão nenhuma planilha até que as planilhas sejam publicadas manualmente.

Segurança do arquivo de origem

QV2QS não modifica o conteúdo do arquivo QVW ou QVF de origem. Durante a fase de Extração, o QV2QS abre o documento de origem através do QlikView Desktop e salva uma cópia temporária em uma pasta temporária do sistema. QV2QS então fecha o original e gera a pasta PRJ a partir da cópia temporária. Após a conclusão da geração do PRJ, o QV2QS copia a pasta resultante -prj de volta para o mesmo diretório do arquivo de origem e exclui a cópia temporária. Se uma -prj pasta já existe ao lado do arquivo de origem, o QV2QS substitui a pasta pela versão recém-gerada. Todo o restante da saída de conversão é gravado no diretório de saída separado especificado por --outputDir.

QlikView Desktop adquire um bloqueio de arquivo no documento de origem enquanto a cópia temporária está sendo criada. Executar o QV2QS em um arquivo que está ativamente aberto no QlikView Desktop ou servido pelo QlikView Server pode causar conflitos de bloqueio de arquivo ou falha na geração de PRJ. Arquivos em unidades de rede compartilhadas podem causar os mesmos conflitos. A gravação da -prj pasta de volta para um compartilhamento de rede ou diretório somente leitura também pode falhar.

Para evitar qualquer risco aos ambientes de produção, trabalhe sempre com cópias dos documentos de origem. Faça o seguinte:

1. Copie os arquivos QVW ou QVF para uma pasta de trabalho local na máquina onde o QV2QS é executado.
2. Aponte o QV2QS para os arquivos copiados, não para os originais.
3. Feche quaisquer instâncias do QlikView Desktop em execução antes de iniciar a conversão. QV2QS requer acesso exclusivo ao QlikView Desktop.

Tempo típico

QV2QS é projetado para velocidade. A pipeline completa é concluída em minutos, não horas. A tabela a seguir mostra durações típicas para uma conversão de aplicativo único.

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. Conversões apenas locais (--unbuildOnly) são concluídas em menos de 30 segundos.

No modo em lote, o QV2QS converte múltiplos projetos em paralelo. O tempo total do lote é dimensionado com o número de projetos dividido pela contagem de trabalhadores. Para um lote de 20 aplicativos com quatro trabalhadores, espere aproximadamente cinco vezes a duração de um aplicativo único para a fase de conversão local, mais o tempo de implementação na nuvem.

Estrutura da pasta de saída

O --outputDir argumento especifica a raiz de saída. QV2QS cria uma subpasta nomeada com base no arquivo QVW (ou pasta PRJ) dentro da raiz de saída. Toda a saída de conversão para o projeto é gravada nessa subpasta. Se dois arquivos QVW compartilharem o mesmo nome, o QV2QS anexa _2, _3, e números subsequentes para evitar colisões. Este comportamento corresponde ao modo em lote, onde cada projeto também recebe uma subpasta dedicada.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

QV2QS cria a pasta de saída se a pasta ainda não existir. Se a pasta existir de uma execução anterior do mesmo QVW, o QV2QS reutiliza a pasta. Os arquivos de log existentes na pasta são preservados, a menos que Limpar logs esteja ativado. O diretório de saída não deve ser o mesmo ou um diretório pai de qualquer diretório de origem. QV2QS valida o caminho de saída antes de iniciar a conversão e relata um erro se os caminhos se sobrepõem. A subpasta do projeto contém o seguinte:

Após a conversão

Após a conclusão de uma conversão, analise os seguintes itens agrupados por prioridade.

Corrigir antes de publicar

1. Abra o relatório de conversão do Excel na reports/ subpasta e revise a planilha Follow-up_Objects. Corrija todos os itens marcados como Erro primeiro (objetos que falharam na conversão), depois Espaço Reservado (objetos que precisam ser reconstruídos), depois Ajustes Necessários (objetos que foram convertidos parcialmente).
2. Revise as descobertas da análise na planilha Análise, incluindo referências de macro, uso de Acesso à Seção e padrões de script de carregamento que podem precisar de atenção manual.
3. Verifique se as expressões são avaliadas corretamente. QV2QS automaticamente corrige problemas de aspas na análise de conjunto durante a conversão. Revise dimensões calculadas, coloração condicional e expressões usando funções exclusivas do QlikView (GetCurrentField(), MsgBox()) que exigem reescrita manual.
4. Verifique a planilha Overflow_Actions para objetos onde dimensões ou medidas em excesso foram movidas para a coleção de alternativas.

Verificar antes de publicar

5. Abra o aplicativo convertido no Qlik Sense e verifique se os layouts da pasta, as posições dos objetos e as imagens de fundo aparecem como esperado.
6. Confirme se a navegação do contêiner de abas (tiras de botões ou contêineres com abas) alterna entre as áreas de conteúdo corretamente.
7. Teste o detalhamento e o comportamento de ciclagem do grupo cíclico em gráficos que usam grupos de dimensão.
8. Verifique se as condições de exibição ocultam e revelam objetos conforme o esperado.
9. Verifique as ordens de classificação em caixas de listagem e tabelas, principalmente para campos do tipo data.

Polonês

10. Ajuste fontes, cores ou o posicionamento de objetos no editor do aplicativo Qlik Sense conforme necessário. Para orientação sobre o posicionamento do layout, consulte Configurações de layout de conversão.

Para uma descrição completa do conteúdo do relatório, consulte Relatório de conversão.

Saiba mais

• Início rápido
• Interface do usuário
• Interface de linha de comando
• Configurações de layout de conversão
• Resultados da conversão