Hochladen und Verwalten von Visualisierungserweiterungen

Erweiterungen fügen benutzerdefinierte Visualisierungsfunktionen zu Qlik Cloud Anwendungen hinzu. Sie können Erweiterungen über das Aktivitätscenter Administration hochladen und bearbeiten.

Erweiterungen von Drittanbietern werden in Qlik Cloud Government unterstützt. Ihre Verwendung kann eine Genehmigung als Teil einer behördlichen Betriebsgenehmigung erfordern, abhängig von den Sicherheits- und Compliance-Anforderungen Ihrer Organisation.

Verwenden von Erweiterungen

Visualisierungserweiterungen in Qlik Cloud fügen neue visuelle Komponenten über die Standardvisualisierungen hinaus hinzu. Verwenden Sie sie, um anzupassen, wie Sie Daten präsentieren und untersuchen.

Weitere Informationen finden Sie unter Qlik Developer: Erweitern von Qlik. Eine visuelle Demo finden Sie unter Verwenden von Drittanbieter-Visualisierungserweiterungen in Qlik Cloud und Erweiterungen und API-Schlüssel.

Erforderliche Rollen

Um Erweiterungen hochzuladen und zu verwalten, müssen Sie eine der folgenden Rollen innehaben:

Mandantenadministrator
Analytics-Administrator
Benutzerdefinierte Benutzerrolle mit der Berechtigung Erweiterungen verwalten, die auf Zulässig gesetzt ist

Dateianforderungen und -beschränkungen

Beachten Sie diese Regeln, um sicherzustellen, dass Ihre Erweiterung korrekt hochgeladen wird und funktioniert.

Dateibeschränkungen

ZIP-Dateien von Erweiterungen unterliegen diesen Beschränkungen:

Maximale ZIP-Dateigröße: 30 MB
Maximale Größe für eine einzelne Datei im ZIP-Archiv: 30 MB
Maximale Anzahl der Dateien im ZIP-ARchiv: 500
Maximale Gesamtgröße unkomprimiert: 100 MB

Erforderliche Basisdateien für eine Erweiterung

Vergewissern Sie sich, dass Ihre Erweiterungs-ZIP-Datei die folgenden Dateien enthält:

.qext: Metadatendatei
.js: JavaScript-Code
.html: HTML-Rendering-Code
.css: Benutzerdefiniertes Styling

Dateibenennungsregeln

Alle Dateien in der Erweiterung müssen einen Dateinamen und eine Dateierweiterung aufweisen. Dateien, die diese Kriterien nicht erfüllen, werden ignoriert. Beispiele für ignorierte Dateien sind .gitignore und README.

Best Practices

Halten Sie Ihre Codedateien so klein wie möglich.
Fügen Sie nur die Dateien ein, die Ihre Erweiterung zum Ausführen benötigt.
Überprüfen Sie die Erweiterung und ihren Code, bevor Sie sie hochladen.

Externe Ressourcen und CSP

Bilddateien extern hosten

Laden Sie innerhalb der Erweiterungs-ZIP-Datei keine Bild-Dateien (z. B. GIF, PNG, JPG) hoch. Hosten Sie Bilder stattdessen extern (z. B. auf einem Anwendungsserver, einem S3-Bucket oder einem öffentlichen Content-Management-System) und verweisen Sie in Ihrem Erweiterungscode darauf.

Externe Codedateien und Inhalte referenzieren

Um externen Code oder Inhalt in Ihrer Erweiterung zu referenzieren, konfigurieren Sie eine Mandanten-Content Security Policy (CSP) und setzen Sie die externen Ursprünge, auf die Ihre Erweiterung zugreifen muss, in eine Zulassungsliste.

Wenn ein Ursprung nicht in der Zulassungsliste steht, wird Ihre Erweiterung nicht gerendert.

Weitere Informationen finden Sie unter Verwalten der Inhaltssicherheitsrichtlinie (Content Security Policy, CSP).

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) geben das Format einer Datei an. Der Upload schlägt fehl, wenn die Erweiterung einen nicht zulässigen MIME-Typ (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'

Nicht unterstützte Funktionen

Die folgenden Funktionen werden nicht unterstützt:

Erweiterungen als Bundle: ZIP-Dateien, die mehrere Erweiterungen als ZIP-Dateien enthalten, werden nicht unterstützt.
QVF- und QVD-Dateien: Diese Dateien sind vom Erweiterungsdienst aus nicht zugänglich.

Verwenden Sie eine der folgenden Methoden, um eine QVF- oder QVD-Datei hochzuladen:

Laden Sie eine Anwendung auf der Seite Erstellen im Aktivitätscenter Analysen hoch.
Laden Sie eine Anwendung mithilfe von qlik-cli hoch.
Laden Sie eine QVD-Datei im Aktivitätscenter Analysen auf der Seite Erstellen hoch.
Laden Sie eine QVD-Datei mithilfe von Qlik DataTransfer hoch.

Verwalten von Erweiterungen

Erweiterungen werden im Aktivitätscenter Administration auf der Seite Erweiterungen verwaltet.

Informationen zur Erweiterungstabelle

Name: Metadatenname in der QEXT-Datei
QEXT-Version: Metadatenversion
QEXT-Dateiname: Eindeutiger Identifikator für die Erweiterungsdefinitionsdatei
Status: Migrationsstatus (temporär)

Über den Migrationsstatus

Qlik verbessert die Art und Weise, wie die Plattform Erweiterungen handhabt. Während dieser Umstellung werden bestehende Erweiterungen in einen neuen Dienst verschoben. Die Spalte für den Migrationsstatus ist temporär und wird nur angezeigt, solange diese Arbeit im Gange ist.

Ab dem 17.11.2025 verwendet jede Erweiterung, die Sie hochladen oder auf die Sie zugreifen, automatisch den neuen Dienst. Wenn Ihre Erweiterung regelmäßig verwendet wird, ist keine Aktion erforderlich.

Die meisten Erweiterungen werden bei ihrer Verwendung automatisch migriert. Erweiterungen, die Sie in letzter Zeit nicht verwendet haben, müssen möglicherweise manuell in die Warteschlange gestellt werden, damit sie in einen geplanten Migrationslauf aufgenommen werden. Zum Schutz kundenbezogener Inhalte migriert Qlik Erweiterungen nur, wenn auf sie zugegriffen wird oder Sie die Migration bestätigen. Wenn Sie eine ungenutzte Erweiterung (Status Nicht migriert) verfügbar halten möchten, können Sie sie manuell migrieren.

Werte für den Migrationsstatus:

Nicht migriert: Die Erweiterung wurde nicht migriert.
Zur Migration in Warteschlange: Die Erweiterung wurde in die Warteschlange gestellt und wird beim nächsten geplanten Migrationslauf migriert.
Migration läuft: Die Erweiterung wird derzeit migriert.
Migriert: Die Erweiterung wurde erfolgreich migriert.

Auch Formatvorlagen werden migriert. Weitere Einzelheiten finden Sie unter Hochladen und Verwalten von Formatvorlagen.

Hinzufügen von Erweiterungen

Gehen Sie folgendermaßen vor:

Gehen Sie im Aktivitätscenter Administration 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.

Es ist nicht möglich, eine Erweiterung mit einem vorhandenen QEXT-Dateinamen hochzuladen.

Bearbeiten von Erweiterungen

Gehen Sie folgendermaßen vor:

Gehen Sie im Aktivitätscenter Administration zu Erweiterungen.
Klicken Sie für die Erweiterung, die Sie bearbeiten möchten, auf und wählen Sie Bearbeiten aus.
Verwenden Sie den Bearbeitungsbereich, um die Formatvorlage zu ersetzen oder Tags zu aktualisieren.
Speichern Sie die Änderungen.

Herunterladen von Erweiterungen

Verwenden Sie dies, um eine Erweiterung zu sichern, bevor Sie sie bearbeiten, oder um sie in einen anderen Mandanten zu verschieben.

Gehen Sie folgendermaßen vor:

Gehen Sie im Aktivitätscenter Administration zu Erweiterungen.
Klicken Sie für die Erweiterung, die Sie herunterladen möchten, auf und wählen Sie Herunterladen aus.
Speichern Sie die ZIP-Datei.

Migrieren von Erweiterungen

Führen Sie die folgenden Schritte aus, um Erweiterungen mit dem Status Nicht migriert zu migrieren.

Gehen Sie folgendermaßen vor:

Gehen Sie im Aktivitätscenter Administration zu Erweiterungen.
Klicken Sie für die Erweiterung, die Sie migrieren möchten, auf und wählen Sie Migrieren aus.

Der Status wird während des Migrationsfortschritts aktualisiert: Zur Migration in Warteschlange, Migration läuft und schließlich Migriert.

Löschen von Erweiterungen

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 Administration zu Erweiterungen.
Wählen Sie die Erweiterungen aus, die Sie löschen möchten.
Klicken Sie auf Löschen.

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab