Chargement et gestion des extensions de visualisation

Les extensions ajoutent des fonctionnalités de visualisation personnalisées aux applications Qlik Cloud. Vous pouvez charger et gérer les extensions dans le centre d'activités Administration.

Les extensions tierces sont supportées dans Qlik Cloud Government. Leur utilisation peut nécessiter une approbation dans le cadre d'une Agency Authority to Operate (AtO - autorisation d'exploitation délivrée par une agence), suivant les exigences de sécurité et de conformité de votre organisation.

Utilisation des extensions

Les extensions de visualisation dans Qlik Cloud ajoutent de nouveaux composants visuels au-delà des visualisations standards. Utilisez-les pour personnaliser la façon dont vous présentez et explorez les données.

Pour plus d'informations, consultez Développeur Qlik : extension de Qlik. Pour une démonstration visuelle, consultez Utilisation d'extensions de visualisation tierces dans Qlik Cloud et Extensions et clés API.

Rôle requis

Pour charger et gérer les extensions, vous devez disposer de l'un des rôles suivants :

Administrateur de clients
Administrateur d'analyses
Rôle personnalisé avec l'autorisation Gérer les extensions définie sur Accordé

Exigences en matière de fichiers et limites

Suivez ces règles pour vous assurer que votre extension est chargée et qu'elle fonctionne correctement.

Limites en termes de fichiers

Les fichiers ZIP d'extension présentent les limites suivantes :

Taille de fichier ZIP maximale : 30 Mo
Taille maximale de tout fichier unique dans le ZIP : 30 Mo
Nombre maximal de fichiers dans le ZIP : 500
Taille totale maximale hors compression : 100 Mo

Fichiers de base obligatoires d'une extension

Assurez-vous que votre fichier ZIP d'extension inclut les fichiers suivants :

.qext : fichier de métadonnées
.js : code JavaScript
.html : code de rendu HTML
.css : style personnalisé

Règles de nommage des fichiers

Tous les fichiers d'une extension doivent avoir un nom et une extension. Les fichiers non conformes sont ignorés. Parmi les exemples de fichiers ignorés figurent les fichiers .gitignore et README.

Bonnes pratiques

Réduisez les fichiers de code.
N'incluez que les fichiers dont votre extension a besoin pour fonctionner.
Examinez l'extension et son code avant de la charger.

Ressources externes et CSP

Hébergement des fichiers image en externe

N'incluez pas de fichiers image (tels que GIF, PNG, JPG) dans le fichier ZIP d'extension. Au lieu de cela, hébergez les images en externe (par exemple, sur un serveur d'applications, dans un compartiment S3 ou sur un système de gestion de contenu public) et référencez-les à partir du code de votre extension.

Référencement du code et du contenu externes

Pour référencer du code ou du contenu externe dans votre extension, configurez une Stratégie de sécurité du contenu (Content Security Policy ou CSP) pour le client et ajoutez à la liste verte les origines externes auxquelles votre extension doit accéder.

Si une origine n'est pas ajoutée à la liste verte, votre extension ne s'affichera pas.

Pour plus d'informations, consultez Gestion de la Stratégie de sécurité du contenu (Content Security Policy ou CSP).

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) indiquent un format de fichier. Si votre extension contient un type MIME non autorisé (par exemple, un fichier exécutable ou un fichier ZIP), le chargement échouera.

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'

Fonctionnalités non supportées

Les fonctions suivantes ne sont pas supportées :

Extensions regroupées : les fichiers ZIP contenant d'autres fichiers ZIP d'extension ne sont pas supportés.
Fichiers QVF et QVD : ces fichiers ne sont pas accessibles depuis le service d'extension.

Pour charger des fichiers QVF ou QVD, utilisez l'une des méthodes suivantes :

Chargez une application depuis la page Créer du centre d'activités Analytiques.
Chargez une application via qlik-cli.
Chargez un QVD depuis la page Créer du centre d'activités Analytiques.
Chargez un fichier QVD via Qlik DataTransfer.

Gestion des extensions

Les extensions sont gérées sur la page Extensions du centre d'activités Administration.

Informations sur la table d'extensions

Nom : nom des métadonnées du fichier QEXT
Version QEXT : version des métadonnées
Nom de fichier QEXT : identificateur unique du fichier de définition de l'extension
Statut : statut de migration (temporaire)

À propos du statut de migration

Qlik améliore la façon dont la plateforme gère les extensions. Pendant cette transition, les extensions existantes sont déplacées vers un nouveau service. La colonne de statut de migration est temporaire et n'apparaît que pendant que ce processus est en cours.

Depuis le 17 novembre 2025, toute extension que vous chargez ou à laquelle vous accédez utilise automatiquement le nouveau service. Si votre extension est régulièrement utilisée, aucune action n'est requise.

La plupart des extensions migrent automatiquement lorsqu'elles sont utilisées. Les extensions que vous n'avez pas utilisées récemment devront peut-être être mises en file d'attente manuellement pour être incluses dans une exécution de migration planifiée. Pour protéger le contenu appartenant aux clients, Qlik ne migre pas d'extensions, à moins d'y accéder ou de confirmer la migration. Si vous souhaitez conserver une extension inutilisée (statut Non migrée) disponible, vous pouvez la migrer manuellement.

Valeurs du statut de migration :

Non migrée : l'extension n'a pas été migrée.
En file d'attente pour la migration : l'extension a été mise en file d'attente et sera migrée lors de la prochaine exécution de migration planifiée.
Migration en cours : l'extension est en cours de migration.
Migrée : l'extension a été correctement migrée.

La migration s'applique également aux thèmes. Pour plus de détails, consultez Chargement et gestion de thèmes.

Ajout d'extensions

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.

Vous ne pouvez pas télécharger une extension avec le même nom de fichier QEXT qu'une autre.

Modification d'extensions

Procédez comme suit :

Dans le centre d'activités Administration, accédez à Extensions.
Sur l'extension à modifier, cliquez sur et sélectionnez Modifier.
Utilisez le panneau d'édition pour remplacer l'extension ou mettre les balises à jour.
Enregistrez vos modifications.

Téléchargement d'extensions

Utilisez cette option pour sauvegarder une extension avant de la modifier ou pour la déplacer vers un autre client.

Procédez comme suit :

Dans le centre d'activités Administration, accédez à Extensions.
Sur l'extension à télécharger, cliquez sur et sélectionnez Télécharger.
Enregistrer le fichier ZIP.

Migration d'extensions

Suivez les étapes suivantes pour migrer des extensions ayant le statut Non migrée.

Procédez comme suit :

Dans le centre d'activités Administration, accédez à Extensions.
Sur l'extension à migrer, cliquez sur et sélectionnez Migrer.

Le statut est mis à jour à mesure de la progression de la migration : En file d'attente pour la migration, Migration en cours et pour finir Migrée.

Suppression d'extensions

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 Delete.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici