Przesyłanie rozszerzeń wizualizacji i zarządzanie nimi
Ostatnia aktualizacja: 20.10.2026Rozszerzenia dodają niestandardowe możliwości wizualizacji do aplikacji Qlik Cloud. Można przesyłać rozszerzenia i zarządzać nimi w centrum aktywności Administrowanie.
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:
-
Administratorzy 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 dla 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 Analyticscentrum aktywności.
-
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: stan migracji rozszerzenia
Informacje o statusie migracji
Qlik przeniósł rozszerzenia ze starszego magazynu do usługi używanej do zarządzania rozszerzeniami. Status migracji wskazuje bieżący stan migracji rozszerzenia.
Wartości statusu migracji:
-
Migrowano: Rozszerzenie zostało pomyślnie zmigrowane i jest dostępne.
-
Niedostępne: Rozszerzenie nie jest już dostępne i nie można go zmigrować. Usuń rozszerzenie z centrum aktywności Administrowanie.
Dodawanie rozszerzeń
Wykonaj następujące czynności:
- W centrum aktywności Administrowanie wybierz Rozszerzenia.
-
Kliknij Dodaj.
-
Kliknij przycisk Przeglądaj, aby wybrać plik rozszerzenia, lub upuść plik w wyznaczonym obszarze.
-
Opcjonalnie dodaj znaczniki.
-
Kliknij polecenie Opublikuj.
Edytowanie rozszerzeń
Wykonaj następujące czynności:
- W centrum aktywności Administrowanie wybierz Rozszerzenia.
-
Na rozszerzeniu do edycji kliknij
i wybierz Edytuj. -
Użyj panelu edycji, aby zastąpić rozszerzenie lub zaktualizować tagi.
-
Zapisz zmiany.
Pobieranie rozszerzeń
Użyj tej opcji, aby utworzyć kopię zapasową rozszerzenia przed jego edycją lub przenieść je do innej dzierżawy.
Wykonaj następujące czynności:
- W centrum aktywności Administrowanie wybierz Rozszerzenia.
-
Na rozszerzeniu, które chcesz pobrać, kliknij
i wybierz Pobierz. -
Zapisz plik ZIP.
Usuwanie rozszerzeń
Usunięcie rozszerzenia może mieć wpływ na wszystkie zasoby oraz wszystkich użytkowników w dzierżawie.
Wykonaj następujące czynności:
- W centrum aktywności Administrowanie wybierz Rozszerzenia.
- Wybierz rozszerzenia do usunięcia.
- Kliknij polecenie Usuń.