Typowe przepływy pracy
Ostatnia aktualizacja: 14.10.2026Poniższe przykłady obejmują najczęstsze przypadki użycia. Każdy opiera się na tym samym podstawowym wzorcu: określ plik QVW, folder wyjściowy i kontekst Qlik Cloud. We wszystkich przykładach --outputDir jest katalogiem głównym danych wyjściowych. QV2QS automatycznie tworzy podfolder nazwany po pliku QVW (na przykład, ./output/Sales/). Wszystkie te przepływy pracy można również wykonać za pomocą kreatora internetowego. W przypadku podejścia z przewodnikiem, zobacz Kroki kreatora.
Wdróż w Qlik Cloud z danymi
Standardowy przepływ pracy migracji. QV2QS generuje folder PRJ, konwertuje interfejs użytkownika, przesyła plik QVW w celu załadowania danych binarnych, ponownie ładuje aplikację w Qlik Cloud i tworzy raport Excel. Przesłany plik QVW jest usuwany i oryginalny skrypt ładowania jest przywracany po ponownym załadowaniu.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Eksportuj plik QVF
QV2QS buduje aplikację używając silnika Qlik Cloud, eksportuje wynik jako plik QVF, następnie usuwa aplikację w chmurze. Wyeksportowany plik QVF można zaimportować do innej dzierżawy Qlik Cloud.
Importowanie plików QVF wygenerowanych przez QV2QS do Qlik Sense Enterprise Client-Managed nie jest testowane we wszystkich wersjach ani oficjalnie wspierane i jest odradzane. Aby uzyskać szczegółowe informacje, zobacz Zgodność z Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Migracja wsadowa całego środowiska QlikView
Skanuj jeden lub więcej folderów w poszukiwaniu wszystkich par QVW i PRJ, konwertuj pary równolegle i wdróż każdą do Qlik Cloud. Użyj --batchWorkers do kontrolowania współbieżności.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Zachowaj pikselowy układ QlikView
Włącz tryb stałego płótna, aby zachować dokładne pozycje obiektów QlikView i tapety arkuszy. Dostosuj współczynniki skali, aby kontrolować, w jaki sposób układ mapuje się do wymiarów ekranu Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Zaktualizuj uprzednio przekonwertowaną aplikację
Ponownie uruchom konwersję dla istniejącej aplikacji Qlik Cloud bez tworzenia nowej. QV2QS wykorzystuje ponownie identyfikator aplikacji z poprzedniego uruchomienia.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Zaktualizuj aplikację, zachowując jej skrypt ładowania
Ponownie uruchom konwersję, aby zaktualizować warstwę interfejsu użytkownika istniejącej aplikacji bez nadpisywania skryptu ładowania. Docelowa aplikacja zachowuje swoje istniejące połączenia danych i logikę przeładowania. Kopia zapasowa bez danych jest eksportowana automatycznie przed aktualizacją. Dodaj --reload aby wykonać istniejący skrypt i odświeżyć dane.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Zaktualizuj aplikację, zachowując jej zmienne
Ponownie uruchom konwersję, aby zaktualizować warstwę interfejsu użytkownika i skrypt ładowania istniejącej aplikacji bez nadpisywania zmiennych. Połącz z --preserveTargetAppScript, aby zachować zarówno skrypt ładowania, jak i zmienne z docelowej aplikacji w nienaruszonym stanie.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Skonfiguruj uwierzytelnianie Qlik Cloud
Skonfiguruj kontekst qlik-cli przed uruchomieniem jakiejkolwiek konwersji. Interaktywna konfiguracja prosi o adres URL dzierżawy i klucz API oraz przechowuje poświadczenia do kolejnych uruchomień.
QV2QS.exe --setupQlikAuth
Użycie programowe (CI/CD)
QV2QS obsługuje bezpośrednie uwierzytelnianie bez wcześniej utworzonych kontekstów qlik-cli. Przekaż adres URL dzierżawy i klucz API wbudowane. QV2QS weryfikuje poświadczenia i wstrzykuje nagłówki uwierzytelniające do każdego wywołania qlik-cli. Nie utworzono ani nie zmodyfikowano pliku kontekstu. Dodaj --accept-eula, aby zaakceptować umowę licencyjną bez interaktywnego monitu.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Ten tryb jest bezpieczny do współbieżnego wykonywania dla wielu dzierżawców i użytkowników. Klucz API nie jest zapisywany na dysku i nie pojawia się w plikach dziennika.
Poświadczenia można również ustawić jako zmienne środowiskowe:
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Lokalna kompilacja bez Qlik Cloud
Wygeneruj przekonwertowane dane wyjściowe i raport konwersji na dysku bez łączenia się z Qlik Cloud. Tryb tylko lokalny jest przeznaczony do oceny migracji, przeglądu przed wdrożeniem oraz środowisk offline. Lokalne dane wyjściowe kompilacji nie obejmują przesyłania multimediów, rozdzielczości obrazów tła, tworzenia stanów alternatywnych ani publikowania arkuszy. Dla pełnego wdrożenia, użyj trybu Build to Qlik Cloud lub trybu Export QVF mode. Aby uzyskać szczegółowe informacje na temat ograniczeń i przypadków użycia tylko lokalnych, zobacz Jak działa konwersja.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly