# Dados e recarregamento

O QV2QS converte a interface de usuário do QlikView e pode carregar dados automaticamente no aplicativo convertido usando a opção Auto-binary. Habilite Reload e Auto-binary no assistente ou na linha de comando, e o QV2QS gerencia a transferência de dados automaticamente. Se o Auto-binary não for usado, o aplicativo convertido deve ser recarregado separadamente para preencher os dados.

O QV2QS converte os metadados da interface do usuário do QlikView (PRJ XML) em JSON do Qlik Sense e cria o aplicativo diretamente no locatário do Qlik Cloud. O processo de conversão lida com layouts de pasta, objetos de visualização, expressões e estilização. Sem uma recarga, o aplicativo Qlik Sense resultante não contém dados após a conclusão da etapa de compilação.

Para preencher dados no aplicativo convertido, o aplicativo deve ser recarregado. Há três abordagens:

* Carga binária automática — O QV2QS faz o upload do arquivo QVW original para o Qlik Cloud e usa uma instrução `Binary` para carregar os dados durante a compilação. Essa abordagem é a maneira mais rápida de ver um aplicativo funcionando com dados imediatamente após a conversão. Para obter detalhes, consulte *Carga binária automática* abaixo.
* Recarregamento manual — Se conexões de dados já tiverem sido criadas no Qlik Cloud e os arquivos QVD ou fontes de dados estiverem acessíveis, o aplicativo poderá ser recarregado após o ajuste do script de carregamento. O QV2QS aplica normalização básica de caminho de script de carregamento, mas os nomes de conexão e os caminhos de fonte de dados podem exigir atualizações manuais.
* Recarregamento acionado — Use a flag `--reload` para acionar um recarregamento como parte da implementação. A recarga executa o script de carregamento como está. A recarga só é bem-sucedida se as conexões de dados e as fontes de dados referenciadas no script de carregamento já estiverem disponíveis no ambiente do Qlik Cloud.

Duas flags controlam os dados em diferentes etapas. A flag `--noData` ignora dados durante a etapa de compilação para que a estrutura do aplicativo possa ser testada sem aguardar um recarregamento. A flag `--exportQvfNoData` exporta o QVF sem dados após a conclusão do build, gerando um arquivo menor para compartilhamento. As flags podem ser usadas de forma independente ou em conjunto.

## Carga binária automática

A carga binária automática faz o upload do arquivo QVW original para o Qlik Cloud, usa uma instrução `Binary` para carregar os dados no aplicativo convertido e, em seguida, remove o arquivo carregado. O aplicativo convertido recebe os mesmos dados que o QlikView original sem exigir configuração manual de conexão de dados.

Para habilitar a carga binária automática, use `--autoBinary` na linha de comando ou habilite Auto-binary na interface do usuário.

O QV2QS executa as seguintes etapas quando a carga binária automática está habilitada:

1. Faça upload do arquivo QVW para o Qlik Cloud como um aplicativo temporário.
2. Adicione uma instrução `Binary [<appId>];` e uma instrução `Exit Script;` ao início do script de carregamento do aplicativo convertido.
3. Crie o aplicativo (e recarregue se `--reload` for especificado), que carrega dados do QVW enviado.
4. Excluir o aplicativo temporário carregado do Qlik Cloud.
5. Restaure o script de carregamento original no aplicativo Qlik Cloud, removendo as instruções Binary e Exit Script.

Após a limpeza, o aplicativo Qlik Cloud contém os dados carregados, mas o script de carregamento não faz mais referência ao aplicativo temporário.

A etapa de upload está sujeita aos limites de tamanho de arquivo do Qlik Cloud. Arquivos QVW grandes podem exceder o limite de upload para o nível de assinatura do locatário. Se o upload falhar, implemente o aplicativo em um espaço com suporte a aplicativos grandes habilitado ou use o argumento `--binaryAppId` para fazer referência a um aplicativo existente já no Qlik Cloud. Para obter detalhes sobre os limites de recursos do locatário, consulte [Limites de recursos do Qlik Cloud](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/known-limitations/qlik-cloud-resource-limits.htm).

### Limpeza em caso de falha

Se a etapa de build ou recarga falhar após o arquivo QVW ter sido carregado, o QV2QS tenta automaticamente fazer a limpeza antes de sair. A limpeza inclui excluir o aplicativo temporário carregado do Qlik Cloud e restaurar o script de carregamento original tanto localmente quanto no aplicativo do Cloud.

Se a própria limpeza falhar (por exemplo, devido a uma interrupção de rede), o aplicativo temporário poderá permanecer no locatário do Qlik Cloud. Aplicativos temporários órfãos são nomeados como `QV2QS_Binary_YYYYMMDD_HHMMSS` (por exemplo, `QV2QS_Binary_20260219_143025`). Verifique o espaço de destino quanto a aplicativos correspondentes a esse padrão e exclua-os manualmente. O arquivo local `script.qvs` no diretório de compilação também pode conter a instrução temporária `Binary`. Execute a conversão novamente para regenerá-lo.

Nota informativa

A carga binária automática requer a flag `--reload` e um caminho `--qvw`. O QV2QS rejeita o comando e encerra com o código 1 se qualquer um dos requisitos estiver ausente.

Nota informativa

O arquivo QVW original na máquina local nunca é modificado ou excluído. Apenas a cópia temporária no Qlik Cloud é removida após a conclusão da carga de dados.

Nota informativa

A carga binária automática não é suportada para aplicativos que usam Acesso à Seção. O mecanismo de recarga do Qlik Cloud não consegue autenticar na tabela de Acesso à Seção no arquivo QVW de origem. Quando o QV2QS detecta o Acesso à Seção no aplicativo de origem, as etapas de upload binário e recarga são ignoradas e um aviso é registrado. O aplicativo é implantado sem dados. Para carregar dados, crie conexões de dados do Qlik Cloud e atualize o script de carregamento manualmente ou remova o Acesso à Seção de uma cópia do QVW de origem e execute novamente com `--autoBinary`.

Nota informativa

Quando `--preserveTargetAppScript` é combinado com `--reload`, a recarga executa o script de carregamento existente no aplicativo de destino, e não o script convertido. Isso é útil quando o aplicativo de destino já possui conexões de dados do Qlik Cloud em funcionamento e apenas a camada da interface do usuário precisa ser atualizada. Para obter detalhes, consulte [Reutilizar um aplicativo existente](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm).

## Saiba mais

* [Reutilizar um aplicativo existente](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm)
* [Exportar QVF](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/qvf-export.htm)
* [Referência de argumentos](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)