Fluxos de trabalho comuns
Última atualização: 14/10/2026Os exemplos a seguir cobrem os casos de uso mais frequentes. Cada um se baseia no mesmo padrão central: especifique um arquivo QVW, uma pasta de saída e um contexto do Qlik Cloud. Em todos os exemplos, --outputDir é a raiz de saída. QV2QS cria uma subpasta com o nome do arquivo QVW automaticamente (por exemplo, ./output/Sales/). Todos esses fluxos de trabalho também podem ser realizados através do assistente web. Para a abordagem guiada, consulte Etapas do Assistente.
Implantar no Qlik Cloud com dados
O fluxo de trabalho de migração padrão. QV2QS gera a pasta PRJ, converte a interface do usuário, carrega o QVW para carregamento de dados binários, recarrega o aplicativo no Qlik Cloud e produz um relatório do Excel. O QVW carregado é excluído e o script de carregamento original é restaurado após a recarga.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Exportar um arquivo QVF
QV2QS cria o aplicativo usando o mecanismo Qlik Cloud, exporta o resultado como um arquivo QVF e, em seguida, exclui o aplicativo da nuvem. O QVF exportado pode ser importado para um locatário diferente do Qlik Cloud.
A importação de arquivos QVF gerados pelo QV2QS para o Qlik Sense Enterprise Client-Managed não é testada em todas as versões, nem oficialmente suportada, e é desencorajada. Para obter detalhes, consulte compatibilidade do Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Migrar em lote todo um patrimônio QlikView
Verificar uma ou mais pastas em busca de todos os pares QVW e PRJ, converter os pares em paralelo e implementar cada um no Qlik Cloud. Use --batchWorkers para controlar a concorrência.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Preservar QlikView layout de pixel
Habilite o modo de tela fixa para reter as posições exatas dos objetos QlikView e os papéis de parede da pasta. Ajuste os fatores de escala para controlar como o layout é mapeado para as dimensões da tela do Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Atualizar um aplicativo previamente convertido
Rexecutar a conversão em um aplicativo Qlik Cloud existente sem criar um novo. QV2QS reutiliza o ID do aplicativo da execução anterior.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Atualizar um aplicativo enquanto preserva seu script de carregamento
Reexecute a conversão para atualizar a camada da interface do usuário de um aplicativo existente sem sobrescrever o script de carregamento. O aplicativo de destino mantém suas conexões de dados existentes e lógica de recarregamento. Um backup sem dados é exportado automaticamente antes da atualização. Adicione --reload para executar o script existente e atualizar os dados.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Atualizar um aplicativo, preservando suas variáveis
Reexecute a conversão para atualizar a camada da interface do usuário e o script de carregamento de um aplicativo existente sem sobrescrever as variáveis. Combine com --preserveTargetAppScript para manter intactos tanto o script de carregamento quanto as variáveis do aplicativo de destino.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Configurar autenticação do Qlik Cloud
Configure um contexto qlik-cli antes de executar qualquer conversão. A configuração interativa solicita uma URL de locatário e uma chave de API e armazena as credenciais para execuções subsequentes.
QV2QS.exe --setupQlikAuth
Uso programático (CI/CD)
QV2QS suporta autenticação direta sem contextos qlik-cli pré-criados. Passe a URL do locatário e a chave da API inline. QV2QS valida as credenciais e injeta cabeçalhos de autenticação em cada chamada qlik-cli. Nenhum arquivo de contexto é criado ou modificado. Inclua --accept-eula para aceitar o contrato de licença sem um prompt interativo.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Este modo é seguro para execução concorrente entre múltiplos locatários e usuários. A chave da API não é gravada em disco e não aparece em arquivos de log.
Credenciais também podem ser definidas como variáveis de ambiente:
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Build local sem Qlik Cloud
Gerar a saída convertida e o relatório de conversão em disco sem se conectar ao Qlik Cloud. O modo somente local é destinado para avaliação de migração, revisão pré-implementação e ambientes offline. A saída da compilação local não inclui uploads de mídia, resolução de imagem de fundo, criação de estado alternativo ou publicação de pasta. Para uma implementação completa, use Build to Qlik Cloud ou o modo Exportar QVF. Para detalhes sobre as limitações e casos de uso somente locais, consulte Como a conversão funciona.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly