# Problemas de compilação e implementação

## Build na nuvem falha com erros de objeto

Possível causa

Um ou mais objetos não puderam ser criados no Qlik Sense. O console exibe `Build failed` seguido por uma descrição do erro. A falha geralmente ocorre quando uma propriedade de objeto não é suportada pelo tipo de visualização de destino.

Ação proposta

Abra o aplicativo no Qlik Sense para revisar os objetos afetados. O aplicativo é criado e a maioria dos objetos são carregados com sucesso. Verifique o relatório de conversão do Excel para objetos com um Erro resultado. Esses objetos exigem correção manual no editor do aplicativo Qlik Sense. Consulte o arquivo de log de cada execução na subpasta de saída `logs/` para obter os detalhes completos do erro.

## Falha no upload de mídia

Possível causa

Um ou mais arquivos de imagem não puderam ser carregados para a biblioteca de mídia do Qlik Sense. O console exibe `Media upload failed for N/M file(s)` seguido pelo primeiro detalhe da falha.

Ação proposta

Verifique se os arquivos de imagem existem e não estão corrompidos. Verifique os tamanhos dos arquivos, pois imagens muito grandes podem exceder os limites de upload. Tentar novamente a implementação. Se o problema persistir, carregue as imagens manualmente através da biblioteca de mídia do Qlik Sense. Execute com `--logLevel DEBUG` para identificar quais arquivos falharam na saída do log.

## Aplicativo auto-binário temporário permanece após uma implementação com falha

Possível causa

A etapa de compilação ou recarregamento falhou depois que o arquivo QVW foi carregado para o Qlik Cloud. QV2QS tenta excluir o aplicativo temporário automaticamente, mas a limpeza pode falhar se a conexão de rede for interrompida ou a chave da API tiver expirado.

Ação proposta

Verifique o espaço de destino para aplicativos chamados `QV2QS_Binary_YYYYMMDD_HHMMSS` (por exemplo, `QV2QS_Binary_20260219_143025`) e exclua-os manualmente. Execute novamente a conversão para regenerar os arquivos de saída. Revise o arquivo de log por execução na `logs/` subpasta de saída para detalhes de erro de limpeza.

## As planilhas desaparecem após a reimplementação para um aplicativo existente

Possível causa

A etapa de preparação da pasta falhou no meio do processo. O QV2QS remove as planilhas existentes do aplicativo na nuvem antes de construir, para que as novas planilhas possam ser criadas com os mesmos IDs. Se a etapa de remoção ou construção falhar, o aplicativo pode ser deixado em um estado incompleto.

Ação proposta

Restaurar o aplicativo a partir do backup automático de pré-implementação. Os backups são salvos em `cloud/backups/` na pasta de saída do projeto. Importe o QVF de backup para o espaço de destino através do hub do Qlik Cloud. Em seguida, execute novamente a implementação. Se nenhum backup estiver disponível, execute a conversão novamente como um novo aplicativo omitindo `--reuseAppId` e `--appId`.

## Novas planilhas não são publicadas após a reimplementação para um aplicativo existente

Possível causa

A Publicar planilhas configuração foi desativada durante a reimplementação. Ao reutilizar um aplicativo existente, o QV2QS restaura automaticamente o estado de publicação das planilhas implantadas anteriormente, mas novas planilhas são publicadas apenas quando a Publicar planilhas configuração está ativada.

Ação proposta

Execute novamente a implementação com Publicar planilhas ativado (o padrão). Alternativamente, publique novas planilhas manualmente no Qlik Cloud. Abra o aplicativo, clique com o botão direito do mouse em cada pasta não publicada e selecione Publicar.

## Saiba mais

* [Compilação e implementação](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/build-and-deployment.htm)
* [Reutilizando um aplicativo existente](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm)
* [Qlik Cloud limites de recursos](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/known-limitations/qlik-cloud-resource-limits.htm)
* [Relatório de conversão](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)