# Início rápido

Execute 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 (`.qvw` ou arquivo `.qvf` criado 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](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety). Alternativamente, use um dos projetos de exemplo incluídos. Ver [Projetos de exemplo](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/example-projects.htm).
* 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](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm).

## Usando o assistente

Faça o seguinte:

1. 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.
2. Na etapa de Configuração, selecione Compilar para Qlik Cloud.
3. 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).
4. Na etapa Saída, selecione uma pasta raiz de saída. QV2QS cria automaticamente uma subpasta com o nome do arquivo QVW.
5. 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.
6. Na etapa do aplicativo Qlik Cloud, insira um nome de aplicativo. Habilite Recarregar e Binário automático para preencher o aplicativo com dados.
7. 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.
8. 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](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

## 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](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm).

## 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](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm).

## Saiba mais

* [Interface do usuário](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/user-interface/index.htm)
* [Fluxos de trabalho comuns](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm)
* [Configurações de layout de conversão](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)
* [Resultados da conversão](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/conversion-results/conversion-outcomes.htm)