Zarządzanie rozszerzeniami
Rozszerzenia zwiększają funkcjonalność platformy analitycznej Qlik Cloud, umożliwiając tworzenie niestandardowych wizualizacji dla aplikacji Qlik Sense. Rozszerzenia można przesyłać i edytować w centrum aktywności Administrowanie.
Wskazówki dotyczące tworzenia i przesyłania rozszerzeń
Podczas tworzenia i przesyłania rozszerzeń wizualizacji do Qlik Cloud przestrzegaj następujących wskazówek.
Aby zapoznać się z wizualną prezentacją dodawania i używania rozszerzeń, zobacz Korzystanie z rozszerzeń wizualizacji innych firm w Qlik Cloud oraz Rozszerzenia i klucze interfejsu API.
Limity plików ZIP rozszerzeń
-
Maksymalny rozmiar pliku ZIP: 30 MB
-
Maksymalny rozmiar plików w pliku ZIP: 30 MB
-
Maksymalna liczba plików w pliku ZIP: 500
-
Maksymalny całkowity rozmiar nieskompresowanych plików w pliku ZIP: 100 MB
Najlepsze praktyki
-
Zminimalizuj pliki kodu.
-
Uwzględnij tylko niezbędne pliki. Plik ZIP powinien zawierać tylko pliki wymagane do prawidłowego działania rozszerzenia.
-
Przejrzyj rozszerzenia i ich kod przed przesłaniem. Aby uzyskać więcej informacji, zobacz temat Rozszerzenia wizualizacji (tylko w języku angielskim).
Wymagane pliki bazowe dla rozszerzenia
Sprawdź, czy plik ZIP rozszerzenia zawiera następujące niezbędne pliki:
-
.qext: plik metadanych rozszerzenia
-
.js: kod JavaScript rozszerzenia
-
.html: kod HTML do renderowania rozszerzenia
-
.css: niestandardowy arkusz stylów CSS do stylizacji rozszerzenia
Zewnętrzny hosting plików graficznych
W pliku ZIP z rozszerzeniem nie należy przesyłać plików graficznych (na przykład GIF, PNG, JPG). Zamiast tego powinny one być hostowane na zewnątrz na osobistym serwerze aplikacji, w zasobniku S3 albo w publicznym systemie zarządzania treścią. Odwołuj się do tych zewnętrznych grafik w kodzie rozszerzenia.
Odwoływanie się do zewnętrznych plików kodu oraz zawartości
Do plików kodu oraz zawartości można się odwoływać w podstawowym kodzie rozszerzenia, ale wymaga to wdrożenia polityki zabezpieczeń zawartości (CSP) w dzierżawie. Więcej informacji zawiera temat Zarządzanie Content Security Policy.
Jeżeli rozszerzenie wysyła żądania do zasobów zewnętrznych, pochodzenie zasobów musi znajdować się na liście dozwolonych w CSP. W przeciwnym razie rozszerzenie nie będzie mogło się renderować.
Nieobsługiwane funkcje
Następujące funkcje są nieobsługiwane:
Rozszerzenia w pakietach
Qlik Cloud nie obsługuje plików ZIP zawierających inne pliki ZIP rozszerzeń.
Pliki QVF i QVD
Nie dołączaj plików Qlik Sense QVF ani QVD w pliku ZIP rozszerzenia, ponieważ nie są one dostępne z usługi rozszerzenia. Przed przesłaniem rozszerzenia należy usunąć te pliki.
Aby przesłać plik QVF lub QVD do dzierżawy Qlik Cloud, użyj jednej z następujących metod:
-
Prześlij aplikację na stronie Utwórz centrum aktywności Analytics.
-
Prześlij aplikację za pomocą qlik-cli.
-
Prześlij plik QVD na stronie Utwórz centrum aktywności Analytics.
-
Prześlij plik QVD za pomocą Qlik DataTransfer.
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) to standardowy sposób na wskazanie charakteru oraz formatu pliku. Przesłanie nie powiedzie się, jeśli Twoje rozszerzenie będzie zawierać na przykład plik wykonywalny lub plik ZIP.
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”
Wszystkie pliki w rozszerzeniu muszą mieć zarówno nazwę, jak i rozszerzenie pliku. Pliki niezgodne z tym wymaganiem zostaną zignorowane. Przykłady ignorowanych plików obejmują .gitignore i README.
Dodawanie rozszerzeń i zarządzanie nimi
Rozszerzeniami zarządza się w centrum aktywności Administrowanie, na stronie Rozszerzenia.
W tabeli Rozszerzenia:
-
Nazwa odnosi się do nazwy metadanych w pliku QEXT.
-
Wersja QEXT wskazuje wersję metadanych w pliku QEXT.
-
Nazwa pliku QEXT jest unikatowym identyfikatorem oraz nazwą pliku definicji rozszerzenia.
Rozszerzenia można filtrować według znaczników.
Dodawanie nowego rozszerzenia
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 rozszerzenia
Wykonaj następujące czynności:
- W centrum aktywności Administrowanie wybierz Rozszerzenia.
-
Na rozszerzeniu do edycji kliknij i wybierz Edytuj.
Wyświetlany panel edycji zawiera opcje zastępowania istniejącego rozszerzenia i dodawania oraz usuwania znaczników.
-
Zapisz zmiany.
Usuwanie rozszerzenia
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ń.