Referência de argumento

Última atualização: 14/10/2026

As tabelas abaixo listam cada argumento disponível agrupado por categoria.

Entrada e saída

Modo em lote

Qlik Cloud

Autenticação

Layout e estilização

Para uma explicação detalhada dos modos de tela fixa e grade dinâmica, consulte Configurações de layout de conversão.

Relatório de conversão

O relatório do console e o relatório do Excel são ambos habilitados por padrão no modo CLI e na interface do usuário.

Console e registro

O QV2QS suporta quatro modos de saída de console.

• Bonito — Saída ricamente formatada com cores, spinners animados, barras de progresso e painéis temáticos. Modo formatado é o padrão para uso interativo do terminal. Requer um terminal com capacidade de cores (Windows 10+, PowerShell 5+, ou shells tipo Unix).
• Simples — Saída de texto com carimbo de data/hora, sem códigos de escape ANSI. Cada linha é prefixada com um carimbo de tempo decorrido e uma tag de fase no formato [MM:SS] [phase] message. Cabeçalhos e tabelas usam caracteres ASCII. Adequado para pipelines de CI/CD, arquivos de log e terminais que não suportam formatação ANSI.
• Silencioso — Suprime toda a saída padrão. Apenas erros são exibidos. Adequado para processamento em lote automatizado e fluxos de trabalho com script onde nenhuma saída de console é necessária.
• UI — Saída orientada a linha, sem carimbos de data/hora ou códigos ANSI. A interface do usuário define este modo automaticamente ao iniciar um subprocesso de conversão. O formato é otimizado para o visualizador de log incorporado. Executar --console ui de um terminal produz uma saída legível, mas sem formatação; use --plain ou --console pretty em vez disso para uso direto no terminal.

As --dark e --light bandeiras selecionam um tema de cor. O tema escuro (padrão) usa uma paleta azul-marinho profunda inspirada no Qlik. O tema claro usa uma paleta cinza claro. A flag --surface permite um preenchimento de fundo sutil atrás de cada linha de saída. O preenchimento de superfície é ativado por padrão no modo bonito. Use --noSurface para desativar o preenchimento de fundo.

No modo de projeto único, os arquivos de log são gravados em %LOCALAPPDATA%\QV2QS\logs\ por padrão. No modo em lote, os arquivos de log são gravados na subpasta logs/ no diretório de saída. Substituir a localização com --logDir. Defina --logLevel DEBUG para capturar a saída de diagnóstico detalhada para solucionar problemas de conversão. Use --cleanLogs para excluir arquivos de log mais antigos que 30 dias antes de cada execução. Para uma descrição completa dos locais, rotação e formato dos arquivos de log, consulte Registro e diagnóstico.

Carregar script

Por padrão, o QV2QS aplica oito regras internas que normalizam caminhos de barra invertida do Windows para barras normais para compatibilidade com o Qlik Cloud. A tabela a seguir lista cada regra integrada.

Cada regra usa um processo de correspondência em duas etapas. O pattern campo é uma regex que seleciona uma região do script de carregamento. O campo search é então aplicado apenas dentro de cada região correspondente. Essa abordagem evita substituições não intencionais fora do contexto visado.

O --scriptReplacements argumento aceita um arquivo JSON que se torna a única fonte de verdade para todas as regras de substituição. Quando um arquivo é fornecido, os padrões internos não são carregados automaticamente. Para incluir regras internas juntamente com regras personalizadas, exportar o conjunto completo de regras do assistente e edite o arquivo exportado. As regras são executadas em execution_order ordem.

Três comportamentos de CLI estão disponíveis:

• Nenhuma flag — as oito regras incorporadas são executadas.
• --scriptReplacements <file> — apenas as regras no arquivo são executadas. Padrões incorporados não são carregados automaticamente.
• --noScriptReplacements — nenhuma regra é executada.

O arquivo --scriptReplacements é um array JSON de objetos de regra:

[
  {
    "description": "Replace server path with lib connection",
    "pattern": "FROM\\s+'[^']*'",
    "search": "\\\\\\\\server\\\\share\\\\",
    "replace": "lib://DataFiles/",
    "is_regex": true,
    "case_sensitive": false,
    "enabled": true,
    "execution_order": 1
  }
]

Cada regra tem os seguintes campos:

Outros

Guarda de ordenação de campo de data

Por padrão, o Qlik Sense classifica os valores selecionados para o topo de uma caixa de listagem. Para campos semelhantes a datas, como Trimestre, Mês ou Ano, essa reordenação quebra a sequência cronológica esperada. QV2QS aplica uma heurística para detectar nomes de campos semelhantes a datas e suprimir a ordenação baseada em estado nesses campos, mantendo os valores em sua ordem natural independentemente do estado de seleção.

A heurística tokeniza cada nome de campo dividindo-o em caracteres não alfanuméricos e limites camelCase (por exemplo, OrderDate torna-se order e date). Todos os tokens estão em minúsculas. Um campo corresponde se qualquer token for igual a um dos seguintes: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Um campo também corresponde se qualquer token terminar com date, month, ou year (por exemplo, OrderDate, FiscalMonth). Os tokens update, candidate, e validate são excluídos para evitar falsos positivos. A correspondência não diferencia maiúsculas de minúsculas e usa apenas tokens em inglês. Nomes de campos não-ingleses (por exemplo, Monat ou Fecha) não são detectados.

Campos que correspondem à heurística têm a ordenação baseada em estado removida e a ordenação automática desativada.

Use --disableDateStateStickySort para desativar esta heurística. Quando desativado, todos os campos de caixa de listagem usam o comportamento de classificação padrão do Qlik Sense, incluindo a reordenação baseada no estado.

Correções de aspas na análise de conjunto

QlikView e Qlik Sense interpretam diferentemente o uso de aspas em modificadores de análise de conjunto. QV2QS aplica duas correções independentes durante a conversão. A correção de pesquisa entre aspas simples está ativada por padrão. A correção de valores de conjunto sem aspas é experimental e desabilitada por padrão.

Corrigir valores de pesquisa entre aspas simples (--fixSingleQuotedSearch)

Valores entre aspas simples contendo sintaxe de pesquisa são convertidos para aspas duplas. Padrões de pesquisa detectados incluem curingas (*, ?, ^), operadores de comparação (>, >=, <, <=), pesquisa avançada (~), pesquisa de expressão (=), modificadores de pesquisa (+, -), e pesquisa composta ((…|…), (…&…)):

• {<Year={'2*'}>} torna-se {<Year={"2*"}>}
• {<Amount={'>100'}>} torna-se {<Amount={">100"}>}
• {<Customer={'~company'}>} torna-se {<Customer={"~company"}>}

Literais de texto simples entre aspas simples (por exemplo, 'USA') e valores entre aspas simples em campos numéricos não são afetados. Use --noFixSingleQuotedSearch para desativar esta correção.

Corrigir valores de conjunto não entre aspas (--fixUnquotedSetValues) — experimental

Valores de string simples sem aspas são envolvidos por aspas simples:

• {<Country={USA}>} torna-se {<Country={'USA'}>}

Valores numéricos (2024), variáveis com cifrão ($(vYear)), e strings entre aspas duplas são deixadas inalteradas. Essa correção está desabilitada por padrão. Passe --fixUnquotedSetValues para ativá-lo. Use --noFixUnquotedSetValues para desativá-lo explicitamente.

Ambas as correções se aplicam apenas a expressões de dimensão e de medida. Descobertas de funções não suportadas não são modificadas. Quando uma correção é desativada, os padrões sinalizados permanecem para revisão manual na planilha Expression_Findings.

Saiba mais

• Fluxos de trabalho comuns
• Registro de logs e diagnósticos
• Modos de layout