Odwołanie do argumentu

Ostatnia aktualizacja: 14.10.2026

Poniższe tabele wymieniają każdy dostępny argument pogrupowany według kategorii.

Wejście i wyjście

Tryb wsadowy

Qlik Cloud

Uwierzytelnianie

Układ i stylizacja

Aby uzyskać szczegółowe wyjaśnienie trybów stałego płótna i dynamicznej siatki, zobacz Ustawienia układu konwersji.

Raport konwersji

Raport konsoli i raport Excel są domyślnie włączone zarówno w trybie CLI, jak i w interfejsie użytkownika.

Konsola i rejestrowanie

QV2QS obsługuje cztery tryby wyjścia konsoli.

• Estetyczny — Bogato sformatowane wyjście z kolorami, animowanymi wskaźnikami ładowania, paskami postępu i tematycznymi panelami. Tryb ładny jest domyślny do interaktywnego użytku w terminalu. Wymaga terminala obsługującego kolory (Windows 10+, PowerShell 5+ lub powłoki uniksopodobne).
• Zwykły — Wyjście tekstowe ze znacznikiem czasu, bez kodów ucieczki ANSI. Każda linia jest poprzedzona znacznikiem czasu trwania i znacznikiem fazy w formacie [MM:SS] [phase] message. Nagłówki i tabele używają znaków ASCII. Nadaje się do potoków CI/CD, plików logów oraz terminali, które nie obsługują formatowania ANSI.
• Cichy — Tłumi wszystkie standardowe dane wyjściowe. Wyświetlane są tylko błędy. Odpowiednie do zautomatyzowanego przetwarzania wsadowego i skryptowych przepływów pracy, gdzie nie jest potrzebne wyjście konsoli.
• UI — Wyjście wierszowe bez znaczników czasu ani kodów ANSI. Interfejs użytkownika ustawia ten tryb automatycznie podczas uruchamiania podprocesu konwersji. Format jest zoptymalizowany dla osadzonego podglądu dziennika. Uruchomienie --console ui z terminala generuje czytelne, ale niesformatowane dane wyjściowe; użyj --plain lub --console pretty zamiast tego do bezpośredniego użycia w terminalu.

Flagi --dark i --light wybierają kompozycję kolorów. Ciemna kompozycja (domyślna) wykorzystuje głęboką granatową paletę inspirowaną przez Qlik. Jasna kompozycja używa jasnoszarej palety. Flaga --surface umożliwia subtelne wypełnienie tła za każdą linią wyjściową. Wypełnienie powierzchni jest włączone domyślnie w trybie ładnym. Użyj --noSurface, aby wyłączyć wypełnienie tła.

W trybie pojedynczego projektu pliki dziennika są zapisywane w %LOCALAPPDATA%\QV2QS\logs\ domyślnie. W trybie wsadowym pliki dziennika są zapisywane w podfolderze logs/ w katalogu wyjściowym. Zastąp lokalizację za pomocą --logDir. Ustaw --logLevel DEBUG, aby przechwycić szczegółowe dane diagnostyczne do rozwiązywania problemów z konwersją. Użyj --cleanLogs, aby usunąć pliki dziennika starsze niż 30 dni przed każdym uruchomieniem. Aby uzyskać pełny opis lokalizacji plików dziennika, rotacji i formatu, zobacz Logowanie i diagnostyka.

Załaduj skrypt

Domyślnie, QV2QS stosuje osiem wbudowanych reguł, które normalizują ścieżki z ukośnikami wstecznymi systemu Windows na ukośniki dla zgodności z Qlik Cloud. Poniższa tabela zawiera listę każdej wbudowanej reguły.

Każda reguła wykorzystuje dwuetapowy proces dopasowywania. Pole pattern jest wyrażeniem regularnym, które wybiera obszar ze skryptu ładowania. Pole search jest następnie stosowane tylko w każdym dopasowanym regionie. Takie podejście zapobiega niezamierzonym zamianom poza docelowym kontekstem.

Argument --scriptReplacements akceptuje plik JSON, który staje się jedynym źródłem prawdy dla wszystkich reguł zastępowania. Gdy plik zostanie dostarczony, wbudowane ustawienia domyślne nie ładują się automatycznie. Aby uwzględnić wbudowane reguły wraz z regułami niestandardowymi, eksportować pełny zestaw reguł z kreatora i edytować wyeksportowany plik. Reguły wykonują się w kolejności execution_order.

Dostępne są trzy zachowania interfejsu CLI:

• Brak flagi — osiem wbudowanych reguł wykonuje się.
• --scriptReplacements <file> — wykonywane są tylko reguły z pliku. Wbudowane ustawienia domyślne nie ładują się automatycznie.
• --noScriptReplacements — żadne reguły nie są wykonywane.

Plik --scriptReplacements jest tablicą JSON obiektów reguł:

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

Każda reguła ma następujące pola:

Inna odpowiedź

Zabezpieczenie sortowania pola daty

Domyślnie, Qlik Sense sortuje wybrane wartości na górę pola listy. Dla pól typu data, takich jak Kwartał, Miesiąc lub Rok, ta zmiana kolejności zakłóca oczekiwaną kolejność chronologiczną. QV2QS stosuje heurystykę do wykrywania nazw pól podobnych do dat i wyłączania sortowania opartego na stanie dla tych pól, zachowując wartości w ich naturalnej kolejności niezależnie od stanu zaznaczenia.

Heurystyka tokenizuje każdą nazwę pola, dzieląc ją na podstawie znaków niealfanumerycznych i granic camelCase (na przykład, OrderDate staje się order i date). Wszystkie tokeny są pisane małymi literami. Pole pasuje, jeśli dowolny token jest równy jednemu z następujących: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Pole pasuje również, jeśli jakikolwiek token kończy się na date, month lub year (na przykład, OrderDate, FiscalMonth). Tokeny update, candidate, i validate są wykluczone, aby uniknąć fałszywych alarmów. Dopasowywanie jest niewrażliwe na wielkość liter i używa wyłącznie angielskich tokenów. Nazwy pól w językach innych niż angielski (na przykład, Monat lub Fecha) nie są wykrywane.

Pola, które pasują do heurystyki, mają usunięte sortowanie oparte na stanie i wyłączone sortowanie automatyczne.

Użyj --disableDateStateStickySort, aby wyłączyć tę heurystykę. Po wyłączeniu wszystkie pola listbox używają domyślnego zachowania sortowania Qlik Sense, w tym ponownego porządkowania opartego na stanie.

Poprawki cytowania w analizie zbiorów

QlikView i Qlik Sense interpretują cytowanie w modyfikatorach analizy zestawów inaczej. QV2QS stosuje dwie niezależne poprawki podczas konwersji. Poprawka wyszukiwania w pojedynczych cudzysłowach jest włączona domyślnie. Poprawka wartości zestawu bez cudzysłowów jest eksperymentalna i domyślnie wyłączona.

Napraw wartości wyszukiwania w pojedynczym cudzysłowie (--fixSingleQuotedSearch)

Wartości w pojedynczych cudzysłowach zawierające składnię wyszukiwania są konwertowane na podwójne cudzysłowy. Wykryte wzorce wyszukiwania obejmują symbole wieloznaczne (*, ?, ^), operatory porównania (>, >=, <, <=), wyszukiwanie rozmyte (~), wyszukiwanie wyrażeń (=), modyfikatory wyszukiwania (+, -) oraz wyszukiwanie złożone ((…|…), (…&…)):

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

Literały tekstowe w pojedynczym cudzysłowie (na przykład, 'USA') oraz wartości w pojedynczym cudzysłowie w polach numerycznych nie są zmieniane. Użyj --noFixSingleQuotedSearch, aby wyłączyć tę poprawkę.

Napraw niecytowane wartości ustawień (--fixUnquotedSetValues) — eksperymentalny

Nieujęte w cudzysłów wartości ciągu znaków są ujęte w pojedyncze cudzysłowy:

• {<Country={USA}>} staje się {<Country={'USA'}>}

Wartości liczbowe (2024), zmienne z symbolem dolara ($(vYear)) oraz ciągi znaków w cudzysłowach pozostają niezmienione. Ta poprawka jest domyślnie wyłączona. Podaj --fixUnquotedSetValues, aby to włączyć. Użyj --noFixUnquotedSetValues, aby jawnie to wyłączyć.

Obie poprawki dotyczą wyłącznie wyrażeń wymiarów i miar. Wyniki dotyczące nieobsługiwanych funkcji nie są modyfikowane. Gdy poprawka jest wyłączona, oznaczone wzorce pozostają do ręcznego przeglądu w arkuszu Expression_Findings.

Dowiedz się więcej

• Typowe przepływy pracy
• Logowanie i diagnostyka
• Tryby układu