# Problemas do QlikView Desktop

## Conflito de instância do QlikView

Possível causa

Outro processo do QlikView já está em execução. QV2QS requer acesso exclusivo ao QlikView Desktop para geração de PRJ. O console exibe `Close any running QlikView instances and retry.`

Ação proposta

Feche todas as instâncias do QlikView em execução. Se o processo não aparecer na barra de tarefas, abra o Gerenciador de Tarefas e finalize quaisquer `Qv.exe` processos. Em seguida, tente novamente a conversão.

## A geração de PRJ atingiu o tempo limite

Possível causa

O arquivo QVW é muito grande ou o disco é lento. A geração de PRJ tem um tempo limite fixo de 10 minutos por arquivo. O tempo limite não é configurável pelo CLI ou assistente.

Ação proposta

Verifique se há espaço em disco suficiente disponível, já que a geração de PRJ requer armazenamento temporário proporcional ao tamanho do arquivo QVW. Verifique se o arquivo QVW não está corrompido abrindo o arquivo no QlikView Desktop. No modo em lote, reduza o número de trabalhadores paralelos com `--batchWorkers 1` para liberar recursos de disco e CPU. Execute com `--logLevel DEBUG` para capturar o tempo detalhado de geração de PRJ no arquivo de log.

## Geração de PRJ falha no modo em lote sem detalhes de erro

Possível causa

QV2QS não consegue localizar um mecanismo QlikView Desktop. O mecanismo empacotado pode não ter sido extraído corretamente, e nenhuma instalação de sistema do QlikView Desktop está registrada. A geração de PRJ em lote verifica se há um motor disponível antes de processar qualquer arquivo. Se nenhum motor for encontrado, todos os arquivos são marcados como falhos e o lote continua sem pastas PRJ.

Ação proposta

Abra o log do sistema em `%LOCALAPPDATA%\QV2QS\qv2qs.log` e procure por `No QlikView Desktop found` ou `Batch PRJ prerequisites`. Estas entradas registram qual mecanismo foi detectado e se a verificação de pré-requisitos foi aprovada. Se nenhum mecanismo estiver disponível, instale o QlikView Desktop no sistema ou verifique se o executável QV2QS não está corrompido, fazendo o download novamente. Execute com `--logLevel DEBUG` para capturar o caminho completo de descoberta do motor.

## Não foi possível abrir QVW ou QVF

Possível causa

QV2QS encontrou o mecanismo Desktop do QlikView, mas o QlikView não conseguiu abrir o documento. O console exibe `Could not open QVW` ou `Could not open QVF` seguido por uma mensagem de diagnóstico. Três condições produzem este erro:

* Bloqueio de Acesso à Seção — O documento usa Acesso à Seção e a conta do Windows que executa o QV2QS não tem acesso ADMIN na tabela de Acesso à Seção, ou tem acesso USER sem Acessar Propriedades do Documento (Usuários) ativado em Propriedades do Documento > Segurança. QV2QS exibe a conta em execução (`DOMAIN\USER`) na mensagem de erro. Arquivos QVF não impõem restrições de propriedade de documento, portanto este motivo aplica-se principalmente a arquivos QVW.
* QlikView Desktop não licenciado — Um QlikView Desktop instalado no sistema foi detectado, mas não está licenciado. QlikView silenciosamente se recusa a abrir qualquer documento. Isso sobrescreve o mecanismo pré-licenciado fornecido porque o QV2QS prefere a instalação do sistema quando uma é registrada.
* Arquivo corrompido ou ilegível — O arquivo QVW ou QVF está danificado, bloqueado por outro processo, ou armazenado em um compartilhamento de rede inacessível.

Ação proposta

Verifique a mensagem de erro para a causa mais provável. Se Acesso à Seção estiver indicado:

1. Abra o QVW no QlikView Desktop usando uma conta com acesso ADMIN na tabela de Acesso à Seção.
2. Vá para Propriedades do Documento > Segurança e verifique se Acessar Propriedades do Documento (Usuários) está ativado.
3. Alternativamente, execute o QV2QS sob uma conta que tenha Acesso à Seção de nível ADMIN.

Se o licenciamento for indicado, desinstale ou licencie o QlikView Desktop, ou execute o QV2QS em uma máquina sem o QlikView instalado para usar o mecanismo pré-licenciado incluído.

Se o arquivo pode estar corrompido, verifique o arquivo abrindo-o diretamente no QlikView Desktop. Execute com `--logLevel DEBUG` e verifique o log para diagnósticos detalhados.

## Saiba mais

* [Motor do QlikView Desktop](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/qlikview-desktop-engine.htm)
* [Geração automática de PRJ](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/batch-conversion/automatic-prj-generation.htm)
* [Registro e diagnóstico](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)