Visualisatie-uitbreidingen uploaden en beheren

Extensies voegen aangepaste visualisatiemogelijkheden toe aan Qlik Cloud applicaties. U kunt uitbreidingen uploaden en beheren in het Beheer-activiteitencentrum.

Externe uitbreidingen worden ondersteund in Qlik Cloud Government. Het gebruik ervan kan goedkeuring vereisen als onderdeel van een 'Agency Authority to Operate', afhankelijk van de beveiligings- en compliancevereisten van uw organisatie.

Uitbreidingen gebruiken

Visualisatie-uitbreidingen in Qlik Cloud voegen nieuwe visuele componenten toe die verder gaan dan de standaardvisualisaties. Gebruik ze om aan te passen hoe u gegevens presenteert en verkent.

Zie voor meer informatie: Qlik Developer: Qlik uitbreiden. Voor een visuele demo, zie Visualisatie-uitbreidingen van derden gebruiken in Qlik Cloud en Uitbreidingen en API-sleutels.

Vereiste rollen

Om uitbreidingen te uploaden en te beheren, moet u een van de volgende rollen hebben:

Tenantbeheerder
Analytics-beheerder
Aangepaste rol met de machtiging Uitbreidingen beheren ingesteld op Toegestaan

Bestandsvereisten en -limieten

Volg deze regels om ervoor te zorgen dat uw uitbreiding correct wordt geüpload en werkt.

Bestandslimieten

ZIP-bestanden van uitbreidingen hebben deze limieten:

Maximum ZIP‑bestandsgrootte: 30 MB
Maximale grootte voor één bestand in het ZIP-bestand: 30 MB
Maximumaantal bestanden in het ZIP-bestand: 500
Maximale totale gedecomprimeerde grootte: 100 MB

Verplichte basisbestanden voor een uitbreiding

Zorg ervoor dat uw ZIP-bestand van de uitbreiding de volgende bestanden bevat:

.qext: Metagegevensbestand
.js: JavaScript-code
.html: HTML-weergavecode
.css: Aangepaste styling

Regels voor bestandsnamen

Elk bestand in de uitbreiding moet een bestandsnaam en een bestandsextensie hebben. Bestanden die niet voldoen, worden genegeerd. Voorbeelden van genegeerde bestanden zijn .gitignore en README.

Aanbevolen procedures

Maak uw codebestanden zo klein mogelijk.
Neem alleen de bestanden op die uw uitbreiding nodig heeft om te kunnen worden uitgevoerd.
Controleer de uitbreiding en de code ervan voordat u deze uploadt.

Externe bronnen en CSP

Afbeeldingsbestanden extern hosten

Neem geen afbeeldingsbestanden (zoals GIF, PNG, JPG) op in het ZIP-bestand van de uitbreiding. Host afbeeldingen in plaats daarvan extern (bijvoorbeeld op een applicatieserver, een S3-bucket of een openbaar contentmanagementsysteem) en verwijs ernaar vanuit uw uitbreidingscode.

Verwijzen naar externe code en inhoud

Om naar externe code of inhoud in uw uitbreiding te verwijzen, configureert u een tenant Content Security Policy (CSP) en voegt u de externe origins die uw uitbreiding moet openen toe aan de allowlist.

Als een origin niet is allowlisted, wordt uw uitbreiding niet weergegeven.

Ga voor meer informatie naar Inhoudbeveiligingsbeleid (Content Security Policy - CSP) beheren.

Niet-ondersteunde bestandsindelingen

Vanwege beveiligingsredenen kunnen uitbreidingen geen bestanden bevatten met niet-toegestane MIME-typen. MIME-typen (Multipurpose Internet Mail Extensions) geven de indeling van een bestand aan. Als uw uitbreiding een niet-toegestaan MIME-type bevat (bijvoorbeeld een uitvoerbaar bestand of een ZIP-bestand), mislukt de upload.

De volgende MIME-typen zijn niet toegestaan:

'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'

Niet-ondersteunde functies

De volgende functies worden niet ondersteund:

Gebundelde uitbreidingen: ZIP-bestanden die andere ZIP-bestanden van uitbreidingen bevatten, worden niet ondersteund.
QVF- en QVD-bestanden: Deze bestanden zijn niet toegankelijk via de uitbreidingsservice.

Als u QVF- of QVD-bestanden wilt uploaden, volgt u een van de volgende methoden:

Upload een applicatie vanaf de Maken pagina in het Analyseactiviteitencentrum.
Upload een applicatie via qlik-cli.
Upload een QVD vanaf de Maken pagina in het Analyse activiteitencentrum.
Upload een QVD met behulp van Qlik DataTransfer.

Uitbreidingen beheren

Uitbreidingen worden beheerd op de pagina Uitbreidingen in het Beheer-activiteitencentrum.

Informatie over uitbreidingentabel

Naam: Metagegevensnaam in het QEXT-bestand
QEXT-versie: Metagegevensversie
QEXT-bestandsnaam: Unieke identificatie voor het definitiebestand van de uitbreiding
Status: Migratiestatus (tijdelijk)

Over migratiestatus

Qlik verbetert de manier waarop het platform omgaat met uitbreidingen. Tijdens deze overgang worden bestaande uitbreidingen verplaatst naar een nieuwe service. De kolom migratiestatus is tijdelijk en verschijnt alleen zolang dit werk bezig is.

Vanaf 17-11-2025 gebruikt elke uitbreiding die u uploadt of opent automatisch de nieuwe service. Als uw uitbreiding regelmatig wordt gebruikt, is er geen actie vereist.

De meeste uitbreidingen migreren automatisch wanneer ze worden gebruikt. Uitbreidingen die u recentelijk niet hebt gebruikt, moeten mogelijk handmatig in de wachtrij worden geplaatst om te worden opgenomen in een geplande migratierun. Om inhoud die eigendom is van de klant te beschermen, migreert Qlik geen uitbreidingen, tenzij deze worden geopend of u de migratie bevestigt. Als u een ongebruikte uitbreiding (status Niet gemigreerd) beschikbaar wilt houden, kunt u deze handmatig migreren.

Waarden voor migratiestatus:

Niet gemigreerd: De uitbreiding is niet gemigreerd.
In wachtrij voor migratie: De uitbreiding is in de wachtrij geplaatst en wordt gemigreerd tijdens de volgende geplande migratierun.
Migratie bezig: De uitbreiding wordt momenteel gemigreerd.
Gemigreerd: De uitbreiding is succesvol gemigreerd.

Migratie is ook van toepassing op thema's. Ga voor meer informatie naar Thema's uploaden en beheren.

Uitbreidingen toevoegen

Doe het volgende:

Ga naar Uitbreidingen in het Beheer-activiteitencentrum.
Klik op Toevoegen.
Klik op Bladeren om een uitbreidingsbestand te kiezen of versleep een bestand naar het daarvoor bedoelde vak.
Voeg desgewenst labels toe.
Klik op Publiceren.

U kunt geen uitbreiding uploaden die dezelfde QEXT-bestandsnaam heeft als een bestaande uitbreiding.

Uitbreidingen bewerken

Doe het volgende:

Ga naar Uitbreidingen in het Beheer-activiteitencentrum.
Klik op van de uitbreiding die u wilt bewerken en selecteer Bewerken.
Gebruik het bewerkingspaneel om de uitbreiding te vervangen of tags bij te werken.
Sla uw wijzigingen op.

Uitbreidingen downloaden

Gebruik dit om een uitbreiding te back-uppen voordat u deze bewerkt of om deze naar een andere tenant te verplaatsen.

Doe het volgende:

Ga naar Uitbreidingen in het Beheer-activiteitencentrum.
Klik op bij de uitbreiding die u wilt downloaden en selecteer Downloaden.
Sla het ZIP-bestand op.

Uitbreidingen migreren

Gebruik de volgende stappen om uitbreidingen met de status Niet gemigreerd te migreren.

Doe het volgende:

Ga naar Uitbreidingen in het Beheer-activiteitencentrum.
Klik op de uitbreiding die u wilt migreren op en selecteer Migreren.

De status wordt bijgewerkt naarmate de migratie vordert: In wachtrij voor migratie, Migratie bezig en ten slotte Gemigreerd.

Uitbreidingen verwijderen

Het verwijderen van uitbreidingen kan impact hebben op alle bronnen, wat gevolgen heeft voor alle gebruikers binnen de tenant.

Doe het volgende:

Ga naar Uitbreidingen in het Beheer-activiteitencentrum.
Selecteer de uitbreidingen die u wilt verwijderen.
Klik op Verwijderen.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een tikfout, een ontbrekende stap of een technische fout – laat het ons weten!

Geef hier uw feedback