Caricamento e gestione delle estensioni della visualizzazione
Le estensioni estendono la funzionalità della piattaforma analitica di Qlik Cloud, consentendo visualizzazioni personalizzate per le app Qlik Sense. È possibile caricare e modificare le estensioni dal centro attività Amministrazione.
Linee guida per la creazione e il caricamento di estensioni
Seguire queste linee guida al momento di creare e caricare estensioni di visualizzazione in Qlik Cloud:
Per una demo visiva sull'aggiunta e l'utilizzo delle estensioni, vedere Utilizzo delle estensioni di visualizzazione di terze parti in Qlik Cloud ed Estensioni e chiavi API.
Limiti dei file ZIP per le estensioni
-
Dimensioni massime per i file ZIP: 30 MB
-
Dimensioni massime per i file in formato ZIP: 30 MB
-
Numero massimo di file in formato ZIP: 500
-
Dimensioni massime totali per i file in formato ZIP non compressi: 100 MB
Procedure consigliate
-
Minimizzare i file di codice.
-
Includere solo i file necessari. Assicurarsi che il file ZIP contenga solo i file richiesti affinché l'estensione funzioni correttamente.
-
È consigliabile verificare le estensioni e i relativi codici prima del caricamento. Per ulteriori informazioni, vedere Estensioni della visualizzazione (solo in lingua inglese).
File di base necessari per un'estensione
Assicurarsi che il file ZIP dell'estensione includa i seguenti file essenziali:
-
.qext: file metadati di estensione
-
.js: codice JavaScript per l'estensione
-
.html: codice HTML per il rendering dell'estensione
-
.css: CSS personalizzato per modificare lo stile dell'estensione
Hosting esterno di file immagine
Non caricare file immagine (ad esempio, GIF, PNG, JPG) nel file con estensione ZIP. Al contrario, ospitarli esternamente su un server di applicazione personale, un bucket S3 o un sistema di gestione del contenuto pubblico. Fare riferimento a queste immagini esterne nel codice dell'estensione.
Fare riferimento a file e contenuti di codice esterno
È possibile fare riferimento ai file del codice e ai contenuti nel codice di estensione primario, ma ciò richiede l'implementazione di Criteri di sicurezza dei contenuti (CSP) sul tenant. Per ulteriori informazioni, vedere Gestione di Content Security Policy (CSP).
Se le estensioni effettuano richieste a risorse esterne, le origini di queste risorse devono essere aggiunte alla allowlist all'interno nel CSP, in caso contrario il rendering dell'estensione verrà bloccato.
Funzionalità non supportate
Le seguenti funzionalità non sono supportate:
Estensioni in bundle
Qlik Cloud non supporta i file ZIP contenenti altre estensioni file ZIP.
File QVF e QVD
Non includere file Qlik Sense QVF o QVD nel file ZIP dell'estensione, perché tali file non sono accessibili dal servizio di estensione. Rimuovere tali file prima di caricare l'estensione.
Per caricare un file QVF o QVD sul tenant Qlik Cloud, utilizzare uno dei seguenti metodi:
-
Caricare un'app nella pagina Crea del centro attività Analisi.
-
Caricare un'app mediante qlik-cli.
-
Caricare un file QVD nella pagina Crea del centro attività Analisi.
-
Caricare un QVD usando Qlik DataTransfer.
Formati file non supportati
Per motivi di sicurezza, le estensioni non possono contenere file con tipi di MIME non consentiti. I tipi di file MIME (Multipurpose Internet Mail Extensions) sono un modo standard per indicare la natura e il formato di un file. Il caricamento non verrà completato se l'estensione contiene, ad esempio, un file eseguibile o un file ZIP.
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'
Tutti i file in un'estensione devono avere sia un nome file che un'estensione file. I file non conformi a questo requisito verranno ignorati. Gli esempi di file ignorati includono .gitignore e README.
Aggiunta e gestione delle estensioni
Le estensioni sono gestite nella pagina Estensioni del centro attività Amministrazione.
Nella tabella Estensioni:
-
Nome si riferisce al nome dei metadati nel file QEXT.
-
Versione QEXT indica la versione dei metadati nel file QEXT.
-
Nome file QEXT è l'identificatore univoco e il nome del file di definizione dell'estensione.
È possibile filtrare le estensioni mediante tag.
Aggiunta di una nuova estensione
Procedere come indicato di seguito:
- Nel centro attività Amministrazione, andare a Estensioni.
-
Fare clic su Aggiungi.
-
Fare clic su Sfoglia per selezionare un file di estensione, oppure rilasciare un file nell'area indicata.
-
Facoltativamente è possibile aggiungere tag.
-
Fare clic su Pubblica.
Modifica di un'estensione
Procedere come indicato di seguito:
- Nel centro attività Amministrazione, andare a Estensioni.
-
Sulle estensioni che si desidera modificare, fare clic su
e selezionare Modifica.Il pannello di modifica è visualizzato con le opzioni per sostituire l'estensione esistente e aggiungere o rimuovere tag.
-
Salvare le modifiche.
Eliminazione di un'estensione
L'eliminazione delle estensioni può avere un impatto su tutte le risorse, con ripercussioni su tutti gli utenti nel tenant.
Procedere come indicato di seguito:
- Nel centro attività Amministrazione, andare a Estensioni.
- Selezionare le estensioni che si desidera eliminare.
- Fare clic su Elimina.