Argüman referansı

Son güncelleme: 14.10.2026

Aşağıdaki tablolar, kategoriye göre gruplandırılmış mevcut her bağımsız değişkeni listeler.

Giriş ve çıkış

Toplu iş modu

Qlik Cloud

Kimlik doğrulaması

Düzen ve stil

Sabit tuval ve dinamik kılavuz çizgi modları hakkında ayrıntılı bilgi için, Dönüştürme düzeni ayarları bölümüne bakınız.

Dönüşüm raporu

Konsol raporu ve Excel raporu, hem CLI modunda hem de kullanıcı arayüzünde varsayılan olarak etkindir.

Konsol ve günlük kaydı

QV2QS dört konsol çıkış modunu destekler.

• Estetik — Renkler, animasyonlu yükleme göstergeleri, ilerleme çubukları ve temalı paneller içeren zengin biçimli çıktı. Pretty modu, etkileşimli terminal kullanımı için varsayılandır. Renk destekli bir terminal gerektirir (Windows 10+, PowerShell 5+ veya Unix benzeri kabuklar).
• Düz — ANSI kaçış kodları içermeyen, zaman damgalı metin çıktısı. Her satır, geçen süre damgası ve faz etiketiyle [MM:SS] [phase] message biçiminde öneklenir. Başlıklar ve tablolar ASCII karakterleri kullanır. CI/CD işlem hatları, günlük dosyaları ve ANSI biçimlendirmesini desteklemeyen terminaller için uygundur.
• Sessiz — Tüm standart çıktıyı bastırır. Yalnızca hatalar görüntülenir. Konsol çıktısı gerekmeyen otomatik toplu işleme ve betik tabanlı iş akışları için uygundur.
• UI — Zaman damgaları veya ANSI kodları içermeyen, satır odaklı çıktı. Kullanıcı arayüzü, bir dönüştürme alt süreci başlattığında bu modu otomatik olarak ayarlar. Biçim, gömülü günlük görüntüleyici için optimize edilmiştir. --console ui'i bir terminalden çalıştırmak okunabilir ancak biçimlendirilmemiş çıktı üretir; doğrudan terminal kullanımı için bunun yerine --plain veya --console pretty kullanın.

--dark ve --light bayrakları bir renk teması seçer. Koyu tema (varsayılan), Qlik'ten ilham alan derin lacivert bir palet kullanır. Açık tema açık gri bir palet kullanır. --surface bayrağı, her çıktı satırının arkasında hafif bir arka plan dolgusu sağlar. Yüzey dolgusu, güzel modda varsayılan olarak etkinleştirilmiştir. Arka plan dolgusunu devre dışı bırakmak için --noSurface kullanın.

Tek proje modunda, günlük dosyaları varsayılan olarak %LOCALAPPDATA%\QV2QS\logs\ konumuna yazılır. Toplu modda, günlük dosyaları çıktı dizinindeki logs/ alt klasörüne yazılır. Konumu --logDir ile üzerine yaz. Dönüştürme sorunlarını gidermeye yönelik ayrıntılı tanılama çıktısı yakalamak için --logLevel DEBUG öğesini ayarlayın. Her çalıştırmadan önce 30 günden eski günlük dosyalarını silmek için --cleanLogs kullanın. Günlük dosyası konumları, döndürme ve biçiminin tam açıklaması için bkz. Günlük kaydı ve tanılama.

Komut dosyasını yükle

Varsayılan olarak, QV2QS, Windows ters eğik çizgi yollarını Qlik Cloud uyumluluğu için eğik çizgilere normalleştiren sekiz yerleşik kural uygular. Aşağıdaki tablo, her yerleşik kuralı listeler.

Her kural iki aşamalı bir eşleştirme süreci kullanır. pattern alanı, komut dosyasının bir bölgesini seçen bir regex'tir. search alanı daha sonra yalnızca eşleşen her bölge içinde uygulanır. Bu yaklaşım, hedeflenen bağlamın dışındaki istenmeyen değiştirmeleri önler.

--scriptReplacements bağımsız değişkeni, tüm değiştirme kuralları için tek doğruluk kaynağı haline gelen bir JSON dosyasını kabul eder. Bir dosya sağlandığında, yerleşik varsayılanlar otomatik olarak yüklenmez. Yerleşik kuralları özel kurallarla birlikte dahil etmek için, kural kümesinin tamamını sihirbazdan dışa aktarın ve dışa aktarılan dosyayı düzenleyin. Kurallar execution_order sırayla yürütülür.

Üç CLI davranışı mevcuttur:

• Bayrak yok — sekiz yerleşik kural yürütülür.
• --scriptReplacements <file> — yalnızca dosyadaki kurallar yürütülür. Yerleşik varsayılanlar otomatik yüklenmez.
• --noScriptReplacements — hiçbir kural yürütülmez.

--scriptReplacements dosyası, kural nesnelerinden oluşan bir JSON dizisidir:

[
  {
    "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
  }
]

Her kural aşağıdaki alanlara sahiptir:

Diğer

Tarih alanı sıralama koruması

Varsayılan olarak, Qlik Sense seçili değerleri bir liste kutusunun en üstüne sıralar. Çeyrek, Ay veya Yıl gibi tarih benzeri alanlar için bu yeniden sıralama beklenen kronolojik sırayı bozar. QV2QS, tarih benzeri alan adlarını algılamak ve bu alanlarda durum tabanlı sıralamayı bastırmak için bir sezgisel uygular, değerleri seçim durumundan bağımsız olarak doğal sıralarında tutar.

Sezgisel yöntem, her alan adını alfasayısal olmayan karakterlere ve camelCase sınırlarına göre bölerek belirteçlere ayırır (örneğin, OrderDate order ve date haline gelir). Tüm belirteçler küçük harflidir. Herhangi bir belirteç aşağıdakilerden birine eşitse, bir alan eşleşir: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Bir alan, herhangi bir belirteç şununla bitiyorsa da eşleşir: date, month veya year (örneğin, OrderDate, FiscalMonth). Belirteçler update, candidate ve validate yanlış pozitifleri önlemek için hariç tutulmuştur. Eşleştirme büyük/küçük harf duyarlı değildir ve yalnızca İngilizce belirteçler kullanır. İngilizce olmayan alan adları (örneğin, Monat veya Fecha) algılanmaz.

Sezgisel ile eşleşen alanlarda durum tabanlı sıralama kaldırılır ve otomatik sıralama devre dışı bırakılır.

Bu sezgiseli kapatmak için --disableDateStateStickySort kullanın. Devre dışı bırakıldığında, tüm liste kutusu alanları, durum tabanlı yeniden sıralama dahil olmak üzere varsayılan Qlik Sense sıralama davranışını kullanır.

Küme analizi tırnaklama düzeltmeleri

QlikView ve Qlik Sense, küme analizi değiştiricilerindeki tırnak içine almayı farklı yorumlar. QV2QS dönüştürme sırasında iki bağımsız düzeltme uygular. Tek tırnaklı arama düzeltmesi varsayılan olarak etkinleştirilmiştir. Tırnak içine alınmamış değerler düzeltmesi deneysel ve varsayılan olarak devre dışıdır.

Tek tırnaklı arama değerlerini düzelt (--fixSingleQuotedSearch)

Arama sözdizimi içeren tek tırnaklı değerler çift tırnaklara dönüştürülür. Algılanan arama desenleri şunları içerir: joker karakterler (*, ?, ^), karşılaştırma operatörleri (>, >=, <, <=), fuzzy arama (~), ifade araması (=), arama değiştiricileri (+, -) ve bileşik arama ((…|…), (…&…)):

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

Tek tırnak içine alınmış düz metin değişmezleri (örneğin, 'USA') ve sayısal alanlardaki tek tırnak içine alınmış değerler etkilenmez. Bu düzeltmeyi devre dışı bırakmak için --noFixSingleQuotedSearch kullanın.

Tırnak içine alınmamış ayar değerlerini düzelt (--fixUnquotedSetValues) — deneysel

Tırnak içine alınmamış ham dize değerleri tek tırnak içine alınır:

• {<Country={USA}>} olur {<Country={'USA'}>}

Sayısal değerler (2024), dolar işareti değişkenleri ($(vYear)) ve çift tırnaklı dizeler değiştirilmeden bırakılır. Bu düzeltme varsayılan olarak devre dışıdır. Etkinleştirmek için --fixUnquotedSetValues verin. Açıkça devre dışı bırakmak için --noFixUnquotedSetValues kullanın.

Her iki düzeltme de yalnızca boyut ve ölçü ifadeleri için geçerlidir. Desteklenmeyen işlev bulguları değiştirilmez. Bir düzeltme devre dışı bırakıldığında, işaretli desenler, manuel inceleme için İfade_Bulguları çalışma sayfasında kalır.

Daha fazla bilgi edinin

• Yaygın iş akışları
• Günlük kaydı ve tanılama
• Yerleşim modları