Jak działa konwersja

Ostatnia aktualizacja: 14.10.2026

Potok konwersji ma następujące fazy:

Wyodrębnij — Jeśli --generatePrj jest włączone, QV2QS uruchamia QlikView Desktop, aby wyodrębnić plik QVW do folderu PRJ. QV2QS używa dołączonego przenośnego silnika, chyba że zostanie wykryta instalacja systemowa QlikView Desktop. Aby uzyskać szczegółowe informacje, zobacz silnik QlikView Desktop.
Parsuj — QV2QS odczytuje folder PRJ i parsuje każdą definicję obiektu, układ arkusza, skrypt ładowania, zmienną i właściwość dokumentu. QV2QS czyta również binarny plik QVW/QVF bezpośrednio, aby wyodrębnić metadane, zmienne i dowolny ukryty skrypt ładowania osadzony w pliku.
Konwertuj — Każdy obiekt QlikView jest mapowany na typ wizualizacji Qlik Sense. Wymiary, miary, wyrażenia, stylizacja i pozycje układu są tłumaczone na format JSON Qlik Sense.
Zapis — QV2QS zapisuje przekonwertowaną strukturę aplikacji do folderu wyjściowego jako zestaw plików JSON.
Wdróż (tylko tryby chmury) — QV2QS tworzy aplikację w dzierżawie, przesyła multimedia, kompiluje aplikację i opcjonalnie ponownie ładuje aplikację danymi.
Raport — QV2QS generuje raport konwersji podsumowujący wyniki, ocenę automatyzacji oraz wszelkie elementy wymagające ręcznego obserwowania.

Faza wdrażania działa w trybach Kompiluj do Qlik Cloud i Eksportuj QVF. W trybie tylko lokalnym, QV2QS zapisuje przekonwertowane dane wyjściowe na dysk bez łączenia się z Qlik Cloud. Faza raportowania działa we wszystkich trybach.

Tryby konwersji

QV2QS obsługuje trzy tryby konwersji. Wybierz tryb na kroku Konfiguracja kreatora lub za pomocą odpowiedniej flagi CLI.

Tryb	Flaga CLI	Qlik Cloud wymagane	Dane wyjściowe	Faza wdrożenia
Wdrażaj do Qlik Cloud	(domyślne)	Tak	Aplikacja wdrożona do dzierżawy	Tak — tworzy aplikację, przesyła multimedia, kompiluje, publikuje arkusze
Eksportuj QVF	`--exportQvf`	Tak	Plik QVF na dysku	Tak — tworzy aplikację w Qlik Cloud, eksportuje jako QVF, następnie usuwa aplikację w chmurze
Tylko lokalnie	`--unbuildOnly`	Nie	Folder kompilacji i raport konwersji na dysku	Nie

Budowanie do Qlik Cloud jest zalecanym trybem do migracji. Eksport QVF jest przydatny do tworzenia przenośnego pliku do udostępniania lub importowania do innej dzierżawy. Tryb tylko lokalny jest przeznaczony do oceny i przeglądu. Aby uzyskać szczegółowe informacje na temat ograniczeń wyłącznie lokalnych, zobacz sekcję poniżej.

Interfejs użytkownika domyślnie jest w trybie stałej kanwy, z włączonym przeładowaniem i włączonym automatycznym binarnym. Interfejs CLI domyślnie używa dynamicznego trybu siatki, z wyłączonym przeładowaniem i wyłączonymi automatycznymi binariami. Podczas przechodzenia z kreatora do interfejsu CLI, określ te flagi jawnie, aby dopasować zachowanie kreatora. Aby uzyskać pełną listę argumentów i wartości domyślnych, patrz Odwołanie do argumentów.

Tryb tylko lokalny

Tryb tylko lokalny (--unbuildOnly) wykonuje fazy Parsowania, Konwersji, Zapisu i Raportowania bez łączenia się z Qlik Cloud. Dzierżawa ani klucz API nie są wymagane. QV2QS generuje pełny raport konwersji, streszczenie wykonawcze oraz folder wyjściowy kompilacji na dysku.

Zastosowania

Ocena migracji — Uruchom tryb tylko lokalny, aby wygenerować raport konwersji, streszczenie dla kadry kierowniczej, wynik automatyzacji i wyniki wyrażeń bez konieczności dostępu do Qlik Cloud. Oceń jakość konwersji w całym środowisku QVW przed skonfigurowaniem poświadczeń dzierżawy.
Przegląd przed wdrożeniem — Sprawdź wygenerowane dane wyjściowe (skrypt ładowania, definicje obiektów, zmienne, wymiary) przed zatwierdzeniem do wdrożenia w chmurze. Organizacje z procesami kontroli zmian mogą weryfikować dane wyjściowe jako artefakt pośredni.
Środowiska offline lub z ograniczonym dostępem — Gdy maszyna hostująca pliki QVW nie ma dostępu do Internetu, uruchom tryb Tylko lokalnie, aby wygenerować raport konwersji lokalnie. Aby wdrożyć przekonwertowaną aplikację, skopiuj pliki QVW na maszynę z dostępem do Qlik Cloud i uruchom QV2QS w trybie Build to Qlik Cloud z podłączonej maszyny.

Ograniczenia

Faza wdrożenia obsługuje kilka operacji, których qlik app build sam nie wykonuje. Uruchomienie trybu tylko lokalnego, a następnie ręczne wdrożenie folderu build/ za pomocą samodzielnej instalacji qlik-cli skutkuje następującymi lukami.

Pliki multimedialne nie zostały przesłane. Obrazy tła i obrazy przycisków są wyodrębniane do folderu images/, ale nie są uwzględniane w folderze build/. Polecenie qlik app build nie przetwarza plików multimedialnych. Wszystkie obrazy tła i obrazy przycisków nie będą widoczne w wdrożonej aplikacji.
Odwołania do tła arkusza i obiektu nie są rozwiązywane. QV2QS wstrzykuje adresy URL obrazów tła do plików JSON arkusza i obiektów podczas fazy Wdrażania, używając ID aplikacji chmurowej. Lokalne dane wyjściowe kompilacji nie zawierają odwołań do obrazów tła. Arkusze i obiekty nie będą miały tła w wdrożonej aplikacji.
Adresy URL obrazów przycisków zawierają ciągi znaków zastępczych. Obrazy przycisków w wynikach lokalnej kompilacji używają wewnętrznych wartości zastępczych zamiast rozwiązanych adresów URL mediów. Silnik Qlik Sense nie może interpretować ciągów znaków zastępczych. Obrazy przycisków będą wyglądać na uszkodzone.
Stany alternatywne nie są tworzone. Alternatywne nazwy stanów są zapisywane do cloud/alternate_states.json poza folderem build/. Polecenie qlik app build nie przetwarza stanów alternatywnych. Obiekty odwołujące się do stanów niedomyślnych mogą nie wyświetlać się poprawnie.
Arkusze nie są opublikowane. Polecenie qlik app build tworzy arkusze jako obiekty osobiste widoczne tylko dla właściciela aplikacji. QV2QS publikuje arkusze jako arkusze bazowe podczas fazy wdrażania. W udostępnionej przestrzeni inni użytkownicy nie zobaczą żadnych arkuszy, dopóki arkusze nie zostaną opublikowane ręcznie.

Aby uzyskać kompletne wdrożenie obejmujące przesyłanie multimediów, rozdzielczość tła, tworzenie stanów alternatywnych i publikowanie arkuszy, użyj trybu Kompiluj do Qlik Cloud lub trybu Eksportuj QVF zamiast trybu Tylko lokalnie.

Bezpieczeństwo pliku źródłowego

QV2QS nie modyfikuje zawartości źródłowego pliku QVW ani QVF. Podczas fazy ekstrakcji, QV2QS otwiera dokument źródłowy za pośrednictwem QlikView Desktop i zapisuje tymczasową kopię w tymczasowym folderze systemowym. QV2QS następnie zamyka oryginał i generuje folder PRJ z tymczasowej kopii. Po zakończeniu generowania PRJ, QV2QS kopiuje wynikowy -prj folder z powrotem do tego samego katalogu co plik źródłowy i usuwa tymczasową kopię. Jeśli folder -prj już istnieje obok pliku źródłowego, QV2QS zastępuje ten folder nowo wygenerowaną wersją. Cała pozostała konwersja jest zapisywana do oddzielnego katalogu wyjściowego określonego przez --outputDir.

QlikView Desktop uzyskuje blokadę pliku w dokumencie źródłowym podczas tworzenia tymczasowej kopii. Uruchamianie QV2QS na pliku, który jest aktywnie otwarty w QlikView Desktop lub udostępniany przez QlikView Server, może powodować konflikty blokowania plików lub niepowodzenie generowania PRJ. Pliki na współdzielonych dyskach sieciowych mogą powodować te same konflikty. Zapisanie -prj folderu z powrotem do udziału sieciowego lub katalogu tylko do odczytu również może się nie powieść.

Aby uniknąć ryzyka dla środowisk produkcyjnych, zawsze pracuj z kopiami dokumentów źródłowych. Wykonaj następujące czynności:

Skopiuj pliki QVW lub QVF do lokalnego folderu roboczego na maszynie, na której działa QV2QS.
Skieruj QV2QS na skopiowane pliki, nie na oryginalne.
Zamknij wszystkie uruchomione instancje QlikView Desktop przed rozpoczęciem konwersji. QV2QS wymaga wyłącznego dostępu do QlikView Desktop.

Nie uruchamiaj QV2QS bezpośrednio na folderach dokumentów QlikView Server, produkcyjnych udziałach sieciowych ani plikach otwartych w QlikView Desktop. Zawsze używaj lokalnej kopii dokumentów źródłowych.

Typowy czas

QV2QS jest zaprojektowany z myślą o szybkości. Pełny potok zajmuje minuty, a nie godziny. Poniższa tabela przedstawia typowe czasy trwania dla konwersji pojedynczej aplikacji.

Faza	Typowy czas trwania	Uwagi
Ekstrakcja (generowanie PRJ)	5–15 sekund	Zależy od złożoności QVW. Pominięto, jeśli folder PRJ już istnieje.
Parsuj + Konwertuj + Zapisz	Poniżej 30 sekund	Podstawowa konwersja XML na JSON. Obsługuje złożone aplikacje z setkami obiektów.
Wdrażanie (kompilacja w chmurze)	1–3 minuty	Obejmuje tworzenie aplikacji, przesyłanie multimediów oraz kompilację aplikacji w dzierżawie.
Przeładuj	Różne	Zależy od ilości danych, opóźnienia źródła danych i zasobów dzierżawy. Binarna operacja ładowania typowego QVW kończy się w mniej niż minutę.

Konwersja pojedynczej aplikacji z wdrożeniem w chmurze i ponownym załadowaniem danych zazwyczaj trwa od dwóch do pięciu minut od początku do końca. Konwersje tylko lokalne (--unbuildOnly) zajmują mniej niż 30 sekund.

W trybie wsadowym QV2QS konwertuje wiele projektów równolegle. Całkowity czas przetwarzania wsadowego skaluje się wraz z liczbą projektów podzieloną przez liczbę pracowników. Dla partii 20 aplikacji z czterema pracownikami, należy spodziewać się około pięciokrotności czasu trwania dla pojedynczej aplikacji dla fazy konwersji lokalnej, plus czas wdrożenia w chmurze.

Struktura folderów wyjściowych

Ten --outputDir argument określa katalog główny wyjściowy. QV2QS tworzy podfolder nazwany na cześć pliku QVW (lub folderu PRJ) wewnątrz katalogu głównego wyjściowego. Wszystkie dane wyjściowe konwersji dla projektu są zapisywane w tym podfolderze. Jeśli dwa pliki QVW mają tę samą nazwę, QV2QS dodaje _2, _3 i kolejne numery, aby uniknąć kolizji. To zachowanie odpowiada trybowi wsadowemu, w którym każdy projekt również otrzymuje dedykowany podfolder.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

QV2QS tworzy folder wyjściowy, jeśli folder jeszcze nie istnieje. Jeśli folder istnieje z poprzedniego uruchomienia tego samego QVW, QV2QS ponownie wykorzystuje folder. Istniejące pliki dziennika w folderze są zachowywane, chyba że Czyszczenie dzienników jest włączone. Katalog wyjściowy nie może być taki sam jak żaden katalog źródłowy ani nie może być jego katalogiem nadrzędnym. QV2QS sprawdza poprawność ścieżki wyjściowej przed rozpoczęciem konwersji i zgłasza błąd, jeśli ścieżki się pokrywają. Podfolder projektu zawiera następujące elementy:

Folder / plik	Spis treści
`build/`	Struktura aplikacji Qlik Sense dla `qlik app build`. Zawiera `config.yml` (manifest kompilacji), `script.qvs` (skrypt ładowania), `app-properties.json`, `connections.yml` (połączenia danych), `dimensions.json` (wymiary główne), `measures.json` (miary główne), `variables.json`, oraz podfolder `objects/` z jednym plikiem JSON na arkusz i wizualizację.
`images/`	Wyodrębnione pliki multimedialne (zdeduplikowane na podstawie skrótu zawartości) oraz `backgrounds.json` (manifest w tle).
`reports/`	`executive_summary.json`, `executive_summary.html`, oraz raport konwersji programu Excel (`_conversion_report_.xlsx`), jeśli jest włączony.
`logs/`	Pliki dziennika strukturalnego dla każdego uruchomienia.
`cloud/`	`cloud_state.json` (ID aplikacji, skrót multimediów, mapowanie ID arkusza, znacznik czasu) oraz `alternate_states.json`. Utworzono podczas wdrożenia w chmurze.
`qvf/`	Wyeksportowane pliki QVF (utworzone, gdy `--exportQvf` jest używane).
`.qv2qs_source`	Plik znacznika, który rejestruje, który QVW utworzył podfolder. QV2QS używa znacznika do wykrywania kolizji nazw i do ponownego użycia prawidłowego folderu w kolejnych uruchomieniach.

Otwórz folder wyjściowy bezpośrednio z kreatora po zakończeniu konwersji.

Po konwersji

Po zakończeniu konwersji, zajmij się poniższymi pozycjami pogrupowanymi według priorytetu.

Popraw przed publikacją

Otwórz raport konwersji programu Excel w reports/ podfolderze i przejrzyj arkusz Obiekty_do_śledzenia. Napraw najpierw wszystkie elementy oznaczone jako Błąd (obiekty, których konwersja się nie powiodła), następnie Symbol zastępczy (obiekty wymagające przebudowy), a następnie Wymagane korekty (obiekty, które zostały częściowo przekonwertowane).
Przejrzyj wyniki analizy na arkuszu Analiza, w tym odwołania do makr, użycie Dostępu do sekcji i wzorce skryptu ładowania, które mogą wymagać ręcznej uwagi.
Sprawdź, czy wyrażenia są poprawnie obliczane. QV2QS automatycznie naprawia problemy z cudzysłowami w analizie zbiorów podczas konwersji. Przejrzyj wymiary obliczeniowe, kolorowanie warunkowe i wyrażenia wykorzystujące funkcje dostępne wyłącznie w QlikView (GetCurrentField(), MsgBox()), które wymagają ręcznego przepisania.
Sprawdź arkusz Overflow_Actions pod kątem obiektów, w których nadmiarowe wymiary lub miary zostały przeniesione do kolekcji alternatyw.

Weryfikuj przed publikacją

Otwórz przekonwertowaną aplikację w Qlik Sense i sprawdź, czy układy arkuszy, pozycje obiektów oraz obrazy tła wyglądają zgodnie z oczekiwaniami.
Potwierdź, że nawigacja kontenera zakładek (paski przycisków lub kontenery z zakładkami) przełącza się między obszarami zawartości poprawnie.
Przetestuj drążenie w dół i zachowanie cyklicznego przełączania grup na wykresach, które używają grup wymiarów.
Sprawdź, czy warunki wyświetlania ukrywają i ujawniają obiekty zgodnie z oczekiwaniami.
Sprawdź kolejność sortowania w polach list i tabelach, szczególnie dla pól typu data.

Polski

Dostosuj czcionki, kolory lub położenie obiektów w edytorze aplikacji Qlik Sense w razie potrzeby. Aby uzyskać wskazówki dotyczące pozycjonowania układu, zobacz Ustawienia układu konwersji.

Aby uzyskać pełny opis zawartości raportu, zobacz Raport konwersji.

Dowiedz się więcej

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać!

Przekaż tu opinię