Accéder au contenu principal Passer au contenu complémentaire

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.

Note Qlik Cloud GovernmentLes extensions tierces sont supportées dans Qlik Cloud Government. Cependant, il se peut que l'utilisation d'extensions tierces doive être définie et approuvée dans le cadre d'une déclaration Agency Authority to Operate (Droit de fonctionner des agences - ATO), suivant les conditions de sécurité et de conformité exigées par votre entreprise.

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.

Note ConseilNous recommandons de vérifier les extensions et leur code avant d'effectuer le chargement. Pour obtenir davantage d'informations, voir Extensions de visualisation (uniquement en anglais).

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és des extensions
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'
Note InformationsTous les fichiers dans une extension doivent avoir un nom et une extension. Les fichiers non conformes seront ignorés. Exemples de fichiers ignorés : .gitignore et README.

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 :

  1. Dans le centre d'activités Administration, accédez à la section Extensions et cliquez sur Ajouter dans le coin supérieur droit.
  2. 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.
  3. Ajoutez éventuellement des balises.

  4. Cliquez sur Publier.

  5. 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 :

  1. Dans le centre d'activités Administration, accédez à la section Extensions et cochez la case de l'extension à modifier.
  2. 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.

  3. Apportez vos modifications et enregistrez.

Suppression d'une extension

Procédez comme suit :

  1. Dans le centre d'activités Administration, accédez à la section Extensions et cochez les cases des extensions à supprimer.
  2. Dans l'angle supérieur droit, cliquez sur Supprimer.
Note InformationsLa suppression d'extensions peut affecter toutes les ressources. Tous les utilisateurs au sein d'un client sont affectés par une suppression.

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 – dites-nous comment nous améliorer !