Mise en route avec le complément Qlik pour Microsoft Excel

Cette rubrique vous aidera à vous familiariser avec certaines informations de base sur le complément Qlik pour Microsoft Excel, concernant son activation, son ouverture et sa connexion au contenu Qlik Sense. Pour des informations sur l'ajout de contenu à votre modèle, voir Utilisation du complément Qlik pour Microsoft Excel et les rubriques associées.

Avant de pouvoir commencer à utiliser le complément, vous devez l'installer. Pour plus d'informations, voir Déploiement et installation du complément Qlik pour Microsoft Excel.

Conditions requises pour l'utilisation du complément

Pour pouvoir utiliser le complément pour générer un modèle de rapport pour une application Qlik Sense dans un espace partagé, vous devez être titulaire d'autorisations d'Accès en lecture dans cet espace.

Pour pouvoir utiliser le complément afin de générer un modèle de rapport pour une application Qlik Sense dans un espace géré, vous devez être titulaire, au minimum, d'autorisations A une vue restreinte dans cet espace.

Si vous utilisez une version Web de Microsoft Excel pour Microsoft 365, vous devez autoriser les fenêtres contextuelles dans les paramètres de votre navigateur. Sinon, conservez l'historique de navigation et les cookies. Dans le cas contraire, vous devrez réinstaller le complément chaque fois que vous ouvrirez Excel.

Activation du complément

Après l'installation par un administrateur Microsoft du complément Qlik pour votre entreprise, vous pouvez l'activer et l'utiliser, si vous y avez accès.

Suivant votre version de Microsoft Excel, ces étapes peuvent être légèrement différentes. Pour des informations complètes, voir la documentation Microsoft officielle.

Procédez comme suit :

1. Ouvrez la version bureau ou Web d'Excel.

2. Accédez à Accueil > Compléments > Get Add-ins (Obtenir des compléments).

3. Dans l'onglet ADMIN MANAGED de la boîte de dialogue, sélectionnez le complément Qlik.

L'icône du complément Qlik est ajoutée à la barre de votre ruban.

Affichage, gestion et installation de compléments pour des programmes Microsoft 365

Ouverture du complément

Pour ouvrir le complément, cliquez sur l'icône Qlik dans la barre de ruban sous l'onglet Accueil.

Connexion au client et ouverture de session

Lorsque vous ouvrez le complément, vous êtes invité à vous connecter au client Qlik Cloud pour lequel le complément a été installé. N'oubliez pas qu'une seule installation de complément configure le complément pour un client spécifique. Cliquez sur Se connecter.

L'installation du complément nécessite la configuration d'un client OAuth.

ll vous est demandé d'ouvrir une session la première fois que vous vous connectez, ou si la connexion est fermée côté serveur. Si vous utilisez une version Web de Excel, il vous sera peut-être demandé de vous reconnecter ultérieurement si vous ne conservez pas l'historique de navigation ni les cookies.

Procédez comme suit :

1. Lors de l'invite de connexion, suivez la procédure de connexion de votre compte Qlik à l'aide de la configuration du fournisseur d'identité de votre client, le cas échéant.

2. Dans la boîte de dialogue d'autorisation de l'application, autorisez l'application avec le client OAuth en cliquant sur Approuver. Vous n'avez à le faire qu'une fois que vous vous êtes connecté pour la première fois au client.

Sélection de l'application Qlik Sense pour le modèle

Une fois la connexion effectuée, vous devez sélectionner l'espace Qlik Sense et l'application à utiliser comme source pour le modèle que vous créez. Un modèle de rapport utilise une seule application. Vous ne pourrez ajouter des objets que d'une application Qlik Sense à chaque fichier de modèle Excel.

Procédez comme suit :

1. Sous Espace, sélectionnez l'espace Qlik Cloud Analytics.

2. Sous Application, sélectionnez l'application Qlik Sense de l'espace.

3. Cliquez sur Enregistrer.

Une fois l'application chargée et ses métadonnées renseignées dans le fichier, vous pouvez cliquer sur pour ouvrir l'application source dans Qlik Cloud.

Une fois le modèle connecté à une application source, vous pouvez revenir à l'onglet du complément pour modifier l'application. Pour plus d'informations, voir Modification de l'application Qlik Sense connectée.

Disponibilité des feuilles dans l'application

Lorsque vous vous connectez au complément Qlik pour Microsoft Excel, vous voyez uniquement le contenu auquel vous avez accès dans l'application Qlik Sense source. Par exemple, pour une application figurant dans votre espace personnel, vous pouvez accéder à l'ensemble du contenu. Pour une application dans un espace partagé, vous pouvez voir et utiliser uniquement le contenu public de l'application ou qui vous est réservé (votre contenu privé). Il n'est pas possible de voir ni d'utiliser le contenu de la feuille privée d'un autre utilisateur dans un espace partagé.

Affichage de l'aperçu du rapport

Lors du développement d'un modèle, vous aurez probablement besoin de vérifier que sa sortie correspond à ce que vous recherchez. Affichez un aperçu du rapport pour voir ce à quoi il ressemble sans configurer de tâches de rapport ni vous les envoyer à vous-même par e-mail.

Pour afficher un aperçu du rapport, cliquez sur l'icône de la barre d'outils dans le coin supérieur droit du complément. Vous disposez des options suivantes :

• Aperçu au format Excel (.xlsx)

• Aperçu au format PDF

Suivant la configuration de votre navigateur, votre rapport peut apparaître dans une fenêtre de navigateur ou être téléchargé sur votre ordinateur. Si vous ne voyez pas de rapport, vérifiez que vous avez autorisé les fenêtres contextuelles dans votre navigateur.

Ouvrez le fichier généré pour vérifier les résultats.

Préparation pour une sortie au format PDF et imprimé

Si votre rapport doit être généré au format PDF ou imprimé, vous devrez peut-être ajuster les paramètres d'impression de votre modèle. Pour préparer le modèle, utilisez les fonctions natives de Microsoft Excel. Vous trouverez probablement ces paramètres dans Mise en page.

Parmi ces configurations de mise en page figurent :

• Format de papier

• Orientation de la page

• Zone d'impression sélectionnée

• Sauts de page

L'expérience de navigation pour la configuration de la zone d'impression et de la page dépend de votre version d'Excel, du système d'exploitation et éventuellement de votre navigateur Web. Pour des informations détaillées sur ces fonctions Excel, voir la documentation Microsoft Excel de votre environnement spécifique.

Ouverture de l'objet source dans Qlik Sense

Pour voir l'objet source dans Qlik Sense, sélectionnez l'élément dans le classeur Excel. Ensuite, sous l'option Application source du complément, cliquez sur .

Si l'objet source est un graphique, vous êtes dirigé vers l'application Qlik Sense pour pouvoir afficher la feuille correspondante. Pour pouvoir ouvrir l'application, vous devrez peut-être vous reconnecter à Qlik Cloud.

Enregistrement de votre travail

Enregistrez le classeur Excel comme vous le feriez normalement. Vous pouvez rouvrir le fichier .xlsx comme d'habitude et vous verrez votre modèle.

Recherche de la version du complément et de l'adresse du serveur connecté

Vous pouvez rechercher la version du complément et l'adresse du client (serveur) Qlik Cloud.

Procédez comme suit :

1. Dans la fenêtre du complément, cliquez sur l'onglet dans la barre d'outils.

2. À côté de l'option Application source, cliquez sur .

3. Cliquez sur À propos de.

4. Affichez l'URL du client et la version du complément Office ainsi que l'espace et le nom de l'application Qlik Sense.

Synchronisation du complément sur le client Qlik Cloud

En cas de modifications apportées au client Qlik Cloud connecté, le document Excel qui utilise le complément n'est pas automatiquement mis à jour. Par exemple, vous devrez peut-être actualiser :

• La liste des espaces disponibles que vous pouvez utiliser.

• La liste des applications disponibles que vous pouvez utiliser.

• La liste des entités disponibles dans l'application Qlik Sense sélectionnée.

• Les images de graphique que vous avez utilisées dans le modèle. Par exemple, si vous avez effectué des sélections dans l'application Qlik Sense source, vous souhaiterez peut-être que vos images de graphique reflètent les sélections dans les espaces réservés des images.

• Le statut des images et des tables que vous avez utilisées dans le modèle (par exemple, parce qu'elles ont été supprimées ou que leurs titres ont changé).

Suivez les étapes ci-dessous pour actualiser les métadonnées de la connexion.

Procédez comme suit :

1. Dans la fenêtre du complément, cliquez sur l'onglet dans la barre d'outils.

2. À côté de l'option Application source, cliquez sur .

3. Cliquez sur Actualiser toutes les images.

Cette opération applique une actualisation globale. Vous pouvez également actualiser des entités et des objets individuels dans les autres onglets du complément. L'icône est présente lorsque ces actualisations individuelles sont disponibles.

Les données et les objets d'un modèle ne seront pas mis à jour lorsque l'application Qlik Sense est éditée, sauf si une actualisation est appliquée.

Partage de fichiers de modèle de rapport Excel

Les fichiers Modèle contiennent uniquement des balises de table et des images d'aperçu. Si un autre utilisateur souhaite modifier le modèle et en afficher un aperçu, il doit :

• Disposer du complément Qlik installé dans sa version de Microsoft Excel.

• Accédez au client Qlik Cloud.

• Si l'application se trouve dans un espace partagé : Accès en lecture ou rôle d'espace supérieur dans l'espace, ou dans l'application (afin de pouvoir se connecter à l'application dans le complément et accéder à ses données).

• Si l'application se trouve dans un espace géré : A une vue restreinte ou rôle d'espace supérieur dans l'espace, ou dans l'application (afin de pouvoir se connecter à l'application dans le complément et accéder à ses données).

Cependant, un modèle de rapport est un classeur Excel standard qui contient les données disponibles lors de la création de l'aperçu. Vous pouvez partager le fichier de modèle avec n'importe quelle personne, mais seuls les utilisateurs ayant accès à l'application source pourront s'y connecter dans le complément et l'actualiser. Pour plus d'informations sur les actualisations globales, voir Synchronisation du complément sur le client Qlik Cloud.

Recherche d'objets Qlik Sense dans le complément

Vous pouvez rechercher un objet Qlik Sense spécifique en développant et en parcourant la liste qui apparaît à droite après avoir cliqué sur le bouton Ajouter, ou en insérant une chaîne dans le formulaire de recherche. Après une pression sur Entrée, le système recherchera la chaîne dans les champs suivants de l'application Qlik Sense insérée :

• ID d'objet

• Nom d'objet (feuilles incluses)

• Type de graphique

Pour trouver rapidement le bon objet, il est important d'utiliser les conventions de nommage appropriées lors du développement d'applications Qlik Sense.

Accès aux messages d'erreur

Le complément Excel contient des messages d'erreur natifs. Pour faciliter la signalisation des erreurs lorsque vous contactez Qlik, vérifiez les messages d'erreur dans les outils de développeur de votre navigateur, dans la console JavaScript et dans les onglets Réseau.

Meilleures pratiques pour le nommage efficace des objets lors du développement d'applications Qlik Sense

En ce qui concerne le nommage des objets dans les applications Qlik Sense, il est important de suivre certaines recommandations pour garantir la clarté, la cohérence et la facilité de gestion. Les noms d'objet sont les balises de graphique et de table qui apparaissent dans votre modèle de rapport. Voici quelques recommandations pour le nommage des objets tels que les tables, les graphiques et d'autres éléments dans Qlik Sense :

• Utilisez un nom unique pour chaque objet. Évitez les doublons susceptibles de porter à confusion et de vous amener à vous tromper d'objet lors de leur ajout.

• Utilisez des noms clairs et descriptifs. Sélectionnez des noms qui reflètent exactement l'objectif et le contenu de l'objet. Évitez les noms ambigus ou génériques susceptibles de porter à confusion.

• Soyez concis, mais informatif. Sélectionnez des noms concis, mais fournissant suffisamment d'informations pour indiquer la fonction ou les données de l'objet. Les noms longs et complexes peuvent être difficiles à utiliser.

• Utilisez des conventions de nommage uniformes. Établissez et suivez une convention de nommage uniforme pour l'ensemble des objets de votre application. Cela facilite la conservation d'une structure logique et la recherche, l'identification et la gestion des objets.

• Évitez d'utiliser des caractères spéciaux. Contentez-vous de caractères alphanumériques et de traits soulignement dans les noms d'objet. Les caractères spéciaux peuvent causer des problèmes dans les scripts ou les expressions.

• Utilisez le camel case (la notation chameau) ou des traits de soulignement au lieu d'espaces : sélectionnez la notation chameau (maTable) ou des traits de soulignement (ma_table) pour séparer les termes dans les noms d'objet. Cela facilite la lisibilité et la compréhension des noms.

• Évitez les mots clés réservés. Qlik Sense a des mots clés réservés qui ne doivent pas être utilisés comme noms d'objet. Ces mots clés sont utilisés dans des expressions, des scripts ou l'environnement Qlik Sense. Par exemple, « if », « and », ou « load », etc.

• Pour les dimensions et les mesures, utilisez des noms significatifs et intuitifs. Lors de la création de dimensions et de mesures dans des graphiques, utilisez des noms qui décrivent clairement les données ou calculs sous-jacents qu'ils représentent. Cela renforce la compréhension et la collaboration entre les développeurs et les utilisateurs finaux.

• Documentez les conventions de nommage. Conservez et gérez la documentation qui définit les conventions de nommage utilisées dans vos applications Qlik Sense. Cela aidera les nouveaux développeurs à comprendre les conventions de nommage et à garantir la cohérence lorsque différents développeurs interviennent sur la même application.

• Examinez et actualisez régulièrement les noms d'objet. À mesure de l'évolution de votre application ou des conditions, examinez et actualisez régulièrement les noms d'objet pour garantir leur alignement sur la structure et la fonctionnalité existantes de l'application.