Hantera komplement

Komplement utökar funktionaliteterna i Qlik Clouds analysplattform genom att möjliggöra anpassade visualiseringar för Qlik Sense-appar. Du kan ladda upp och redigera komplement från aktivitetscentret i Administration.

Komplement från tredje part stöds i Qlik Cloud Government. Användning av komplement från tredje part kan dock behöva definieras och godkännas som en del av en Agency Authority to Operate, beroende på vilka säkerhets- och efterlevnadskrav din organisation ska uppfylla.

Rekommendationer för att skapa och ladda upp komplement

Följ dessa rekommendationer när du skapar och laddar upp visualiseringskomplement till Qlik Cloud:

För en visuell demo om att lägga till och använda komplement finns Använda tredje parts visualiseringskomplement i Qlik Cloud och Komplement och API-nycklar.

Zip-filgränser för komplement

Maximal storlek för ZIP-filer: 30 MB
Maximal filstorlek för filer i en ZIP: 30 MB
Maximalt antal filer i en ZIP: 500
Maximal okomprimerad total filstorlek för filer i en ZIP: 100 MB

Metodtips

Gör dina kodfiler så små som möjligt.
Inkludera endast nödvändiga filer. Kontrollera att zip-filen endast innehåller de filer som krävs för att komplementet ska fungera.
Granska komplement med tillhörande kod innan du laddar upp dem. Mer information finns i Visualiseringskomplement (endast på engelska).

Obligatoriska basfiler för ett komplement

Kontrollera att zip-filen för komplementet inkluderar följande viktiga filer:

.qext: metadatafil för komplementet
.js: JavaScript-kod för komplementet
.html: html-kod för att rendera komplementet
.css: anpassade CSS-filer för formatering av komplementet

Externt värdskap för bildfiler

Ladda inte upp bildfiler (exempel: GIF, PNG, JPG) inom komplement-zip-filen. Lagras dem istället externt på en personlig programserver, i en S3-bucket eller i ett offentligt system för hantering av innehåll. Referera till dessa externa bilder i din komplement-kod.

Hänvisning till externa filer och externt innehåll

Du kan hänvisa till kodfiler och innehåll i din primära komplementkod, men det kräver att du implementerar en säkerhetspolicy för innehåll (CSP) på klientorganisationen. Mer information finns i Hantera Content Security Policy.

Om komplement skickar förfrågningar till externa resurser måste ursprungen finnas med i godkänd-listan i CSP annars tillåts inte att komplementet renderas.

Funktioner som inte stöds

Följande funktioner stöds inte:

Komplementpaket

Qlik Cloud stöder inte zip-filer som innehåller andra zip-filer med komplement.

QVF- och QVD-filer

Inkludera inte QVF- eller QVD-filer från Qlik Sense i zip-filer för komplement eftersom de inte är nåbara från komplementtjänsten. Ta bort dessa filer innan du laddar upp komplementet.

Gör något av följande om du vill ladda upp en QVF-fil eller QVD-fil till Qlik Cloud-klientorganisationen:

Ladda upp en app på sidan Skapa i aktivitetscentret för Analyser.
Ladda upp en app med qlik-cli.
Ladda upp en QVD på sidan Skapa i aktivitetscentret för Analyser.
Ladda upp en QVD-fil med hjälp av Qlik DataTransfer.

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) är ett standardiserat sätt att ange typ och format för en fil. Uppladdningen kommer att misslyckas om ditt komplement till exempel innehåller en exekverbar fil eller en zip-fil.

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'

Alla filer i ett komplement måste ha ett filnamn och ett filnamnstillägg. Filer som inte uppfyller dessa krav ignoreras. Exempel på filer som ignoreras: .gitignore och README.

Lägga till och hantera komplement

Komplement hanteras på sidan Komplement i aktivitetscentret för Administration.

I tabellen Komplement:

Namn hänvisar till metadatans namn i QEXT-filen.
QEXT-version indikerar versionen av metadata i QEXT-filen.
QEXT-filnamnet är den unika identifieraren och namnet på definitionsfilen för komplementet.

Du kan filtrera komplement efter taggar.

Lägga till ett nytt 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.

Du kan inte ladda upp ett komplement med samma QEXT-filnamn som ett befintligt komplement.

Redigera ett 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.

I redigeringspanelen visas alternativ för att ersätta det nuvarande komplementet, samt för att lägga till och ta bort taggar.
Spara dina ändringar.

Ta bort ett 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.

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!

Lämna din feedback här