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:

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, które nie są zgodne, są ignorowane. 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ę na stronie 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 za pomocą 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 zasobu podczas migracji

Informacje o statusie migracji

Qlik ulepsza sposób obsługi rozszerzeń przez platformę. W trakcie tego przejścia, niektóre istniejące rozszerzenia zostały przeniesione do nowej usługi.

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.
Od 2026-06-30 rozszerzenia, które były nadal przechowywane wyłącznie w starszej pamięci masowej, są oznaczane jako Nie migrowano. Nie możesz już ręcznie migrować tych rozszerzeń.

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. Szczegółowe informacje można znaleźć na stronie: Przesyłanie kompozycji i zarządzanie nimi.

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.

Nie można przesłać rozszerzenia o takiej samej nazwie pliku QEXT jak istniejący już plik.

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 Usuń.

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ę