Caricamento e gestione delle estensioni della visualizzazione

Le estensioni aggiungono funzionalità di visualizzazione personalizzate alle applicazioni Qlik Cloud. È possibile caricare e gestire le estensioni nel centro attività Amministrazione.

Le estensioni di terze parti sono supportate in Qlik Cloud Government. Il loro utilizzo potrebbe richiedere l'approvazione nell'ambito di un'autorizzazione operativa dell'agenzia, a seconda dei requisiti di sicurezza e conformità dell'organizzazione.

Utilizzo delle estensioni

Le estensioni di visualizzazione in Qlik Cloud aggiungono nuovi componenti visivi oltre le visualizzazioni standard. Usali per personalizzare il modo in cui presenti ed esplori i dati.

Per ulteriori informazioni, vedere Qlik Developer: Estensione di Qlik. Per una demo visiva, vedere Utilizzo delle estensioni di visualizzazione di terze parti in Qlik Cloud ed Estensioni e chiavi API.

Ruoli richiesti

Per caricare e gestire le estensioni, è necessario disporre di uno dei seguenti ruoli:

Amministratore di tenant
Amministratore di analisi
Ruolo personalizzato con l'autorizzazione Gestisci estensioni impostata su Consentito

Requisiti e limiti dei file

Seguire queste regole per assicurarsi che l'estensione venga caricata e funzioni correttamente.

Limiti dei file

I file ZIP delle estensioni hanno questi limiti:

Dimensioni massime per i file ZIP: 30 MB
Dimensione massima per un singolo file nello ZIP: 30 MB
Numero massimo di file nello ZIP: 500
Dimensione totale massima non compressa: 100 MB

File di base necessari per un'estensione

Assicurarsi che il file ZIP dell'estensione includa i seguenti file:

.qext: File di metadati
.js: Codice JavaScript
.html: Codice di rendering HTML
.css: Stile personalizzato

Regole di denominazione dei file

Ogni file nell'estensione deve avere un nome file e un'estensione file. I file non conformi vengono ignorati. Gli esempi di file ignorati includono .gitignore e README.

Procedure consigliate

Minimizzare i file di codice.
Includere solo i file necessari all'estensione per l'esecuzione.
Esaminare l'estensione e il relativo codice prima di caricarla.

Risorse esterne e CSP

Ospitare i file immagine esternamente

Non includere file immagine (ad esempio GIF, PNG, JPG) nel file ZIP dell'estensione. Ospitare invece le immagini esternamente (ad esempio, su un server di applicazioni, un bucket S3 o un sistema di gestione dei contenuti pubblico) e farvi riferimento dal codice dell'estensione.

Fare riferimento a codice e contenuti esterni

Per fare riferimento a codice o contenuti esterni nell'estensione, configurare una Content Security Policy del tenant (CSP) e inserire nella allowlist le origini esterne a cui l'estensione deve accedere.

Se un'origine non è inclusa nella allowlist, l'estensione non verrà visualizzata.

Per ulteriori informazioni, vedere Gestione dei criteri di sicurezza dei contenuti (CSP).

Formati file non supportati

Per motivi di sicurezza, le estensioni non possono includere file con tipi di MIME non consentiti. I tipi MIME (Multipurpose Internet Mail Extensions) indicano il formato di un file. Se l'estensione contiene un tipo MIME non consentito (ad esempio, un file eseguibile o un file ZIP), il caricamento non riesce.

I seguenti tipi di MIME non sono consentiti:

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

Funzionalità non supportate

Le seguenti funzionalità non sono supportate:

Estensioni in bundle: i file ZIP contenenti altri file ZIP di estensione non sono supportati.
File QVF e QVD: questi file non sono accessibili dal servizio di estensione.

Per caricare file QVF o QVD, utilizzare uno dei seguenti metodi:

Caricare un'applicazione dalla pagina Crea nel Analisicentro attività.
Caricare un'applicazione utilizzando qlik-cli.
Caricare un QVD dalla pagina Crea nel centro attività Analisi.
Caricare un QVD utilizzando Qlik DataTransfer.

Gestione delle estensioni

Le estensioni sono gestite nella pagina Estensioni del centro attività Amministrazione.

Informazioni sulla tabella delle estensioni

Nome: Nome dei metadati nel file QEXT
Versione QEXT: Versione dei metadati
Nome file QEXT: Identificatore univoco per il file di definizione dell'estensione
Stato: Stato della migrazione (temporaneo)

Informazioni sullo stato della migrazione

Qlik sta migliorando il modo in cui la piattaforma gestisce le estensioni. Durante questa transizione, le estensioni esistenti vengono spostate in un nuovo servizio. La colonna dello stato della migrazione è temporanea e appare solo mentre questo lavoro è in corso.

A partire dal 17-11-2025, qualsiasi estensione caricata o a cui si accede utilizzerà automaticamente il nuovo servizio. Se l'estensione è in uso regolare, non è richiesta alcuna azione.

La maggior parte delle estensioni migra automaticamente quando vengono utilizzate. Le estensioni che non sono state utilizzate di recente potrebbero dover essere messe in coda manualmente per essere incluse in un'esecuzione di migrazione pianificata. Per proteggere i contenuti di proprietà del cliente, Qlik non migra le estensioni a meno che non vi si acceda o non si confermi la migrazione. Se si desidera mantenere disponibile un'estensione non utilizzata (stato Non migrata), è possibile migrarla manualmente.

Valori dello stato di migrazione:

Non migrata: L'estensione non è stata migrata.
In coda per la migrazione: L'estensione è stata messa in coda e verrà migrata durante la prossima esecuzione di migrazione pianificata.
Migrazione in corso: L'estensione è attualmente in fase di migrazione.
Migrata: L'estensione è stata migrata correttamente.

La migrazione si applica anche ai temi. Per i dettagli, vedere Caricamento e gestione di temi.