Referencia de argumentos

Última actualización: 14/10/2026

Las tablas siguientes enumeran cada argumento disponible agrupado por categoría.

Entrada y salida

Modo por lotes

Qlik Cloud

Autenticación

Diseño y estilo

Para una explicación detallada de los modos de lienzo fijo y cuadrícula dinámica, consulte Configuración del diseño de conversión.

Informe de conversión

El informe de la consola y el informe de Excel están ambos habilitados por defecto en modo CLI y en la interfaz de usuario.

Consola y registro

QV2QS admite cuatro modos de salida de consola.

• Bonito — Salida con formato enriquecido con colores, indicadores de carga animados, barras de progreso y paneles temáticos. El modo bonito es el predeterminado para el uso interactivo en terminales. Requiere un terminal compatible con color (Windows 10+, PowerShell 5+ o shells tipo Unix).
• Sin formato — Salida de texto con marca de tiempo sin códigos de escape ANSI. Cada línea lleva como prefijo una marca de tiempo transcurrido y una etiqueta de fase en el formato [MM:SS] [phase] message. Encabezados y tablas usan caracteres ASCII. Adecuado para pipelines de CI/CD, archivos de registro y terminales que no admiten formato ANSI.
• Silencioso — Suprime toda la salida estándar. Solo se muestran los errores. Adecuado para el procesamiento por lotes automatizado y flujos de trabajo con scripts en los que no se necesita salida de consola.
• UI — Salida orientada a líneas sin marcas de tiempo ni códigos ANSI. La interfaz de usuario establece este modo automáticamente al iniciar un subproceso de conversión. El formato está optimizado para el visor de registros incrustado. Ejecutar --console ui desde un terminal produce una salida legible pero sin formato; usa --plain o --console pretty en su lugar para uso directo en el terminal.

Los --dark y --light indicadores seleccionan un tema de color. El tema oscuro (predeterminado) utiliza una paleta azul marino intenso inspirada en Qlik. El tema claro utiliza una paleta de color gris claro. La bandera --surface habilita un relleno de fondo sutil detrás de cada línea de salida. El relleno de superficie está habilitado por defecto en modo bonito. Utilice --noSurface para deshabilitar el relleno de fondo.

En modo de proyecto único, los archivos de registro se escriben en %LOCALAPPDATA%\QV2QS\logs\ de forma predeterminada. En modo por lotes, los archivos de registro se escriben en la subcarpeta logs/ del directorio de salida. Sobrescribir la ubicación con --logDir. Establezca --logLevel DEBUG para capturar una salida de diagnóstico detallada para solucionar problemas de conversión. Utilice --cleanLogs para eliminar archivos de registro con más de 30 días de antigüedad antes de cada ejecución. Para una descripción completa de las ubicaciones, rotación y formato de los archivos de registro, consulte Registro y diagnóstico.

Cargar script

Por defecto, QV2QS aplica ocho reglas integradas que normalizan las rutas de barra invertida de Windows a barras inclinadas para la compatibilidad con Qlik Cloud. La siguiente tabla enumera cada regla integrada.

Cada regla utiliza un proceso de coincidencia de dos etapas. El pattern campo es una expresión regular que selecciona una región del script de carga. El campo search se aplica entonces solo dentro de cada región coincidente. Este enfoque evita reemplazos no deseados fuera del contexto objetivo.

El --scriptReplacements argumento acepta un archivo JSON que se convierte en la única fuente de verdad para todas las reglas de reemplazo. Cuando se proporciona un archivo, los valores predeterminados integrados no se cargan automáticamente. Para incluir reglas integradas junto con reglas personalizadas, exporte el conjunto completo de reglas desde el asistente y edite el archivo exportado. Las reglas se ejecutan en execution_order orden.

Hay tres comportamientos de CLI disponibles:

• Sin indicador — las ocho reglas integradas se ejecutan.
• --scriptReplacements <file> — solo se ejecutan las reglas del archivo. Los valores predeterminados integrados no se cargan automáticamente.
• --noScriptReplacements — ninguna regla se ejecuta.

El --scriptReplacements archivo es una matriz JSON de objetos de reglas:

[
  {
    "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 regla tiene los siguientes campos:

Otros

Protección de ordenación de campo de fecha

Por defecto, Qlik Sense ordena los valores seleccionados en la parte superior de un cuadro de lista. Para campos de tipo fecha como Trimestre, Mes o Año, esta reordenación rompe la secuencia cronológica esperada. QV2QS aplica una heurística para detectar nombres de campo similares a fechas y suprimir la ordenación basada en el estado en esos campos, manteniendo los valores en su orden natural independientemente del estado de selección.

La heurística tokeniza cada nombre de campo dividiendo por caracteres no alfanuméricos y límites de camelCase (por ejemplo, OrderDate se convierte en order y date). Todos los tokens están en minúsculas. Un campo coincide si cualquier token es igual a uno de los siguientes: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Un campo también coincide si cualquier token termina con date, month, o year (por ejemplo, OrderDate, FiscalMonth). Los tokens update, candidate, y validate se excluyen para evitar falsos positivos. La coincidencia no distingue entre mayúsculas y minúsculas y utiliza solo tokens en inglés. Nombres de campo no ingleses (por ejemplo, Monat o Fecha) no se detectan.

Los campos que coinciden con la heurística tienen la ordenación basada en el estado eliminada y la ordenación automática deshabilitada.

Utilice --disableDateStateStickySort para desactivar esta heurística. Cuando está deshabilitado, todos los campos de cuadro de lista utilizan el comportamiento de ordenación predeterminado de Qlik Sense, incluida la reordenación basada en el estado.

Correcciones de entrecomillado en el análisis de conjuntos

QlikView y Qlik Sense interpretan el uso de comillas en los modificadores de análisis de conjuntos de manera diferente. QV2QS aplica dos correcciones independientes durante la conversión. La corrección de búsqueda entre comillas simples está habilitada por defecto. La corrección de valores de conjunto sin comillas es experimental y está deshabilitada por defecto.

Corregir valores de búsqueda entre comillas simples (--fixSingleQuotedSearch)

Los valores entre comillas simples que contienen sintaxis de búsqueda se convierten a comillas dobles. Los patrones de búsqueda detectados incluyen comodines (*, ?, ^), operadores de comparación (>, >=, <, <=), búsqueda difusa (~), búsqueda de expresiones (=), modificadores de búsqueda (+, -) y búsqueda compuesta ((…|…), (…&…)):

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

Literales de texto sin formato entre comillas simples (por ejemplo, 'USA') y los valores entre comillas simples en campos numéricos no se ven afectados. Utilice --noFixSingleQuotedSearch para deshabilitar esta corrección.

Corregir valores de conjunto no entrecomillados (--fixUnquotedSetValues) — experimental

Los valores de cadena sin comillas se envuelven entre comillas simples:

• {<Country={USA}>} se convierte en {<Country={'USA'}>}

Valores numéricos (2024), variables con signo de dólar ($(vYear)), y cadenas entre comillas dobles se dejan sin cambios. Esta corrección está deshabilitada de forma predeterminada. Pase --fixUnquotedSetValues para habilitarlo. Utiliza --noFixUnquotedSetValues para deshabilitarlo explícitamente.

Ambas correcciones se aplican solamente a expresiones de dimensión y medida. Los hallazgos de funciones no admitidas no se modifican. Cuando se deshabilita una corrección, los patrones marcados permanecen para revisión manual en la hoja de cálculo Expression_Findings.

Más información

• Flujos de trabajo comunes
• Registros y diagnósticos
• Modos de diseño