Hochladen und Verwalten von Visualisierungserweiterungen
Erweiterungen erweitern die Funktionalität der Qlik Cloud Analyseplattform und ermöglichen benutzerdefinierte Visualisierungen für Qlik Sense Apps. Sie können Erweiterungen über das Aktivitätscenter Verwaltung hochladen und bearbeiten.
Richtlinien für das Erstellen und Hochladen von Erweiterungen
Befolgen Sie die folgenden Richtlinien, wenn Sie Visualisierungserweiterungen erstellen und an Qlik Cloud hochladen:
Eine visuelle Demo zum Hinzufügen und Verwenden von Erweiterungen finden Sie unter Verwenden von Drittanbieter-Visualisierungserweiterungen in Qlik Cloud und Erweiterungen und API-Schlüssel.
ZIP-Dateibeschränkungen für Erweiterungen
-
Maximale ZIP-Dateigröße: 30 MB
-
Maximale Größe der Dateien in ZIP: 30 MB
-
Maximale Anzahl Dateien in ZIP: 500
-
Maximale unkomprimierte Gesamtgröße der Dateien in ZIP: 100 MB
Best Practices
-
Halten Sie Ihre Codedateien so klein wie möglich.
-
Schließen Sie nur notwendige Dateien ein. Vergewissern Sie sich, dass die ZIP-Datei nur die Dateien enthält, die erforderlich sind, damit die Erweiterung ordnungsgemäß funktioniert.
-
Überprüfen Sie vor dem Hochladen die Erweiterungen und ihren Code. Weitere Informationen finden Sie unter Visualisierungserweiterungen (nur auf Englisch).
Erforderliche Basisdateien für eine Erweiterung
Vergewissern Sie sich, dass Ihre Erweiterungs-ZIP-Datei die folgenden wesentlichen Dateien enthält:
-
.qext: Erweiterungs-Metadatendatei
-
.js: JavaScript-Code für die Erweiterung
-
.html: HTML-Code zum Rendern der Erweiterung
-
.css: Benutzerdefinierte CSS für das Design der Erweiterung
Externes Hosten von Bilddateien
Laden Sie innerhalb der Erweiterungs-ZIP-Datei keine Bild-Dateien (z. B. GIF, PNG, JPG) hoch. Hosten Sie diese stattdessen extern, entweder auf einem persönlichen Anwendungsserver, in einem S3-Bucket oder in einem öffentlichen Inhaltsmanagementsystem. Referenzieren Sie diese externen Bilder in Ihrem Erweiterungscode.
Referenzieren externer Codedateien und Inhalte
Sie können Codedateien und Inhalte im primären Erweiterungscode referenzieren; dies erfordert jedoch die Implementierung einer Content Security Policy (CSP) auf dem Mandanten. Weitere Informationen finden Sie unter Verwalten von Content Security Policy (CSP).
Wenn Ihre Erweiterung Ressourcenanforderungen an externe Ressourcen stellt, muss deren Herkunft auf der Zulassungsliste der CSP stehen. Andernfalls wird das Rendern der Erweiterung blockiert.
Nicht unterstützte Funktionen
Die folgenden Funktionen werden nicht unterstützt:
Gebündelte Erweiterungen
Qlik Cloud unterstützt keine ZIP-Dateien, die andere Erweiterungs-ZIP-Dateien enthalten.
QVF- und QVD-Dateien
Schließen Sie keine Qlik Sense QVF- oder QVD-Dateien in die Erweiterungs-ZIP-Datei ein, da auf diese Dateien vom Erweiterungsdienst nicht zugegriffen werden kann. Entfernen Sie diese Dateien, bevor Sie die Erweiterung hochladen.
Verwenden Sie eine der folgenden Methoden, um eine QVF- oder QVD-Datei an den Qlik Cloud Mandanten hochzuladen:
-
Laden Sie eine App auf der Seite „Erstellen“ des Aktivitätscenters Analysen hoch.
-
Laden Sie eine App mit qlik-cli hoch.
-
Laden Sie eine QVD im Aktivitätscenter Analysen auf der Seite Erstellen hoch.
-
Laden Sie eine QVD mit Qlik DataTransfer hoch.
Nicht unterstützte Dateiformate
Aus Sicherheitsgründen dürfen Erweiterungen keine Dateien mit nicht zulässigen MIME-Typen enthalten. MIME-Typen (Multipurpose Internet Mail Extensions) sind eine Standardmethode, um die Art und das Format einer Datei anzugeben. Das Hochladen schlägt fehl, wenn die Erweiterung beispielsweise eine ausführbare Datei oder eine ZIP-Datei enthält.
Folgende MIME-Typen sind nicht zulässig:
- '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'
Alle Dateien in einer Erweiterung müssen sowohl einen Dateinamen als auch eine Dateierweiterung aufweisen. Dateien, die diese Kriterien nicht erfüllen, werden ignoriert. Beispiele für ignorierte Dateien sind .gitignore und README.
Hinzufügen und Verwalten von Erweiterungen
Erweiterungen werden im Aktivitätscenter Verwaltung auf der Seite Erweiterungen verwaltet.
In der Tabelle Erweiterungen gilt:
-
Name bezieht sich auf den Metadatennamen in der QEXT-Datei.
-
QEXT-Version gibt die Metadatenversion in der QEXT-Datei an.
-
QEXT-Dateiname ist der eineindeutige Identifikator und der Name der Erweiterungsdefinitionsdatei.
Sie können Erweiterungen nach Tags filtern.
Hinzufügen einer neuen Erweiterung
Gehen Sie folgendermaßen vor:
- Gehen Sie im Aktivitätscenter Verwaltung zu Erweiterungen.
-
Klicken Sie auf Hinzufügen.
-
Klicken Sie auf Durchsuchen, um eine Erweiterungsdatei auszuwählen, oder legen Sie eine Datei im dafür vorgesehenen Bereich ab.
-
Fügen Sie optional Tags hinzu.
-
Klicken Sie auf Veröffentlichen.
Bearbeiten einer Erweiterung
Gehen Sie folgendermaßen vor:
- Gehen Sie im Aktivitätscenter Verwaltung zu Erweiterungen.
-
Klicken Sie für die Erweiterung, die Sie bearbeiten möchten, auf
und wählen Sie Bearbeiten aus.Das Bearbeitungsfenster wird angezeigt und bietet Optionen zum Ersetzen der vorhandenen Erweiterung und Hinzufügen oder Entfernen von Tags.
-
Speichern Sie die Änderungen.
Löschen einer Erweiterung
Das Löschen von Erweiterungen kann Auswirkungen auf alle Ressourcen haben und betrifft alle Benutzer innerhalb des Mandanten.
Gehen Sie folgendermaßen vor:
- Gehen Sie im Aktivitätscenter Verwaltung zu Erweiterungen.
- Wählen Sie die Erweiterungen aus, die Sie löschen möchten.
- Klicken Sie auf Löschen.