Chargement et gestion des extensions de visualisation
Les extensions étendent la fonctionnalité de la plateforme analytique Qlik Cloud en permettant de créer des visualisations personnalisées pour les applications Qlik Sense. Vous pouvez charger et modifier les extensions depuis le centre d'activités Administration.
Recommandations pour la création et le chargement d'extensions
Lors de la création et du chargement d'extensions de visualisation dans Qlik Cloud, suivez ces recommandations.
Pour une démonstration visuelle sur l'ajout et l'utilisation d'extensions, voir Utilisation d'extensions de visualisation tierces dans Qlik Cloud et Extensions et clés API.
Limites des fichiers ZIP des extensions
-
Taille de fichier ZIP maximale : 30 Mo
-
Taille de fichier maximale des fichiers dans le ZIP : 30 Mo
-
Nombre maximal de fichiers dans le ZIP : 500
-
Taille de fichier totale décompressée maximale des fichiers dans le ZIP : 100 Mo
Bonnes pratiques
-
Réduisez les fichiers de code.
-
Incluez uniquement les fichiers nécessaires. Assurez-vous que le fichier ZIP contient uniquement les fichiers nécessaires pour que votre extension fonctionne correctement.
-
Vérifiez les extensions et leur code avant d'effectuer le chargement. Pour plus d'informations, consultez Extensions de visualisation (uniquement en anglais).
Fichiers de base obligatoires d'une extension
Assurez-vous que votre fichier ZIP d'extension inclut les fichiers essentiels suivants :
-
.qext : fichier de métadonnées de l'extension
-
.js : code JavaScript de l'extension
-
.html : code HTML pour afficher l'extension
-
.css : code CSS personnalisé pour définir le style de l'extension
Hébergement externe des fichiers image
Ne chargez pas de fichiers image (par exemple, GIF, PNG, JPG) dans le fichier ZIP d'extension. Au lieu de cela, hébergez-les en externe sur un serveur d'applications personnel, dans un compartiment S3 ou sur un système de gestion de contenu public. Faites référence à ces images externes dans votre code d'extension.
Référencement de fichiers de code et de contenu externes
Vous pouvez référencer des fichiers de code et du contenu dans votre code d'extension principal, mais cela nécessite la mise en œuvre d'une Stratégie de sécurité de contenu (Content Security Policy ou CSP) dans le client. Pour plus d'informations, consultez Gestion de Content Security Policy (CSP).
Si votre extension lance des requêtes auprès de ressources externes, les origines de ces ressources doivent figurer dans une liste verte de la CSP, sinon l'affichage de l'extension sera bloqué.
Fonctionnalités non supportées
Les fonctions suivantes ne sont pas supportées :
Extensions regroupées
Qlik Cloud ne supporte pas les fichiers ZIP contenant d'autres fichiers ZIP d'extension.
Fichiers QVD et QVF
N'incluez pas de fichiers QVF ou QVD Qlik Sense dans le fichier ZIP d'extension, car ils ne sont pas accessibles depuis le service d'extension. Supprimez ces fichiers avant de charger l'extension.
Pour charger un fichier QVF ou QVD dans le client Qlik Cloud, utilisez l'une des méthodes suivantes :
-
Chargez une application sur la page Créer du centre d'activités Analyses.
-
Chargez une application via qlik-cli.
-
Chargez un QVD sur la page Créer du centre d'activités Analyses.
-
Chargez un fichier QVD via Qlik DataTransfer.
Formats de fichier non supportés
Pour des raisons de sécurité, les extensions ne peuvent pas contenir de fichiers associés à des types MIME non autorisés. Les types MIME (Multipurpose Internet Mail Extensions - Extensions multifonctions du courrier Internet) sont un moyen standard d'indiquer la nature et le format d'un fichier. Le chargement échouera si votre extension contient, par exemple, un fichier exécutable ou un fichier ZIP.
Les types MIME suivants ne sont pas autorisés :
- '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'
Tous les fichiers dans une extension doivent avoir un nom de fichier et une extension de fichier. Les fichiers non conformes seront ignorés. Parmi les exemples de fichiers ignorés figurent les fichiers .gitignore et README.
Ajout et gestion d'extensions
Les extensions sont gérées sur la page Extensions du centre d'activités Administration.
Dans le tableau Extensions :
-
Nom fait référence au nom des métadonnées dans le fichier QEXT.
-
Version de QEXT indique la version des métadonnées dans le fichier QEXT.
-
Nom de fichier QEXT est l'identificateur unique et le nom du fichier de définition de l'extension.
Vous pouvez filtrer les extensions par balises.
Ajout d'une nouvelle extension
Procédez comme suit :
- Dans le centre d'activités Administration, accédez à Extensions.
-
Cliquez sur Ajouter.
-
Cliquez sur Parcourir pour sélectionner un fichier d'extension, ou déposez un fichier dans la zone désignée.
-
Ajoutez éventuellement des balises.
-
Cliquez sur Publier.
Modification d'une extension
Procédez comme suit :
- Dans le centre d'activités Administration, accédez à Extensions.
-
Sur l'extension à modifier, cliquez sur et sélectionnez Modifier.
Le panneau d'édition s'affiche avec les options pour remplacer l'extension existante ou ajouter ou supprimer des balises.
-
Sauvegardez vos modifications.
Suppression d'une extension
La suppression d'extensions peut avoir un impact sur toutes les ressources, affectant ainsi tous les utilisateurs du client.
Procédez comme suit :
- Dans le centre d'activités Administration, accédez à Extensions.
- Sélectionnez les extensions à supprimer.
- Cliquez sur Supprimer.