Przesyłanie rozszerzeń wizualizacji i zarządzanie nimi

Rozszerzenia dodają niestandardowe możliwości wizualizacji do aplikacji Qlik Cloud. Można przesyłać rozszerzenia i zarządzać nimi w centrum aktywności Administrowanie.

Rozszerzenia innych firm nie są obsługiwane w Qlik Cloud Government. Korzystanie z nich może wymagać zatwierdzenia w ramach uprawnień Agencji do działania, w zależności od wymagań bezpieczeństwa i zgodności Twojej organizacji.

Korzystanie z rozszerzeń

Rozszerzenia wizualizacji w Qlik Cloud dodają nowe komponenty wizualne wykraczające poza standardowe wizualizacje. Użyj ich, aby dostosować sposób prezentowania i eksplorowania danych.

Więcej informacji zawiera Portal dla deweloperów Qlik: Rozszerzanie Qlik. Aby zapoznać się z wizualną prezentacją, zobacz Korzystanie z rozszerzeń wizualizacji innych firm w Qlik Cloud oraz Rozszerzenia i klucze interfejsu API.

Wymagane role

Aby przekazywać rozszerzenia i zarządzać nimi, musisz mieć jedną z następujących ról:

Administrator dzierżawy
Administrator analityki
Niestandardowa rola z uprawnieniem Zarządzaj rozszerzeniami ustawionym na Dozwolone

Wymagania dotyczące plików i limity

Przestrzegaj tych zasad, aby upewnić się, że Twoje rozszerzenie przesyła się i działa poprawnie.

Limity plików

Pliki ZIP rozszerzeń mają następujące limity:

Maksymalny rozmiar pliku ZIP: 30 MB
Maksymalny rozmiar pojedynczego pliku w pliku ZIP: 30 MB
Maksymalna liczba plików w pliku ZIP: 500
Maksymalny całkowity rozmiar nieskompresowany: 100 MB

Wymagane pliki bazowe dla rozszerzenia

Sprawdź, czy plik ZIP rozszerzenia zawiera następujące pliki:

.qext: plik metadanych
.js: kod JavaScript
.html: kod renderowania HTML
.css: Niestandardowe style

Zasady nazewnictwa plików

Każdy plik w rozszerzeniu musi mieć nazwę i rozszerzenie pliku. Pliki niezgodne z tym wymaganiem zostaną zignorowane. Przykłady ignorowanych plików obejmują .gitignore i README.

Najlepsze praktyki

Zminimalizuj pliki kodu.
Dołącz tylko pliki, których rozszerzenie potrzebuje do działania.
Przejrzyj rozszerzenie i jego kod przed przesłaniem.

Zasoby zewnętrzne i CSP

Hostuj pliki obrazów zewnętrznie

Nie należy dołączać plików graficznych (takich jak GIF, PNG, JPG) do pliku ZIP rozszerzenia. Zamiast tego hostuj obrazy zewnętrznie (na przykład na serwerze aplikacji, w zasobniku S3 lub w publicznym systemie zarządzania treścią) i odwołuj się do nich z kodu rozszerzenia.

Odwoływanie się do zewnętrznego kodu i zawartości

Aby odwoływać się do zewnętrznego kodu lub zawartości w rozszerzeniu, skonfiguruj zasady zabezpieczeń zawartości dzierżawy (CSP) i dodaj do białej listy zewnętrzne źródła, do których rozszerzenie musi mieć dostęp.

Jeśli źródło nie zostanie dodane do białej listy, rozszerzenie nie zostanie wyrenderowane.

Więcej informacji zawiera temat Zarządzanie zasadami zabezpieczeń zawartości (CSP).

Nieobsługiwane formaty plików

Ze względów bezpieczeństwa rozszerzenia nie mogą zawierać plików z niedozwolonymi typami MIME. Typy MIME (Multipurpose Internet Mail Extensions) wskazują format pliku. Jeśli Twoje rozszerzenie zawiera niedozwolony typ MIME (na przykład plik wykonywalny lub plik ZIP), przesyłanie nie powiedzie się.

Następujące typy MIME są niedozwolone:

„application/octet-stream”
„application/x-coredump”
„application/x-dosexec”
„application/x-executable”
„application/x-java-applet”
„application/x-object”
„application/x-sharedlib”
„application/zip”
„text/x-shellscript”
„text/x-awk”
„text/x-gawk”
„text/x-msdos-batch”
„text/x-nawk”
„text/x-php”

Nieobsługiwane funkcje

Następujące funkcje są nieobsługiwane:

Pakiety rozszerzeń: Pliki ZIP zawierające inne pliki ZIP rozszerzeń nie są obsługiwane.
Pliki QVF i QVD: Te pliki nie są dostępne z usługi rozszerzeń.

Aby przesłać pliki QVF lub QVD, użyj jednej z następujących metod:

Prześlij aplikację ze strony Utwórz w centrum aktywności Analytics.
Prześlij aplikację, używając qlik-cli.
Prześlij plik QVD ze strony Utwórz w centrum aktywności Analytics.
Prześlij plik QVD, używając Qlik DataTransfer.

Zarządzanie rozszerzeniami

Rozszerzeniami zarządza się na stronie Rozszerzenia w centrum aktywności Administrowanie.

Informacje o tabeli rozszerzeń

Nazwa: Nazwa metadanych w pliku QEXT
Wersja QEXT: Wersja metadanych
Nazwa pliku QEXT: Unikatowy identyfikator pliku definicji rozszerzenia
Status: Status migracji (tymczasowy)

Informacje o statusie migracji

Qlik ulepsza sposób obsługi rozszerzeń przez platformę. W trakcie tego przejścia istniejące rozszerzenia są przenoszone do nowej usługi. Kolumna statusu migracji jest tymczasowa i pojawia się tylko w trakcie trwania tych prac.

Od 2025-11-17 każde rozszerzenie, które przesyłasz lub do którego uzyskujesz dostęp, automatycznie korzysta z nowej usługi. Jeśli Twoje rozszerzenie jest w regularnym użyciu, nie są wymagane żadne działania.

Większość rozszerzeń migruje automatycznie, gdy są używane. Rozszerzenia, których ostatnio nie używano, mogą wymagać ręcznego dodania do kolejki, aby zostały uwzględnione w zaplanowanym uruchomieniu migracji. Aby chronić treści należące do klienta, Qlik nie migruje rozszerzeń, chyba że są one dostępne lub potwierdzisz migrację. Jeśli chcesz zachować nieużywane rozszerzenie (status Nie migrowano) jako dostępne, możesz je zmigrować ręcznie.

Wartości statusu migracji:

Nie migrowano: Rozszerzenie nie zostało zmigrowane.
W kolejce do migracji: Rozszerzenie zostało dodane do kolejki i zostanie zmigrowane podczas następnego zaplanowanego uruchomienia migracji.
Migracja w toku: Rozszerzenie jest obecnie migrowane.
Migrowano: Rozszerzenie zostało pomyślnie zmigrowane.

Migracja dotyczy również kompozycji. Aby uzyskać szczegółowe informacje, zobacz temat Przesyłanie kompozycji i zarządzanie nimi.