Analiza
Ostatnia aktualizacja: 14.10.2026QV2QS automatycznie skanuje każdy dokument QlikView pod kątem funkcji i wzorców, które mogą wymagać uwagi po migracji. Niektóre ustalenia mają charakter informacyjny. Inne ustalenia wskazują na nieobsługiwaną funkcjonalność lub obszary, które działają inaczej w Qlik Sense. Wyniki pojawiają się w sekcji Inne ustalenia podsumowania wykonawczego oraz w arkuszu Analiza raportu programu Excel.
Analiza jest oddzielna od raportu z konwersji. Raport konwersji mierzy, jak dobrze obiekty zostały przekonwertowane. Analiza identyfikuje dodatkowe kwestie dotyczące zgodności dla wdrożenia Qlik Cloud.
Co jest skanowane
QV2QS sprawdza siedem obszarów dokumentu QlikView.
Ukryty skrypt
Dokumenty QlikView mogą zawierać ukryty skrypt ładowania, który jest wykonywany przed widocznym skryptem. Ukryty skrypt jest przechowywany wewnątrz skompresowanego bloku w pliku binarnym QVW/QVF i nie jest widoczny w folderze PRJ. QV2QS wyodrębnia ukryty skrypt z pliku binarnego i dołącza go na początku widocznego skryptu ładowania w script.qvs. Gdy wykryty zostanie ukryty skrypt, w arkuszu Analysis oraz w sekcji Other findings podsumowania wykonawczego pojawia się ustalenie informacyjne.
Wczytaj wzorce skryptów
QV2QS skanuje skrypt ładowania (LoadScript.txt) pod kątem instrukcji i funkcji, które wymagają uwagi podczas migracji. Gdy obecny jest ukryty skrypt, zawartość ukrytego skryptu jest uwzględniana w skanowaniu. Niektóre instrukcje nie są obsługiwane w Qlik Sense. Inne wzorce mogą wymagać dostosowania ścieżki lub konieczna może być alternatywna metoda. Linie komentarzy i komentarze blokowe to treść wykluczona ze skanowania.
Wykrywane są następujące wzorce:
| Wzór | Opis |
|---|---|
| Binarna operacja ładowania | BINARY instrukcja ładująca dane z innego pliku QVW. Podejście do ładowania danych może wymagać zrewidowania. |
| Załaduj pakiet | Instrukcje BUNDLE lub INFO LOAD osadzające obrazy w pliku QVW. Nieobsługiwane w Qlik Sense. |
| InputField | Instrukcja INPUTFIELD do wprowadzania danych przez użytkownika. Nieobsługiwane w Qlik Sense. |
| Direct Discovery | DIRECT QUERY instrukcja dla połączeń na żywo ze źródłem danych. Nieobsługiwane w Qlik Sense. |
| Uwzględnij | $(Include=...) lub $(Must_Include=...) odwołania do zewnętrznych plików skryptów. Ścieżki plików mogą wymagać dostosowania. |
| Polecenie | Instrukcja COMMAND wykonująca polecenia systemu operacyjnego. Nieobsługiwane w Qlik Sense. |
| Wykonaj: | Instrukcja EXECUTE uruchamiająca programy zewnętrzne. Nieobsługiwane w Qlik Cloud. |
| Image_Size | Image_Size funkcja Nieobsługiwane w Qlik Sense. |
| GetCurrentField | GetCurrentField funkcja Nieobsługiwane w Qlik Sense. |
| GetExtendedProperty | GetExtendedProperty funkcja Nieobsługiwane w Qlik Sense. |
| InputAvg / InputSum | Funkcje agregujące dla pól wejściowych. Nieobsługiwane w Qlik Sense. |
| MsgBox | Funkcja MsgBox dla okien dialogowych. Nieobsługiwane w Qlik Sense. |
| NoOfReports | NoOfReports funkcja Nieobsługiwane w Qlik Sense. |
| Komentarz do raportu / Identyfikator raportu / Nazwa raportu / Numer raportu | Funkcje związane z raportami. Nieobsługiwane w Qlik Sense. |
Każde ustalenie zawiera numer wiersza i tekst wiersza ze skryptu ładowania.
Właściwości dokumentu
QV2QS sprawdza DocProperties.xml pod kątem funkcji na poziomie dokumentu, które wymagają uwagi. Niektóre nie są obsługiwane w Qlik Sense. Pozostałe są obsługiwane, ale wymagają ręcznej konfiguracji lub zachowują się inaczej.
| Właściwość | Opis |
|---|---|
| Dostęp do sekcji | Bezpieczeństwo na poziomie wiersza jest włączone. Qlik Sense obsługuje Dostęp do sekcji, ale składnia się różni. |
| Dynamiczna aktualizacja danych | Dynamiczna aktualizacja danych jest włączona. Nieobsługiwane w Qlik Sense. |
| Tryb Direct Discovery | Tryb Direct Query jest włączony na poziomie dokumentu. Nieobsługiwane w Qlik Sense. |
| Alarmy | Definicje alertów istnieją. Alerty nie są obsługiwane w Qlik Sense. |
| Akcje przy otwarciu dokumentu | Zdefiniowano akcje wyzwalacza OnOpen na poziomie dokumentu. Wymaga ręcznego odtworzenia. |
| Akcje OnPostReload dokumentu | Zdefiniowano akcje wyzwalacza OnPostReload na poziomie dokumentu. Wymaga ręcznego odtworzenia. |
| Rozszerzenia dokumentów | Rozszerzenia dokumentów zostały zainstalowane. Rozszerzenia inne niż QVAccessibility nie są obsługiwane. |
Właściwości pola
QV2QS wykrywa pola z włączoną właściwością Zawsze jedna wybrana. Ta właściwość jest ustawieniem na poziomie silnika, którego nie można zastosować poprzez dane wyjściowe kompilacji JSON. Właściwość musi zostać zastosowana ręcznie w edytorze aplikacji Qlik Sense po wdrożeniu.
Makra VBA
QV2QS odczytuje Module.txt z folderu PRJ i analizuje wszystkie definicje procedur Sub i funkcji Function języka VBA. Dla każdego makra analiza podaje nazwę, typ (Sub lub Function) oraz liczbę wierszy.
QV2QS tworzy również odsyłacze do wywołań makr, skanując każdy plik XML obiektu oraz DocProperties.xml pod kątem wyzwalaczy akcji wywołujących makra. Odsyłacz wskazuje, które obiekty wywołują które makra, oraz arkusze, na których te obiekty występują. Makra, które zostały zdefiniowane, ale nigdy nie zostały wywołane, są oznaczane jako nieużywane.
Ujmowanie wyrażeń w cudzysłów w analizie zestawów
QV2QS skanuje wszystkie wyrażenia obiektów (wymiary, miary, warunki wyświetlania, wyrażenia kolorów, wyrażenia tekstowe) oraz definicje zmiennych pod kątem wzorców stosowania cudzysłowów w analizie zbiorów, które zachowują się inaczej w Qlik Sense. QlikView (przed listopadem 2017 r.) traktował wartości ujęte w pojedyncze cudzysłowy w modyfikatorach zestawu jako wyszukiwania bez uwzględniania wielkości liter, identycznie jak wartości ujęte w podwójne cudzysłowy. Qlik Sense traktuje wartości ujęte w pojedyncze cudzysłowy jako literały uwzględniające wielkość liter.
Wykrywane są następujące wzorce:
| Wzór | Reguła | Prawdopodobieństwo | Opis | Działania naprawcze |
|---|---|---|---|---|
Symbol wieloznaczny w pojedynczym cudzysłowie ('*US*', 'A?', '^abc') |
Znak wieloznaczny w pojedynczym cudzysłowie | Wysoka | Znaki wieloznaczne *, ? oraz kotwica granicy słowa ^ są interpretowane w Qlik Sense jako tekst dosłowny zamiast wzorców wyszukiwania. |
Zamień pojedyncze cudzysłowy na podwójne, aby przywrócić działanie wyszukiwania. |
Porównanie w pojedynczych cudzysłowach ('>=5', '<2020') |
Porównanie w pojedynczych cudzysłowach | Wysoka | Operatory porównania >, >=, <, <= są w Qlik Sense interpretowane jako tekst dosłowny zamiast wyszukiwań liczbowych. |
Zastąp pojedyncze cudzysłowy podwójnymi, aby przywrócić porównanie numeryczne. |
Wyszukiwanie rozmyte w pojedynczym cudzysłowie ('~company') |
Wyszukiwanie rozmyte w pojedynczych cudzysłowach | Wysoka | Prefiks ~ uruchamia dopasowanie rozmyte w podwójnym cudzysłowie. W pojedynczym cudzysłowie Qlik Sense traktuje to jako dosłowny ciąg znaków. |
Zastąp pojedyncze cudzysłowy podwójnymi, aby przywrócić wyszukiwanie rozmyte. |
Wyszukiwanie wyrażeń w pojedynczym cudzysłowie ('=Sum(Sales)>100') |
Wyszukiwanie wyrażeń w pojedynczych cudzysłowach | Wysoka | Prefiks = uruchamia wyszukiwanie wyrażeń w podwójnym cudzysłowie. W pojedynczym cudzysłowie Qlik Sense traktuje to jako dosłowny ciąg znaków. |
Zastąp pojedyncze cudzysłowy podwójnymi, aby przywrócić wyszukiwanie wyrażeń. |
Modyfikator wyszukiwania w pojedynczym cudzysłowie ('+abc', '-solution') |
Modyfikator wyszukiwania w pojedynczym cudzysłowie | Wysoka | Modyfikatory + (musi zawierać) i - (nie może zawierać) działają w podwójnym cudzysłowie. W pojedynczych cudzysłowach Qlik Sense traktuje je jako ciągi dosłowne. |
Zastąp pojedyncze cudzysłowy podwójnymi, aby przywrócić działanie modyfikatora. |
Wyszukiwanie złożone w pojedynczym cudzysłowie ('(1|2|3)', '(*ABC*&?*Inc*)') |
Wyszukiwanie złożone w pojedynczym cudzysłowie | Wysoka | Wyszukiwanie złożone z operatorami logicznymi | (OR), & (AND), ^ (XOR) działa w podwójnym cudzysłowie. W pojedynczym cudzysłowie Qlik Sense traktuje to jako dosłowny ciąg znaków. |
Zamień pojedyncze cudzysłowy na podwójne, aby przywrócić wyszukiwanie złożone. |
Wartość w pojedynczym cudzysłowie w polu numerycznym ('2020' w polu daty lub liczbowym) |
Pojedyncze cudzysłowy w polu numerycznym | Wysoka | Wartości ujęte w pojedynczy cudzysłów odpowiadają reprezentacji tekstowej w Qlik Sense. W przypadku pól numerycznych lub podwójnych reprezentacja tekstowa może nie odpowiadać przechowywanej wartości, powodując niezgodność typów. | Zamiast tego użyj wartości liczbowej bez cudzysłowu lub podwójnego cudzysłowu. |
Ciąg znaków bez cudzysłowu ({USA,France}) |
Nieujęta w cudzysłów wartość prosta | Niska | Qlik Sense akceptuje wartości bez cudzysłowu, ale zachowanie to jest podatne na błędy w przypadku spacji, operatorów lub znaków specjalnych. | Ujmij wartość w pojedynczy cudzysłów, aby uzyskać dosłowne dopasowanie. |
Bezpośrednie odwołanie do pola (<Field1=Field2>) |
Nagie odwołanie do pola | Wysoka | QlikView umożliwia <Field1=Field2> przenoszenie selekcji między polami. Qlik Sense nie obsługuje bezpośrednich odwołań między polami w modyfikatorach zestawu. |
Zastąp przez <Field1=P(Field2)>, aby użyć funkcji elementu P(). |
Wartość nieujęta w nawiasy klamrowe (<Country=USA>) |
Zwykła wartość bez nawiasów klamrowych | Wysoka | Wartość bez nawiasów klamrowych po prawej stronie przypisania modyfikatora zbioru. QlikView może interpretować wartość jako literał lub odwołanie do pola w zależności od kontekstu. Qlik Sense wymaga, aby wartości znajdowały się w nawiasach klamrowych. | Ujmij w nawiasy klamrowe: <Country={USA}> lub <Country={'USA'}>. |
Wartości w postaci zwykłego tekstu ujęte w pojedynczy cudzysłów w polach tekstowych (na przykład 'USA') nie są oznaczane. Te wartości działają poprawnie jako literały rozróżniające wielkość liter w Qlik Sense.
QV2QS obsługuje nazwy pól ujęte w nawiasy kwadratowe ([Invoice Number]), podwójne cudzysłowy ("Invoice Number") i grawisy (`Invoice Number`) po lewej stronie przypisań modyfikatorów zestawu. Wszystkie trzy style cytowania są rozpoznawane podczas skanowania i naprawiania.
Domyślnie QV2QS automatycznie poprawia wartości wyszukiwania ujęte w pojedyncze cudzysłowy podczas konwersji w wyrażeniach obiektów i definicjach zmiennych. Wartości w pojedynczych cudzysłowach zawierające składnię wyszukiwania (znaki wieloznaczne, porównania, wyszukiwanie rozmyte, wyszukiwanie wyrażeń, modyfikatory wyszukiwania lub złożone operatory wyszukiwania) są konwertowane na podwójne cudzysłowy. Wartości w pojedynczych cudzysłowach w polach numerycznych, które nie zawierają składni wyszukiwania, są oznaczane do ręcznej weryfikacji, ale nie są automatycznie naprawiane. Dostępna jest również eksperymentalna poprawka dla nieujętych w cudzysłowy wartości ciągów znaków, ale jest domyślnie wyłączona — przekaż --fixUnquotedSetValues, aby ją włączyć. Poprawki są stosowane wyłącznie przy użyciu zamiany pozycyjnej w obrębie list wartości modyfikatorów zestawu — nazwy pól, nazwy funkcji oraz pozostały tekst wyrażenia nigdy nie są modyfikowane. Każda poprawka ma niezależny przełącznik (--noFixSingleQuotedSearch, --fixUnquotedSetValues). Więcej informacji można znaleźć w sekcji Dokumentacja referencyjna argumentów.
Wyniki pojawiają się w sekcji Ustalenia dotyczące cytowania wyrażeń podsumowania konsoli, na podkarcie Wyrażenie pulpitu nawigacyjnego podsumowania wykonawczego oraz w arkuszu Expression_Findings raportu programu Excel. Każde ustalenie zawiera wskaźnik Status: Naprawiono automatycznie (poprawiono podczas konwersji), Wymaga przeglądu (wymaga ręcznej interwencji) lub Brak dostępnej poprawki (nieobsługiwana funkcja). Pulpit nawigacyjny podsumowania zarządczego zawiera przełącznik filtru umożliwiający ukrycie automatycznie naprawionych wierszy i skupienie się na elementach, które nadal wymagają uwagi. Aby uzyskać więcej informacji o różnicach w składni analizy zbiorów, zobacz Analiza zbiorów w pomocy Qlik Cloud.
Nieobsługiwane funkcje wykresów
QV2QS skanuje wszystkie wyrażenia obiektów (wymiary, miary, warunki wyświetlania, wyrażenia kolorów, wyrażenia tekstowe) i definicje zmiennych pod kątem funkcji wykresów QlikView, które nie są obsługiwane w Qlik Sense. Skaner dopasowuje wywołania funkcji z opcjonalnymi białymi znakami lub znakami nowego wiersza między nazwą funkcji a nawiasem otwierającym. Nazwa funkcji wewnątrz literałów łańcuchowych jest wykluczona.
Wykryto następujące funkcje:
| Funkcja | Opis |
|---|---|
| GetCurrentField | Zwracana jest aktywna nazwa pola w bieżącym obiekcie. Nieobsługiwane w Qlik Sense. Zobacz Funkcje pól w Qlik Cloud, aby poznać obsługiwane alternatywy. |
| GetExtendedProperty | Pobiera metadane obiektu powiązanego. Nieobsługiwane w Qlik Sense. Zobacz Funkcje pól w Qlik Cloud, aby poznać obsługiwane alternatywy. |
| Dane wejściowe | Pobiera wartości pól wejściowych wprowadzone przez użytkownika. Nieobsługiwane w Qlik Sense. |
| InputAvg | Oblicza średnią wartości pól wejściowych. Nieobsługiwane w Qlik Sense. |
| InputSum | Oblicza sumę wartości pól wejściowych. Nieobsługiwane w Qlik Sense. |
| MsgBox | Wyświetla okno dialogowe. Nieobsługiwane w Qlik Sense. |
| NoOfReports | Zwraca liczbę obiektów raportu. Nieobsługiwane w Qlik Sense. |
| ReportComment | Zwraca komentarz do raportu. Nieobsługiwane w Qlik Sense. |
| ReportId | Zwraca identyfikator raportu. Nieobsługiwane w Qlik Sense. |
| ReportName | Zwraca nazwę raportu. Nieobsługiwane w Qlik Sense. |
| ReportNumber | Zwraca numer raportu. Nieobsługiwane w Qlik Sense. |
Wyniki dotyczące nieobsługiwanych funkcji pojawiają się obok wyników dotyczących stosowania cudzysłowów w analizie zestawów w arkuszu Expression_Findings oraz w sekcji Potencjalne problemy z wyrażeniami podsumowania konsoli.
Zakładki programisty
QV2QS odczytuje DocInternals.xml i wyświetla listę wszystkich zakładek utworzonych przez programistę. Dla każdej zakładki analiza raportuje wybory pól, zakres (globalny lub specyficzny dla arkusza) oraz to, czy stan układu jest zapisany. Zakładki muszą zostać ręcznie odtworzone w Qlik Sense.
Zakładki na poziomie serwera (współdzielone i prywatne) nie są wykrywalne z poziomu folderu PRJ.
Wymiarowanie SaaS
QV2QS odczytuje plik binarny QVW, aby oszacować bazowe zapotrzebowanie aplikacji na pamięć RAM. Oszacowanie opiera się na ByteSize metadanych osadzonych w opisach tabel i pól.
Metadane ByteSize są dostępne tylko w plikach QVW zapisanych w programie QlikView 12.30 lub nowszym (listopad 2018). Jeśli metadane nie są obecne, poziom wielkości jest zgłaszany jako Unknown.
QV2QS klasyfikuje aplikację do jednego z następujących poziomów na podstawie bazowego zużycia pamięci RAM.
| Tier | Próg | Działanie |
|---|---|---|
| Standardowy | Do 5 GB | Brak wymaganych działań specjalnych. |
| Duże aplikacje | Do 50 GB | Wdróż do przestrzeni z włączoną obsługą dużych aplikacji. |
| Wymaga optymalizacji | Powyżej 50 GB | Przed migracją skonsultuj się z administratorem Qlik lub partnerem Qlik. |
Tabela szczegółów określania rozmiaru w arkuszu Analysis podaje również liczbę tabel i pól (z wyłączeniem tabel i pól systemowych). Aby uzyskać szczegółowe informacje na temat kardynalności pól, liczby wierszy w tabelach oraz rozmiarów poszczególnych obiektów w bajtach, zobacz arkusze Data_Model_Fields i Data_Model_Tables w raporcie programu Excel.
Poziomy ufności
Każdy wynik dotyczący skryptu ładowania zawiera poziom pewności, który wskazuje prawdopodobieństwo rzeczywistego problemu ze zgodnością.
- Wysoki — wzorzec jest specyficzny. To ustalenie z bardzo dużym prawdopodobieństwem stanowi rzeczywisty problem ze zgodnością.
- Średni — Wzorzec może dopasować nieistotny kod. Zweryfikuj ręcznie.
- Niski — Wzorzec jest szeroki. Przejrzyj oznaczony wiersz, aby potwierdzić jego istotność.
Wyniki dotyczące właściwości dokumentów i makr nie mają poziomów ufności, ponieważ opierają się na jawnych flagach XML, a nie na dopasowywaniu wzorców.
Ograniczenia analizy
Analiza skanuje wyłącznie folder PRJ i plik binarny QVW. Skaner skryptu ładowania wykrywa nieobsługiwane instrukcje i funkcje w LoadScript.txt. Skaner skryptu ładowania nie sprawdza wyrażeń wykresu.
Skaner wyrażeń sprawdza wyrażenia wykresu (wymiary, miary, warunki wyświetlania, wyrażenia kolorów, wyrażenia tekstowe i definicje zmiennych) pod kątem wzorców stosowania cudzysłowów w analizie zbiorów oraz nieobsługiwanych wywołań funkcji. Skaner wyrażeń nie wykrywa innych kategorii niezgodności w wyrażeniach wykresu.
Elementy istniejące na poziomie QlikView Server nie są wykrywane. Niewykryte elementy obejmują zakładki serwera, obiekty serwera, ustawienia klastra, warunki alarmów, definicje raportów oraz dane dotyczące użycia sesji.