Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

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.

Uwaga dotycząca Qlik Cloud GovernmentRozszerzenia innych firm nie są obsługiwane w Qlik Cloud Government. Jednakże, w zależności od wymogów bezpieczeństwa i zgodności z przepisami obowiązujących w danej organizacji, korzystanie z rozszerzeń innych firm może wymagać zdefiniowania i zatwierdzenia w ramach upoważnienia Agencji do działania.

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:

  1. W centrum aktywności Administrowanie wybierz Rozszerzenia.
  2. Kliknij Dodaj.

  3. Kliknij przycisk Przeglądaj, aby wybrać plik rozszerzenia, lub upuść plik w wyznaczonym obszarze.

  4. Opcjonalnie dodaj znaczniki.

  5. Kliknij polecenie Opublikuj.

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

Edytowanie rozszerzenia

Wykonaj następujące czynności:

  1. W centrum aktywności Administrowanie wybierz Rozszerzenia.
  2. Na rozszerzeniu do edycji kliknij Więcej i wybierz Edytuj.

    Wyświetlany panel edycji zawiera opcje zastępowania istniejącego rozszerzenia i dodawania oraz usuwania znaczników.

  3. 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:

  1. W centrum aktywności Administrowanie wybierz Rozszerzenia.
  2. Wybierz rozszerzenia do usunięcia.
  3. Kliknij polecenie 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ć, co możemy poprawić!