Análise
Última atualização: 14/10/2026O QV2QS analisa automaticamente cada documento QlikView em busca de recursos e padrões que possam exigir atenção após a migração. Alguns achados são informativos. Outras constatações identificam funcionalidades não suportadas ou áreas que funcionam de forma diferente no Qlik Sense. Os resultados aparecem na seção Outras descobertas do resumo executivo e na planilha Análise do relatório do Excel.
A análise é separada do relatório de conversão. O relatório de conversão mede o quão bem os objetos foram convertidos. A análise identifica preocupações adicionais de compatibilidade para a implementação do Qlik Cloud.
O que é verificado
O QV2QS inspeciona sete áreas do documento QlikView.
Script oculto
Documentos do QlikView podem conter um script de carregamento oculto que é executado antes do script visível. O script oculto é armazenado dentro de um bloco compactado no binário QVW/QVF e não é visível na pasta PRJ. O QV2QS extrai o script oculto do binário e o adiciona ao início do script de carregamento visível em script.qvs. Quando um script oculto é detectado, uma constatação informativa é exibida na planilha Análise e na seção Outras constatações do resumo executivo.
Carregar padrões de script
O QV2QS analisa o script de carregamento (LoadScript.txt) em busca de instruções e funções que exigem atenção durante a migração. Quando um script oculto está presente, o conteúdo do script oculto é incluído na verificação. Algumas instruções não são suportadas no Qlik Sense. Outros padrões podem precisar de ajustes de caminho ou abordagens alternativas. Linhas de comentário e comentários em bloco são excluídos da varredura.
Os padrões a seguir são detectados:
| Padrão | Descrição |
|---|---|
| Carga Binária | Instrução BINARY que carrega dados de outro arquivo QVW. A abordagem de carregamento de dados pode precisar ser revisada. |
| Carregamento de Pacote | Instruções BUNDLE ou INFO LOAD que incorporam imagens no QVW. Não suportado no Qlik Sense. |
| InputField | Instrução INPUTFIELD para entrada de dados do usuário. Não suportado no Qlik Sense. |
| Direct Discovery | Instrução DIRECT QUERY para conexões de fonte de dados em tempo real. Não suportado no Qlik Sense. |
| Incluir | $(Include=...) ou $(Must_Include=...) referências a arquivos de script externos. Os caminhos dos arquivos podem precisar de ajustes. |
| Comando | COMMAND instrução que executa comandos do sistema operacional. Não suportado no Qlik Sense. |
| Executar | EXECUTE instrução que executa programas externos. Não suportado no Qlik Cloud. |
| Image_Size | Função Image_Size Não suportado no Qlik Sense. |
| GetCurrentField | Função GetCurrentField Não suportado no Qlik Sense. |
| GetExtendedProperty | Função GetExtendedProperty Não suportado no Qlik Sense. |
| InputAvg / InputSum | Funções de agregação para campos de entrada. Não suportado no Qlik Sense. |
| MsgBox | Função MsgBox para caixas de diálogo. Não suportado no Qlik Sense. |
| NoOfReports | Função NoOfReports Não suportado no Qlik Sense. |
| ReportComment / ReportId / ReportName / ReportNumber | Funções relacionadas a relatórios. Não suportado no Qlik Sense. |
Cada constatação inclui o número da linha e o texto da linha do script de carregamento.
Propriedades do documento
O QV2QS verifica DocProperties.xml quanto a recursos em nível de documento que requerem atenção. Alguns não são suportados no Qlik Sense. Outros são suportados, mas exigem configuração manual ou se comportam de forma diferente.
| Propriedade | Descrição |
|---|---|
| Acesso à seção | A segurança em nível de linha está habilitada. O Qlik Sense oferece suporte ao Acesso à Seção, mas a sintaxe é diferente. |
| Atualização dinâmica de dados | A atualização dinâmica de dados está habilitada. Não suportado no Qlik Sense. |
| Modo Direct Discovery | O modo Direct Query está habilitado no nível do documento. Não suportado no Qlik Sense. |
| Alertas | Existem definições de alerta. Alertas não são suportados no Qlik Sense. |
| Ações OnOpen do documento | As ações de gatilho OnOpen no nível do documento estão definidas. Requer recriação manual. |
| Ações OnPostReload do Documento | Ações de gatilho OnPostReload em nível de documento estão definidas. Requer recriação manual. |
| Extensões de Documento | As extensões de documento estão instaladas. Extensões diferentes de QVAccessibility não são suportadas. |
Propriedades do campo
O QV2QS detecta campos com a propriedade Sempre Um Selecionado habilitada. Esta propriedade é uma configuração em nível de mecanismo que não pode ser aplicada por meio da saída de compilação JSON. A propriedade deve ser aplicada manualmente no editor de aplicativo do Qlik Sense após a implementação.
Macros VBA
O QV2QS lê Module.txt da pasta PRJ e analisa todas as definições de Sub e Function do VBA. Para cada macro, a análise informa o nome, o tipo (Sub ou Function) e a contagem de linhas.
O QV2QS também faz referência cruzada de invocações de macro ao verificar cada arquivo XML de objeto e DocProperties.xml em busca de gatilhos de ação que chamam macros. A referência cruzada identifica quais objetos invocam quais macros e as planilhas onde esses objetos aparecem. Macros que são definidas, mas nunca invocadas, são marcadas como não utilizadas.
Uso de aspas em expressões na análise de conjunto
O QV2QS analisa todas as expressões de objeto (dimensões, medidas, condições de exibição, expressões de cor, expressões de texto) e definições de variável em busca de padrões de aspas de set analysis que se comportam de maneira diferente no Qlik Sense. O QlikView (antes de novembro de 2017) tratava valores entre aspas simples em modificadores de conjunto como pesquisas que não diferenciam maiúsculas de minúsculas, idênticas a valores entre aspas duplas. O Qlik Sense trata valores entre aspas simples como literais com distinção entre maiúsculas e minúsculas.
Os padrões a seguir são detectados:
| Padrão | Regra | Probabilidade | Descrição | Remediação |
|---|---|---|---|---|
Curinga entre aspas simples ('*US*', 'A?', '^abc') |
Curinga entre aspas simples | Alta | Os caracteres curinga *, ? e a âncora de limite de palavra ^ são interpretados como texto literal no Qlik Sense, em vez de padrões de pesquisa. |
Substitua as aspas simples por aspas duplas para restaurar o comportamento da pesquisa. |
Comparação entre aspas simples ('>=5', '<2020') |
Comparação entre aspas simples | Alta | Os operadores de comparação >, >=, <, <= são interpretados como texto literal no Qlik Sense em vez de pesquisas numéricas. |
Substitua aspas simples por aspas duplas para restaurar a comparação numérica. |
Pesquisa avançada entre aspas simples ('~company') |
Busca aproximada entre aspas simples | Alta | O prefixo ~ aciona a correspondência aproximada entre aspas duplas. Entre aspas simples, o Qlik Sense o trata como uma string literal. |
Substitua aspas simples por aspas duplas para restaurar a pesquisa avançada. |
Pesquisa de expressão entre aspas simples ('=Sum(Sales)>100') |
Pesquisa de expressão entre aspas simples | Alta | O prefixo = aciona a pesquisa de expressão entre aspas duplas. Entre aspas simples, o Qlik Sense o trata como uma string literal. |
Substitua as aspas simples por aspas duplas para restaurar a pesquisa de expressões. |
Modificador de busca entre aspas simples ('+abc', '-solution') |
Modificador de pesquisa entre aspas simples | Alta | Os modificadores + (deve conter) e - (não deve conter) funcionam entre aspas duplas. Entre aspas simples, o Qlik Sense os trata como strings literais. |
Substitua aspas simples por aspas duplas para restaurar o comportamento do modificador. |
Busca composta entre aspas simples ('(1|2|3)', '(*ABC*&?*Inc*)') |
Busca composta entre aspas simples | Alta | A pesquisa composta com operadores lógicos | (OR), & (AND), ^ (XOR) funciona entre aspas duplas. Entre aspas simples, o Qlik Sense o trata como uma string literal. |
Substitua aspas simples por aspas duplas para restaurar a pesquisa composta. |
Valor entre aspas simples em campo numérico ('2020' em um campo de data ou número) |
Aspas simples em campo numérico | Alta | Valores entre aspas simples correspondem à representação de texto no Qlik Sense. Em campos numéricos ou duais, a representação de texto pode não corresponder ao valor armazenado, causando uma incompatibilidade de tipo. | Use o valor numérico sem aspas ou aspas duplas em vez disso. |
String sem aspas ({USA,France}) |
Valor simples sem aspas | Baixa | O Qlik Sense aceita valores sem aspas, mas o comportamento é frágil com espaços, operadores ou caracteres especiais. | Coloque o valor entre aspas simples para uma correspondência literal. |
Referência de campo simples (<Field1=Field2>) |
Referência a campo simples | Alta | O QlikView permite que <Field1=Field2> transfira seleções entre campos. O Qlik Sense não oferece suporte a referências diretas de campo para campo em modificadores de conjunto. |
Substitua por <Field1=P(Field2)> para usar a função de elemento P(). |
Valor simples sem chaves (<Country=USA>) |
Valor simples sem chaves | Alta | Um valor simples sem chaves no lado direito de uma atribuição de modificador de conjunto. O QlikView pode interpretar o valor como um literal ou uma referência de campo, dependendo do contexto. O Qlik Sense requer que os valores estejam entre chaves. | Coloque entre chaves: <Country={USA}> ou <Country={'USA'}>. |
Valores de texto sem formatação entre aspas simples em campos de texto (por exemplo, 'USA') não são sinalizados. Esses valores funcionam corretamente como literais que diferenciam maiúsculas e minúsculas no Qlik Sense.
O QV2QS oferece suporte a nomes de campo entre colchetes ([Invoice Number]), entre aspas duplas ("Invoice Number") e entre acentos graves (`Invoice Number`) no lado esquerdo de atribuições de modificadores de conjunto. Todos os três estilos de aspas são reconhecidos durante a varredura e a correção.
Por padrão, o QV2QS corrige automaticamente valores de pesquisa entre aspas simples durante a conversão em expressões de objeto e definições de variáveis. Valores entre aspas simples que contêm sintaxe de pesquisa (caracteres curinga, comparações, pesquisa avançada, pesquisa de expressão, modificadores de pesquisa ou operadores de pesquisa compostos) são convertidos para aspas duplas. Valores entre aspas simples em campos numéricos que não contêm sintaxe de pesquisa são sinalizados para revisão manual, mas não são corrigidos automaticamente. Uma correção experimental para valores de string sem aspas também está disponível, mas desativada por padrão — passe --fixUnquotedSetValues para ativá-la. As correções são aplicadas usando substituição posicional apenas em listas de valores de modificadores de conjunto — nomes de campos, nomes de funções e outros textos de expressão nunca são modificados. Cada correção tem um botão de alternância independente (--noFixSingleQuotedSearch, --fixUnquotedSetValues). Para obter mais informações, consulte Referência de argumentos.
Os resultados aparecem na seção Expression quoting findings do resumo do console, na subaba Expression do painel de resumo executivo e na planilha Expression_Findings do relatório do Excel. Cada ocorrência inclui um indicador de Status: Corrigido automaticamente (corrigido durante a conversão), Requer revisão (requer atenção manual) ou Nenhuma correção disponível (função não suportada). O painel de resumo executivo oferece um botão de alternância de filtro para ocultar linhas corrigidas automaticamente e focar nos itens que ainda precisam de atenção. Para obter mais informações sobre diferenças de sintaxe da análise de conjunto, consulte Análise de conjunto na ajuda do Qlik Cloud.
Funções de gráfico não suportadas
O QV2QS analisa todas as expressões de objeto (dimensões, medidas, condições de exibição, expressões de cor, expressões de texto) e definições de variáveis em busca de funções de gráfico do QlikView que não são suportadas no Qlik Sense. O scanner faz a correspondência de chamadas de função com espaços em branco ou quebras de linha opcionais entre o nome da função e o parêntese de abertura. Nomes de função dentro de literais de string são excluídos.
As seguintes funções são detectadas:
| Função | Descrição |
|---|---|
| GetCurrentField | Retorna o nome do campo ativo no objeto atual. Não suportado no Qlik Sense. Consulte Funções de campo no Qlik Cloud para obter alternativas suportadas. |
| GetExtendedProperty | Recupera os metadados do objeto vinculado. Não suportado no Qlik Sense. Consulte Funções de campo no Qlik Cloud para obter alternativas suportadas. |
| Entrada | Recupera os valores dos campos de entrada inseridos pelo usuário. Não suportado no Qlik Sense. |
| InputAvg | Calcula a média dos valores dos campos de entrada. Não suportado no Qlik Sense. |
| InputSum | Calcula a soma dos valores dos campos de entrada. Não suportado no Qlik Sense. |
| MsgBox | Exibe uma caixa de diálogo. Não suportado no Qlik Sense. |
| NoOfReports | Retorna o número de objetos de relatório. Não suportado no Qlik Sense. |
| ReportComment | Retorna um comentário do relatório. Não suportado no Qlik Sense. |
| ReportId | Retorna um identificador de relatório. Não suportado no Qlik Sense. |
| ReportName | Retorna o nome de um relatório. Não suportado no Qlik Sense. |
| ReportNumber | Retorna um número de relatório. Não suportado no Qlik Sense. |
As constatações de funções não suportadas aparecem ao lado das constatações de aspas na análise de conjunto na planilha Expression_Findings e na seção Possíveis problemas de expressão do resumo do console.
Favoritos do desenvolvedor
O QV2QS lê DocInternals.xml e lista todos os marcadores criados pelo desenvolvedor. Para cada marcador, a análise informa as seleções de campo, o escopo (global ou específico da pasta) e se o estado do layout está salvo. Os marcadores devem ser recriados manualmente no Qlik Sense.
Marcadores no nível do servidor (compartilhados e privados) não são detectáveis a partir da pasta PRJ.
Dimensionamento de SaaS
O QV2QS lê o arquivo binário QVW para estimar o consumo base de RAM do aplicativo. A estimativa é baseada em metadados ByteSize incorporados nas descrições de tabelas e campos.
Os metadados ByteSize estão disponíveis apenas em arquivos QVW salvos com o QlikView 12.30 ou posterior (novembro de 2018). Se os metadados não estiverem presentes, o nível de dimensionamento será informado como Desconhecido.
O QV2QS classifica o aplicativo em um dos seguintes níveis com base no consumo de RAM base.
| Tier | Limite | Ação |
|---|---|---|
| Padrão | Até 5 GB | Nenhuma ação especial necessária. |
| Aplicações de Grande Porte | Até 50 GB | Implante em um espaço com suporte a aplicativos grandes habilitado. |
| Requer Otimização | Acima de 50 GB | Consulte um administrador Qlik ou um parceiro Qlik antes da migração. |
A tabela de detalhes de dimensionamento na planilha Análise também informa o número de tabelas e campos (excluindo tabelas e campos do sistema). Para obter a cardinalidade detalhada dos campos, a contagem de linhas das tabelas e os tamanhos em bytes por objeto, consulte as planilhas Data_Model_Fields e Data_Model_Tables no relatório do Excel.
Níveis de confiança
Cada constatação do script de carregamento inclui um nível de confiança que indica a probabilidade de um problema genuíno de compatibilidade.
- Alto — O padrão é específico. É muito provável que a constatação seja uma preocupação real de compatibilidade.
- Médio — O padrão pode corresponder a código não relevante. Verifique manualmente.
- Baixo — O padrão é amplo. Revise a linha sinalizada para confirmar a relevância.
As descobertas de propriedades de documentos e as descobertas de macros não têm níveis de confiança porque essas descobertas são baseadas em sinalizadores XML explícitos, em vez de correspondência de padrões.
Limitações da análise
A análise examina apenas a pasta PRJ e o binário QVW. O scanner de script de carregamento detecta instruções e funções não suportadas em LoadScript.txt. O scanner de script de carregamento não verifica expressões de gráfico.
O scanner de expressão verifica expressões de gráfico (dimensões, medidas, condições de exibição, expressões de cor, expressões de texto e definições de variável) quanto a padrões de aspas de análise de conjunto e chamadas de função não suportadas. O scanner de expressões não detecta outras categorias de incompatibilidade em expressões de gráfico.
Itens que existem no nível do QlikView Server não são detectados. Os itens não detectados incluem favoritos do servidor, objetos do servidor, configurações de cluster, condições de alerta, definições de relatório e dados de uso da sessão.