Ladda upp och hantera visualiseringskomplement
Komplement lägger till anpassade visualiseringsfunktioner till Qlik Cloud applikationer. Du kan ladda upp och hantera komplement i aktivitetscentret i Administration.
Använda komplement
Visualiseringskomplement i Qlik Cloud lägger till nya visuella komponenter utöver standardvisualiseringarna. Använd dem för att anpassa hur du presenterar och utforskar data.
Se Qlik Developer: Utöka Qlik för mer information. För en visuell demo, se Använda visualiseringskomplement från tredje part i Qlik Cloud och Komplement och API-nycklar.
Roller som krävs
För att ladda upp och hantera komplement måste du ha en av följande roller:
-
Huvudadministratör
-
Analytics-administratör
-
Anpassad roll med behörigheten Hantera komplement inställd på Tillåten
Filkrav och begränsningar
Följ dessa regler för att säkerställa att ditt komplement laddas upp och fungerar korrekt.
Filbegränsningar
ZIP-filer för komplement har följande begränsningar:
-
Maximal storlek för ZIP-filer: 30 MB
-
Maximal storlek för en enskild fil i ZIP-arkivet: 30 MB
-
Maximalt antal filer i en ZIP: 500
-
Maximal total okomprimerad storlek: 100 MB
Obligatoriska basfiler för ett komplement
Kontrollera att zip-filen för ditt komplement innehåller följande filer:
-
.qext: Metadatafil
-
.js: JavaScript-kod
-
.html: HTML-renderingskod
-
.css: Anpassad stil
Filnamnsregler
Varje fil i komplementet måste ha ett filnamn och ett filnamnstillägg. Filer som inte uppfyller kraven ignoreras. Exempel på filer som ignoreras: .gitignore och README.
Metodtips
-
Gör dina kodfiler så små som möjligt.
-
Inkludera endast de filer som ditt komplement behöver för att köras.
-
Granska komplementet och dess kod innan du laddar upp det.
Externa resurser och CSP
Lagra bildfiler externt
Inkludera inte bildfiler (som GIF, PNG, JPG) i komplementets ZIP-fil. Lagra i stället bilder externt (till exempel på en applikationsserver, en S3-bucket eller ett offentligt innehållshanteringssystem) och referera till dem från din komplementkod.
Referera till extern kod och externt innehåll
För att referera till extern kod eller externt innehåll i ditt komplement, konfigurera en klientorganisations Content Security Policy (CSP) och tillåtlistra de externa ursprung som ditt komplement behöver åtkomst till.
Om ett ursprung inte är tillåtlistrat kommer ditt komplement inte att renderas.
Mer information finns i Hantera säkerhetspolicy för innehåll (Content Security Policy CSP).
Filformat som inte stöds
Av säkerhetsskäl får komplement inte innehålla filer med otillåtna MIME-typer. MIME-typer (Multipurpose Internet Mail Extensions) anger en fils format. Om ditt komplement innehåller en otillåten MIME-typ (till exempel en körbar fil eller en ZIP-fil) misslyckas uppladdningen.
Följande MIME-typer är ej tillåtna:
- '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'
Funktioner som inte stöds
Följande funktioner stöds inte:
-
Buntade komplement: ZIP-filer som innehåller andra ZIP-filer med komplement stöds inte.
-
QVF- och QVD-filer: Dessa filer är inte tillgängliga från komplementtjänsten.
Gör något av följande om du vill ladda upp QVF- eller QVD-filer:
-
Ladda upp en applikation från sidan Skapa i Analyseraktivitetscentret.
-
Ladda upp en applikation med qlik-cli.
-
Ladda upp en QVD från sidan Skapa i Analyser aktivitetscentret.
-
Ladda upp en QVD med hjälp av Qlik DataTransfer.
Hantera komplement
Komplement hanteras på sidan Komplement i aktivitetscentret för Administration.
Komplementtabellinformation
-
Namn: Metadatanamn i QEXT-filen
-
QEXT-version: Metadataversion
-
QEXT-filnamn: Unik identifierare för definitionsfilen för komplementet
-
Status: Migreringsstatus (tillfällig)
Om migreringsstatus
Qlik förbättrar hur plattformen hanterar komplement. Under denna övergång flyttas befintliga komplement till en ny tjänst. Kolumnen för migreringsstatus är tillfällig och visas endast medan detta arbete pågår.
Från och med 2025-11-17 använder alla komplement du laddar upp eller kommer åt den nya tjänsten automatiskt. Om ditt komplement används regelbundet krävs ingen åtgärd.
De flesta komplement migreras automatiskt när de används. Komplement som du inte har använt nyligen kan behöva köas manuellt för att inkluderas i en schemalagd migreringskörning. För att skydda kundägt innehåll migrerar Qlik inte komplement om de inte används eller om du bekräftar migreringen. Om du vill behålla ett oanvänt komplement (status Inte migrerat) tillgängligt kan du migrera det manuellt.
Värden för migreringsstatus:
-
Inte migrerat: Komplementet har inte migrerats.
-
Köat för migrering: Komplementet har köats och kommer att migreras under nästa schemalagda migreringskörning.
-
Migrering pågår: Komplementet migreras för närvarande.
-
Migrerat: Komplementet har migrerats.
Migrering gäller även teman. För mer information, se Lägga till och hantera teman.
Lägga till komplement
Gör följande:
- Gå till Komplement i aktivitetscentret för Administration.
-
Klicka på Lägg till.
-
Välj en komplementfil genom att klicka på Bläddra, eller släpp en fil i det avsedda området.
-
Lägg till taggar om du vill.
-
Klicka på Publicera.
Redigera komplement
Gör följande:
- Gå till Komplement i aktivitetscentret för Administration.
-
Klicka
och välj Redigera för det komplement som du vill redigera.
-
Använd redigeringspanelen för att ersätta komplementet eller uppdatera taggar.
-
Spara dina ändringar.
Hämtar komplement
Använd detta för att säkerhetskopiera ett komplement innan du redigerar det eller för att flytta det till en annan klientorganisation.
Gör följande:
- Gå till Komplement i aktivitetscentret för Administration.
-
På det komplement du vill hämta klickar du på
och väljer Hämta.
-
Spara ZIP-filen.
Migrerar komplement
Använd följande steg för att migrera komplement med statusen Inte migrerad.
Gör följande:
- Gå till Komplement i aktivitetscentret för Administration.
-
På komplementet du vill migrera, klicka på
och välj Migrera.
Statusen uppdateras allteftersom migreringen fortskrider: Köad för migrering, Migrering pågår och slutligen Migrerad.
Tar bort komplement
Borttagning av komplement kan påverka alla resurser, vilket påverkar alla användare inom klientorganisationen.
Gör följande:
- Gå till Komplement i aktivitetscentret för Administration.
- Välj det komplement du vill ta bort.
- Klicka på Radera.