Gestion des extensions
Les extensions dans Qlik Cloud étendent la fonctionnalité de la plateforme analytique, 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.
Si des extensions contiennent des demandes de ressources vers des ressources externes, leurs origines doivent figurer dans une liste verte dans Content Security Policy, sinon l'extension sera bloquée.
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.
Présentation des extensions
Sur la page Extensions du centre d'activités Administration figurent les propriétés suivantes.
Propriété | Description |
---|---|
Nom |
Il s'agit du nom de métadonnées contenu dans le fichier QEXT, qui est différent du nom de fichier QEXT. |
Description |
Brève description de l'extension. |
Balises |
Balises permettant le filtrage. |
Auteur |
Créateur de l'extension. |
Nom de fichier QEXT |
Identificateur qui doit être unique. Nom de fichier du fichier de définition de l'extension. Différent du nom de l'extension. |
Version de QEXT |
Version des métadonnées contenue dans le fichier QEXT. |
Date de publication |
Date de publication. |
Dans le tableau, triez les éléments à l'aide des flèches situées dans l'en-tête des propriétés. Filtrez à l'aide du menu déroulant Balises ou en sélectionnant les balises du tableau.
Extensions avec ressources externes
Si des extensions contiennent des demandes de ressources vers des ressources externes, leurs origines doivent figurer dans une liste verte dans Content Security Policy, sinon l'extension sera bloquée.
Voir aussi :Gestion de Content Security Policy
Formats de fichier non supportés
Pour des raisons de sécurité, il n'est pas permis aux extensions de contenir des fichiers associés à des types MIME non autorisés. Un 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'
Recommandations pour la création et le chargement d'extensions
Qlik Cloud et Qlik Sense Enterprise Client-Managed utilisent des services d'extension différents. C'est pourquoi ils ont des fonctionnalités différentes. Lors de la création et du chargement d'extensions de visualisation dans Qlik Cloud, suivez les recommandations suivantes :
-
Les fichiers ZIP contenant des extensions présentent les limites suivantes :
-
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
-
-
Réduisez les fichiers de code.
-
Incluez dans un fichier ZIP d'extension uniquement les fichiers nécessaires pour que votre extension fonctionne correctement. Le tableau indique les fichiers de base nécessaires pour une extension de visualisation.
Extension de fichier Description .qext Fichier de métadonnées de l'extension .js Code JavaScript de l'extension .html
Code HTML pour afficher l'extension .css CSS personnalisé pour définir le style de l'extension
-
Ne chargez pas de fichiers image. Les fichiers GIF, PNG, JPG et les autres fichiers image doivent être hébergés en externe, soit sur un serveur d'applications personnel, un compartiment S3, soit sur un système de gestion de contenu public. Ils peuvent être référencés depuis le code d'extension.
Note InformationsIl est possible de référencer certaines contenus et fichiers de code depuis le code d'extension principal. Le référencement de contenu externe depuis une extension requiert l'implémentation d'une stratégie de sécurité du contenu sur le client. Consultez Gestion de Content Security Policy pour plus d'informations. -
Le service d'extension Qlik Cloud ne prend pas en charge les extensions regroupées (un fichier ZIP contenant d'autres fichiers ZIP d'extension).
-
Ne chargez pas d'extensions qui incluent des fichiers Qlik Sense QVF ou QVD, car ces fichiers 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, effectuez l'une des opérations 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.
-
Ajout d'une nouvelle extension
Procédez comme suit :
- Dans le centre d'activités Administration, accédez à la section Extensions et cliquez sur Ajouter dans le coin supérieur droit.
-
Dans la fenêtre contextuelle, cliquez sur Parcourir pour sélectionner un fichier d'extension, ou déposer un fichier dans la zone désignée.
Note InformationsVous ne pouvez pas télécharger une extension avec le même nom de fichier QEXT qu'une autre. -
Ajoutez éventuellement des balises.
-
Cliquez sur Publier.
-
Si l'extension que vous venez de charger contient des ressources externes, vous devez ajouter les origines dans la Content Security Policy à la liste verte. Voir Gestion de Content Security Policy.
Modification d'une extension
Vous pouvez Modifier une extension à la fois.
Procédez comme suit :
- Dans le centre d'activités Administration, accédez à la section Extensions et cochez la case de l'extension à modifier.
-
Dans l'angle supérieur droit, cliquez sur Modifier.
Le panneau d'édition s'affiche avec les options pour remplacer l'extension existante ou ajouter ou supprimer des balises.
-
Apportez vos modifications et enregistrez.
Suppression d'une extension
Procédez comme suit :
- Dans le centre d'activités Administration, accédez à la section Extensions et cochez les cases des extensions à supprimer.
- Dans l'angle supérieur droit, cliquez sur Supprimer.