Visualisatie-uitbreidingen uploaden en beheren

Uitbreidingen breiden de functionaliteit van het Qlik Cloud-analyseplatform uit en maken aangepaste visualisaties voor Qlik Sense-apps mogelijk. U kunt uitbreidingen uploaden en bewerken vanuit het Beheer-activiteitencentrum.

Externe uitbreidingen worden ondersteund in Qlik Cloud Government. Het gebruik van externe uitbreidingen dient echter mogelijk te worden gedefinieerd en goedgekeurd als deel van een Agency Authority to Operate afhankelijk van de eisen voor beveiliging en compliance die uw organisatie volgt.

Richtlijnen voor het maken en uploaden van uitbreidingen

U moet de volgende richtlijnen opvolgen bij het maken en uploaden van visualisatie-uitbreidingen naar Qlik Cloud:

Voor een visuele demo over het toevoegen en gebruiken van uitbreidingen, raadpleegt u Visualisatie-uitbreidingen van derden gebruiken in Qlik Cloud en Uitbreidingen en API-sleutels.

Beperkingen van ZIP-bestanden voor uitbreidingen

Maximum ZIP‑bestandsgrootte: 30 MB
Maximumbestandsgrootte van bestanden in ZIP: 30 MB
Maximumaantal bestanden in ZIP: 500
Maximum niet-gecomprimenteerde totale bestandsgrootte van bestanden in ZIP: 100 MB

Aanbevolen procedures

Maak uw codebestanden zo klein mogelijk.
Neem alleen de benodigde bestanden op. Neem in een zip-bestand alleen de vereiste bestanden op zodat uw uitbreiding correct werkt.
Controleer uitbreidingen en de codes voordat u deze uploadt. Zie Visualisatie-uitbreidingen (alleen in het Engels) voor meer informatie.

Verplichte basisbestanden voor een uitbreiding

Zorg ervoor dat het ZIP-bestand van uw uitbreiding de volgende essentiële bestanden bevat:

501.qext: metagegevensbestand voor de uitbreiding
.js: JavaScript-code voor de uitbreiding
.html: HTML-code voor het renderen van de uitbreiding
.css: Aangepaste CSS voor het vormgeven van de uitbreiding

Extern hosten van afbeeldingsbestanden

Upload geen afbeeldingsbestanden (bijvoorbeeld GIF, PNG, JPG) binnen het ZIP-bestand van de uitbreiding. U moet ze in plaats daarvan extern hosten op een persoonlijke applicatieserver, een S3-bucket of op een openbaar contentmanagementsysteem. Verwijs naar deze externe afbeeldingen in uw uitbreidingscode.

Verwijzen naar externe codebestanden en inhoud

U kunt verwijzen naar codebestanden en inhoud in uw primaire uitbreidingscode, maar dit vereist de implementatie van een inhoudbeveiligingsbeleid (CSP) in de tenant. Ga voor meer informatie naar Content Security Policy beheren (CSP).

Als uw uitbreiding verzoeken naar externe bronnen bevat, moeten de oorsprongen van deze bronnen in de acceptatielijst van de CSP zijn opgenomen, anders wordt weergave van de uitbreiding geblokkeerd.

Niet-ondersteunde functies

De volgende functies worden niet ondersteund:

Gebundelde uitbreidingen

Qlik Cloud ondersteunt geen ZIP-bestanden die ZIP-bestanden van andere uitbreidingen bevat.

QVF- en QVD-bestanden

Neem geen Qlik Sense QVF- of QVD-bestanden op in het ZIP-bestand van de uitbreiding, omdat deze bestanden niet geopend kunnen worden vanuit de uitbreidingsdienst. Verwijder deze bestanden voordat u de uitbreiding uploadt.

Als u een QVF- of QVD-bestand naar de Qlik Cloud-tenant wilt uploaden, volgt u een van de volgende methoden:

Upload een app op de pagina Maken in het Analyse-activiteitencentrum.
Upload een app met behulp van qlik-cli.
Upload een QVD op de pagina Maken in het Analyse-activiteitencentrum.
Upload een QVD met behulp van Qlik DataTransfer.

Niet-ondersteunde bestandsindelingen

Vanwege beveiligingsredenen kunnen uitbreidingen geen bestanden bevatten met niet-toegestane MIME-typen. MIME-typen (Multipurpose Internet Mail Uitbreidingen) zijn een standaard manier om de aard en indeling van een bestand aan te geven. Een upload mislukt bijvoorbeeld als uw uitbreiding een uitvoeringsbestand of een zip-bestand bevat.

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'

Alle bestanden in een uitbreiding moeten een bestandsnaam en een bestandsextensie hebben. Bestanden die niet aan deze voorwaarde voldoen, worden genegeerd. Voorbeelden van genegeerde bestanden zijn .gitignore en README.

Uitbreidingen toevoegen en beheren

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

In de tabel Uitbreidingen:

Naam verwijst naar de metagegevensnaam in het QEXT-bestand.
QEXT-versie geeft de metagegevensversie in het QEXT-bestand aan.
QEXT-bestandsnaam is de unieke identificatie en de naam van het definitiebestand van de uitbreiding.

U kunt uitbreidingen filteren op labels.

Een nieuwe uitbreiding 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.

Een uitbreiding bewerken

Doe het volgende:

Ga naar Uitbreidingen in het Beheer-activiteitencentrum.
Klik op van de uitbreiding die u wilt bewerken en selecteer Bewerken.

In het bewerkingsvenster ziet u opties voor het vervangen van de huidige uitbreiding en het toevoegen of verwijderen van tags.
Sla uw wijzigingen op.

Een uitbreiding 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 typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback