Etapas do assistente
Última atualização: 14/10/2026A interface do usuário é uma interface estilo assistente para o processo de conversão completo. O assistente é aberto no navegador padrão após clicar duas vezes em QV2QS.exe ou executar o arquivo executável com a --ui flag. O número da versão atual é exibido na caixa de diálogo Sobre. Um botão de alternância de tema no canto superior direito alterna entre o modo claro e escuro. Para mais informações, consulte Modo escuro.
O assistente apresenta as seguintes etapas em ordem. Etapas que não se aplicam ao modo de fluxo de trabalho selecionado são ocultadas automaticamente.
Configuração
Selecione um modo de fluxo de trabalho (obrigatório). O modo selecionado determina quais etapas subsequentes estão disponíveis.
- Compilar para Qlik Cloud (padrão) — converte a interface do usuário do QlikView e implanta o aplicativo resultante diretamente no locatário do Qlik Cloud. Escolha este modo para ver o aplicativo convertido no Qlik Cloud imediatamente. Este modo é o fluxo de trabalho recomendado para migração.
- Exportar QVF — converte a interface do usuário do QlikView usando o mecanismo do Qlik Cloud, exporta o aplicativo resultante como um arquivo QVF e, em seguida, exclui o aplicativo na nuvem. Escolha este modo para produzir um arquivo para compartilhar com outra equipe ou importar para um locatário diferente. Este modo ainda requer um locatário do Qlik Cloud e uma chave de API. A importação para Qlik Sense Enterprise Client-Managed não é testada em todas as versões ou oficialmente suportada. Para obter detalhes, consulte compatibilidade do Qlik Sense Enterprise Client-Managed.
- Somente local — realiza a conversão no disco sem se conectar ao Qlik Cloud. Nenhum locatário do Qlik Cloud ou chave de API é necessário. O modo somente local gera o relatório de conversão completo e a saída da compilação para avaliação, revisão ou uso 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 — essas operações exigem a fase de Implantação. Para uma implementação completa, use Build to Qlik Cloud ou o modo Exportar QVF. Para detalhes sobre as limitações somente locais, consulte Como a conversão funciona. Direcionar o QSECM com a saída da compilação não é testado em todas as versões ou oficialmente suportado. Para obter detalhes, consulte compatibilidade do Qlik Sense Enterprise Client-Managed.
Projeto
Configure a fonte de entrada. Realize uma das seguintes ações:
- Projeto único (padrão): forneça um arquivo QVW (obrigatório). Auto-gerar PRJ está ativado por padrão e gera a pasta PRJ a partir do arquivo QVW automaticamente. Desative esta opção para fornecer uma pasta PRJ ou ZIP manualmente. Clique Experimentar exemplo para carregar um projeto de exemplo empacotado sem navegar. O botão fica visível apenas quando o campo QVW está vazio. Ver Projetos de exemplo.
- Lote: forneça uma ou mais pastas para escanear (obrigatório). QV2QS descobre todos os pares QVW e PRJ correspondentes recursivamente. Clique Experimentar exemplo para preencher o campo da pasta com a pasta de exemplos incluídos. Trabalhadores em lote controla quantas conversões são executadas em paralelo (padrão: detecção automática com base nos núcleos da CPU). Para mais informações, consulte Conversão em lote.
Sempre aponte o QV2QS para cópias de documentos de origem em uma pasta de trabalho local, não para arquivos de produção no QlikView Server ou unidades de rede compartilhadas. O mecanismo do QlikView Desktop adquire um bloqueio de arquivo durante a geração de PRJ, o que pode entrar em conflito com sessões ativas do QlikView. Para detalhes, consulte Segurança do arquivo de origem.
Saída
Defina a pasta raiz de saída (obrigatório). QV2QS cria uma subpasta com o nome do projeto dentro da raiz de saída automaticamente (por exemplo, <outputDir>/Sales/). Se dois projetos compartilharem o mesmo nome, um _2, _3 sufixo é anexado para evitar colisões. Ativar Limpar logs para excluir arquivos de log existentes antes da execução.
Autenticação do Qlik Cloud
Esta etapa aparece apenas nos modos Compilar para Qlik Cloud e Exportar QVF.
Selecione ou crie um contexto qlik-cli para autenticar com o locatário do Qlik Cloud (obrigatório). Crie um novo contexto fornecendo a URL do locatário e a chave da API. O assistente valida a conexão antes de prosseguir.
aplicativo Qlik Cloud
Esta etapa aparece apenas nos modos Compilar para Qlik Cloud e Exportar QVF.
| Configuração | Descrição | Padrão |
|---|---|---|
| Nome do aplicativo | Nome para o aplicativo Qlik Sense no Qlik Cloud | Nome do arquivo QVW, nome da pasta PRJ ou nome da pasta de saída |
| Carregar | Recarregue o aplicativo após a construção para executar o script de carregamento | Ativado |
| Auto-binário | Carregue temporariamente o arquivo QVW para o carregamento de dados binários e, em seguida, exclua o arquivo após a recarga. Requer Recarregar. | Ativado |
| AppId Binário | Use um aplicativo QVW ou QVF existente no Qlik Cloud para a carga binária em vez de fazer upload. Requer Recarregar. Clique no botão navegar para abrir o seletor QVW. | — |
| Reutilizar aplicativo existente | Atualize um aplicativo criado anteriormente em vez de criar um novo. Quando ativado, o QV2QS verifica a pasta de saída em busca de uma implementação anterior correspondente ao arquivo QVW selecionado e preenche o ID do aplicativo automaticamente. Se nenhuma implementação anterior for encontrada, insira o ID do aplicativo manualmente ou clique no botão procurar para abrir o seletor QVF. | Desligado |
| Preservar script de carregamento | Mantenha o script de carregamento existente no aplicativo de destino. O script convertido não é aplicado. Requer Reutilizar aplicativo existente. Desativa Recarregar por padrão; reabilite para executar o script existente. | Desligado |
| Preservar variáveis | Mantenha as variáveis existentes no aplicativo de destino. As variáveis convertidas não são aplicadas. Requer Reutilizar aplicativo existente. | Desligado |
| Ignorar backup de pré-implementação | Não exportar um backup QVF antes de sobrescrever o aplicativo. Por padrão, um backup sem dados é salvo em cloud/backups/. Requer Reutilizar aplicativo existente. |
Desligado |
| Publicar folhas | Publicar todas as folhas convertidas como folhas base após a construção. Planilhas base são visíveis para todo usuário que tem acesso ao aplicativo. Desative esta configuração para manter as planilhas como objetos pessoais (não publicados). Quando Reutilizar aplicativo existente estiver ativado, a configuração se aplica apenas a novas planilhas. Planilhas publicadas anteriormente são restauradas automaticamente independentemente desta configuração. | Ativado |
| Construir sem dados | Ignorar o carregamento de dados durante a fase de compilação. O aplicativo é montado no locatário sem dados, permitindo que a estrutura da interface do usuário seja testada sem esperar por um recarregamento. | Desligado |
| Exportar sem dados | Remover dados do arquivo QVF exportado. O aplicativo na nuvem ainda pode conter dados da compilação, mas o QVF baixado é menor. Modo de exportação QVF apenas. | Desligado |
Os campos AppId Binário e Reutilizar aplicativo existente incluem botões de navegação que abrem modais de seleção de aplicativo da nuvem. Cada seletor carrega aplicativos do locatário conectado com filtragem de pesquisa por nome, proprietário, espaço ou ID do aplicativo. O seletor QVW também oferece um filtro de tipo de aplicativo (QVW, QVF ou todos). Selecione um aplicativo da lista para preencher o campo automaticamente.
Ajustes de expressão
| Configuração | Descrição | Padrão |
|---|---|---|
| Corrigir valores de pesquisa entre aspas simples | Converter curingas entre aspas simples e comparações para aspas duplas em expressões de análise de conjunto. Para mais informações, consulte Referência de argumentos. | Ativado |
| Corrigir valores definidos sem aspas (experimental) | Envolva valores de string brutos não-citados em aspas simples em expressões de análise de conjunto. Para mais informações, consulte Referência de argumentos. | Desligado |
Estilo
As seguintes configurações controlam a aparência da pasta e o comportamento do layout.
Tema
| Configuração | Descrição | Padrão |
|---|---|---|
| Tema do aplicativo | Tema do Qlik Sense aplicado ao aplicativo convertido. A lista suspensa exibe os quatro temas Qlik integrados. Quando um contexto do Qlik Cloud estiver configurado, clique no botão de atualização para buscar temas personalizados instalados no locatário. Sense Classic produz a mais alta fidelidade 1:1 com QlikView. Temas não clássicos podem alterar bordas de objetos, cores de fundo, fontes e preenchimento. O tema define o padrão apenas; os usuários podem trocar de temas a qualquer momento no cliente Qlik Sense. | Sense Classic |
Planos de Fundo
| Configuração | Descrição | Padrão |
|---|---|---|
| Imagens de fundo da planilha | Extrair e aplicar papéis de parede de pasta do QlikView | Ativado |
| Voltar para o plano de fundo do documento | Usar o plano de fundo em nível de documento para folhas que não têm um | Ativado |
| Substituição da cor de fundo | Preenchimento de cor sólida aplicado a todas as folhas (#RRGGBB) |
— |
Layout
| Configuração | Descrição | Padrão |
|---|---|---|
| Mostrar cabeçalho da pasta | Adicionar uma região de cabeçalho às planilhas convertidas | Desligado |
| Ignorar planilhas ocultas | Omitir planilhas com condições de exibição sempre falsas | Desligado |
Listboxes e ordenação
| Configuração | Descrição | Padrão |
|---|---|---|
| Preservar cores da caixa de listagem QV | Aplicar cores e transparência de fundo originais da caixa de listagem QlikView | Ativado |
| Guarda de ordenação de campo de data | Manter campos de caixa de listagem semelhantes a datas (Ano, Trimestre, Mês e similares) ordenados cronologicamente em vez de por estado de seleção. Para mais informações, consulte Referência de argumentos. | Ativado |
Avançado
| Configuração | Descrição | Padrão |
|---|---|---|
| Canvas de pasta fixa | Habilitar posicionamento estilo QlikView com precisão de pixel. Revela fatores de escala, dimensões mínimas e opções de corte da tela. Escala do canvas e escala do objeto estão vinculadas por padrão; clique no ícone de corrente para definir valores independentes. Para mais informações, consulte Configurações de layout de conversão. | Ativado |
| Estender automaticamente pasta dinâmica | Permitir que as planilhas cresçam verticalmente além da altura padrão da grade | Ativado |
| Trabalhadores de upload de mídia | Número de trabalhadores paralelos para carregar arquivos de mídia (papéis de parede e imagens) para o Qlik Cloud. Aplica-se aos modos de Criação para Qlik Cloud e Exportação de QVF. | 2
|
| Substituições de Script | Ativar/desativar o processamento de substituição de script e gerenciar regras individuais. Para mais informações, consulte Referência de argumentos. | Ativado |
A Script substituições seção inclui um editor de regras inline. Alterne o interruptor principal para ativar ou desativar todo o processamento de script. Expanda a seção para visualizar, adicionar, editar ou excluir regras individuais. Cada regra pode ser ativada ou desativada independentemente. Clique Redefinir para Padrões para restaurar as oito regras integradas. Um selo de resumo mostra o número de regras ativadas.
Clique nos botões de seta para cima e para baixo em uma regra para alterar a ordem de execução. Regras com uma ordem de execução menor são executadas primeiro. Clique Exportar para download de todas as regras como um arquivo JSON. Clique Importar para carregar regras de um arquivo JSON, substituindo o conjunto atual. Arquivos importados devem conter um array JSON onde cada regra tem um description, pattern, e search campo.
Para criar um arquivo de regras personalizado para importação, clique em Exportar primeiro para obter as regras incorporadas no formato correto. Edite o arquivo exportado para adicionar, remover ou modificar regras, então clique em Importar para carregar o conjunto atualizado.
Quando regras personalizadas ou padrões desativados são configurados, a pré-visualização do comando exibe um aviso. O comando copiado não inclui regras personalizadas. Exporte regras para um arquivo JSON e adicione --scriptReplacements <path> ao comando para incluir regras personalizadas na linha de comando.
Para uma explicação de como as regras funcionam, incluindo o processo de correspondência em duas etapas e a lista de regras incorporadas, consulte Referência de argumentos.
Abrir Mockup Studio a partir da etapa Avançada para pré-visualizar interativamente layouts de tela fixa e de grade dinâmica, ajustar o dimensionamento e aplicar as configurações de volta ao assistente.
Relatório de conversão
As seguintes configurações controlam a saída do relatório de conversão.
| Configuração | Descrição | Padrão |
|---|---|---|
| Gerar relatório | Gerar um relatório de conversão de console | Ativado |
| Relatório do Excel | Exporte o relatório como um arquivo XLSX com detalhes por objeto e pontuação de automação. Insira um nome de arquivo (p. ex. MyReport) ou um caminho completo. A .xlsx extensão é adicionada automaticamente. Deixe em branco para nomear automaticamente em reports/. |
Ativado |
| Incluir seleções e objetos de pesquisa | Incluir a caixa de Seleções Atuais e o objeto de Pesquisa no relatório. Estes são adicionados automaticamente pelo Qlik Sense e excluídos por padrão. | Desligado |
Revisão
Confirme todas as configurações antes de executar. A etapa de revisão exibe cartões de resumo para a configuração de projeto, fluxo de trabalho, nuvem e saída. No modo em lote, uma tabela lista todos os projetos descobertos.
Uma lista de verificação de ações necessárias na barra lateral acompanha os itens que devem ser configurados antes da execução. Os itens são agrupados por categoria: fluxo de trabalho, entradas, saída e autenticação na nuvem. Cada item mostra Concluído quando configurado ou A Definir quando um valor está faltando. Clique em um item para navegar diretamente para a etapa relevante do assistente.
O painel de prévia do comando exibe o comando CLI equivalente para a configuração atual do assistente. Alternar entre a sintaxe do PowerShell e do Bash. Clique em Copiar para copiar o comando para a área de transferência. A prévia do comando é útil para aprender os argumentos da CLI ou para salvar o comando exato para reexecuções roteirizadas.
Clique Executar para iniciar a conversão.
Executar
Exibe a saída do console em tempo real enquanto a conversão é executada. Parar uma conversão em andamento, seguir os logs em tempo real e abrir a pasta de saída ou o aplicativo Qlik Cloud quando a execução for concluída.