# Visualisatie-uitbreidingen uploaden en beheren

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

Opmerking over Qlik Cloud GovernmentExterne 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](https://qlik.dev/extend/). Voor een visuele demo, zie [Visualisatie-uitbreidingen van derden gebruiken in Qlik Cloud](https://share.vidyard.com/watch/kq8gkpB6jfLuVDWERgAgXE?) en [Uitbreidingen en API-sleutels](https://share.vidyard.com/watch/KzZMkq1RDQVcnWc8ShfYje?).

## 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 elk afzonderlijk bestand in het ZIP-bestand: 30 MB

* Maximumaantal bestanden in ZIP: 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](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm).

### 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 Analysesactiviteitencentrum.

* Upload een applicatie via `qlik-cli`.

* Upload een QVD vanaf de Maken pagina in het Analyses 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 van de uitbreiding

### Over migratiestatus

Qlik heeft extensies verplaatst van verouderde opslag naar de service die wordt gebruikt om extensies te beheren. Migratiestatus geeft de huidige migratiestatus van een uitbreiding aan.

Waarden voor migratiestatus:

* Gemigreerd: De uitbreiding is succesvol gemigreerd en is beschikbaar.

* Niet beschikbaar: De uitbreiding is niet meer beschikbaar en kan niet worden gemigreerd. Verwijder de uitbreiding uit het Beheer activiteitencentrum.

## Uitbreidingen toevoegen

Doe het volgende:

1. Ga naar Uitbreidingen in het Beheer-activiteitencentrum.

2. Klik op Toevoegen.

3. Klik op Bladeren om een uitbreidingsbestand te kiezen of versleep een bestand naar het daarvoor bedoelde vak.

4. Voeg desgewenst labels toe.

5. Klik op Publiceren.

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

## Uitbreidingen bewerken

Doe het volgende:

1. Ga naar BeheerUitbreidingen in het -activiteitencentrum.

2. Klik op the Meer icon van de uitbreiding die u wilt bewerken en selecteer Bewerken.

3. Gebruik het bewerkingspaneel om de uitbreiding te vervangen of tags bij te werken.

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

1. Ga naar BeheerUitbreidingen in het -activiteitencentrum.

2. Klik op the Meer icon bij de uitbreiding die u wilt downloaden en selecteer Downloaden.

3. Sla het ZIP-bestand op.

## Uitbreidingen verwijderen

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

Doe het volgende:

1. Ga naar BeheerUitbreidingen in het -activiteitencentrum.
2. Selecteer de uitbreidingen die u wilt verwijderen.
3. Klik op Verwijderen.