Déploiement et installation du complément Qlik pour Microsoft Excel

Déployez et installez le complément Qlik pour Microsoft Excel afin de permettre aux utilisateurs de votre entreprise de créer des modèles de rapport. Chargez les modèles de rapport créés à l'aide du complément dans l'application Qlik Cloud pour générer la sortie de rapport des tâches de rapport.

Le complément Qlik Excel peut être déployé et installé sur les versions Web et bureau compatibles de Microsoft Excel dans Microsoft 365. Pour pouvoir utiliser le complément dans des version bureau de Excel dans Microsoft 365, vous devez disposer d'un système d'exploitation Windows.

Le complément est installé via un fichier de manifeste. Ce fichier de manifeste est obligatoire pour que l'administrateur Microsoft 365 (ou éventuellement un utilisateur, dans certaines méthodes d'installation), puisse déployer et installer le complément pour lui-même ou pour des utilisateurs de son entreprise. Un fichier de manifeste permet l'installation du complément pour un seul Qlik Cloud client.

Une fois le fichier de manifeste ou l'URL obtenu(e), il existe deux méthodes différentes pour déployer et installer le complément :

• Déploiement centralisé : Déploiement, installation et activation centralisés

• Chargement latéral : Installation du complément via un chargement latéral ou un partage réseau

Microsoft Excel Conditions requises en matière de version

Pour pouvoir exécuter le complément Qlik Excel, vous devez disposer d'une installation Microsoft Excel avec l'API Excel 1.9 ou une version plus récente. Pour vérifier que votre installation Excel est conforme, voir la documentation Microsoft officielle dans Ensembles de conditions requises relatives à l'API JavaScript Excel.

Si la version de votre API Excel est inférieure à la version minimale requise, une erreur apparaît, indiquant que le complément Qlik nécessite une version plus récente de Microsoft Excel.

Pour voir l'erreur, vous devrez peut-être cliquer sur la zone blanche à droite dans Microsoft Excel et appuyer sur F5 pour mettre la page à jour.

Si vous voyez cette erreur, mettrez votre installation Microsoft Excel à niveau.

Préparation et obtention du manifeste du complément

Le complément Qlik Excel est installé dans l'environnement Microsoft via un fichier de manifeste. Il s'agit d'un fichier XML. Pour un déploiement centralisé, l'URL du fichier de manifeste devra probablement être fournie par l'administrateur Microsoft.

Un fichier de manifeste est spécifique à un seul Qlik Cloud client.

L'installation du complément nécessite la configuration d'un client OAuth. Après avoir configuré le client OAuth, récupérez le lien vers le fichier de manifeste ainsi que le manifeste lui-même auprès de la Qlik Cloud Console de gestion.

Procédez comme suit :

1. Créez le client OAuth dans le client Qlik Cloud via la configuration requise. Pour des instructions complètes, voir Création d'un client OAuth pour le complément Qlik pour Microsoft Excel.

2. Accédez à la Console de gestion et générez le lien vers le manifeste. Pour d'autres cas d'utilisation, vous pouvez également télécharger le fichier de manifeste directement. Voir Gestion des manifestes d'installation pour le complément Qlik pour Microsoft Excel.

Création d'un client OAuth pour le complément Qlik pour Microsoft Excel

Pour installer le complément Qlik pour Microsoft Excel, il convient de configurer un client OAuth. Le complément est utilisé par les développeurs de rapports pour préparer des modèles de rapport qui contrôlent la sortie des rapports tabulaires de l'application Qlik Sense.

Pour que OAuth fonctionne dans le complément, il convient de configurer le client OAuth exactement comme indiqué ci-dessous.

Procédez comme suit :

1. Dans la Console de gestion dans Qlik Cloud, accédez à OAuth.

2. Cliquez sur Créer un nouvel élément.

3. Dans le menu déroulant Type de client, sélectionnez Application d'une seule page. D'autres champs apparaissent.

4. Insérez un Nom. La Description est facultative.

5. Cochez au minimum la case permettant d'inclure l'étendue user_default. Vous pouvez inclure d'autres étendues dans la configuration, mais, sans user_default, l'installation ne fonctionnera pas.

   Pour une description complète de chaque étendue disponible, voir Création d'un client OAuth.

6. Dans le champ Ajouter des URL de redirection, insérez l'URL de votre client, suivie de la chaîne fixe : /office-add-ins/oAuthLoginSuccess.html

   Le résultat devrait ressembler à ceci : https://YourServer/office-add-ins/oAuthLoginSuccess.html

7. Cliquez sur Ajouter.

8. Dans le champ Ajouter des origines autorisées, insérez l'URL de votre client et cliquez sur Ajouter.

9. Cliquez sur Créer.

10. La fenêtre Copier votre ID client apparaît. Vous pouvez choisir de copier l'ID client dans le Presse-papiers ou de cliquer sur Terminé pour fermer la fenêtre.

Une fois le client OAuth créé, procurez-vous le lien vers le fichier XML de manifeste mis à jour auprès de la Console de gestion. Accédez à la page Paramètres, puis à Partage et rapports > Complément Excel au sein de la Console de gestion. Utilisez ce lien pour déployer et installer le complément.

Déploiement, installation et activation centralisés

Il est recommandé de mettre le complément Qlik à disposition via un déploiement et une installation centralisés. Le déploiement centralisé nécessite l'intervention d'un administrateur Microsoft 365 de votre entreprise.

Dans le cadre d'un déploiement centralisé, le manifeste du complément est chargé dans le centre d'administration Microsoft 365 de votre entreprise et distribué aux utilisateurs sous forme d'installation préconfigurée. La distribution peut être limitée aux membres de groupes de sécurité spécifiques.

Vous devez utiliser un déploiement centralisé dans les cas suivants :

• Vous souhaitez déployer le complément de sorte qu'il soit installé de manière permanente pour les membres de votre entreprise

• Vous souhaitez gérer la distribution auprès des membres de votre entreprise

Pour le flux de travail complet, suivez les sections de la procédure ci-dessous.

Déploiement et installation centralisés

Le déploiement centralisé est effectué par un administrateur système Microsoft 365.

Procédez comme suit :

1. Obtenez le fichier de manifeste ou l'URL du manifeste du complément après la création d'un client OAuth. Voir Préparation et obtention du manifeste du complément.

2. Distribuez le complément conformément à la documentation Microsoft officielle : Déploiement et publication de compléments Office. Notez que la distribution via un déploiement centralisé est possible uniquement si vous utilisez le centre d'administration Microsoft 365.

Si vous suivez la procédure ci-dessus, le complément est installé pour les utilisateurs qui en reçoivent l'accès. Les utilisateurs activent ensuite le complément dans leur version Microsoft Excel.

Activation du complément après un déploiement centralisé

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

Suppression du complément

Si votre installation utilise un déploiement centralisé, il se peut que vous ne soyez pas en mesure de désinstaller le complément. Cela dépend de la politique appliquée par votre administrateur Microsoft 365.

Installation du complément via un chargement latéral ou un partage réseau

L'installation par chargement latéral et l'installation par partage réseau constituent des méthodes appropriées pour obtenir rapidement l'accès au complément à des fins de test ou d'évaluation. Ces méthodes ne sont pas adaptées pour le déploiement du complément dans des scénarios de production ou à l'échelle de l'entreprise.

Avec les deux méthodes, le complément est conservé dans votre environnement personnel pendant un maximum de 48 heures. Au bout de 48 heures, vous devez charger de nouveau le manifeste. Pour lire des instructions sur la méthode de votre choix, voir ci-dessous.

Option 1 : chargement latéral du complément sur le Web

Pour charger latéralement le complément via Excel 365 sur le Web, l'utilisateur charge le fichier de manifeste sur son navigateur.

Le chargement latéral est pris en charge par les versions Web de Excel fournies par Microsoft 365.

Il est conseillé d'effectuer un chargement latéral dans les cas suivants :

• Vous devez accéder rapidement au complément.

• Vous souhaitez tester le fonctionnement du complément de manière isolée.

• Vous souhaitez tester le complément sans demander l'intervention d'un administrateur Microsoft 365.

Procédez comme suit :

1. Préparez et téléchargez le fichier de manifeste. Voir Préparation et obtention du manifeste du complément.

2. Ouvrez Microsoft Office sur le Web à l'adresse https://office.live.com/.

3. Ouvrez un nouveau document Excel.

4. Ouvrez l'onglet Insérer du ruban et, dans la section Compléments, sélectionnez Compléments Office.

5. Dans la boîte de dialogue Compléments Office, sélectionnez l'onglet MES COMPLÉMENTS, puis Gérer mes compléments et Charger mon complément.

6. Accédez au fichier de manifeste du complément et sélectionnez Charger.

7. Si nécessaire, connectez-vous à votre compte Qlik Cloud.

Suppression d'un complément chargé latéralement

Pour supprimer le complément chargé latéralement, videz le cache du navigateur Web avec lequel vous utilisez le complément.

Option 2 :  installation du complément sur les versions bureau d'Excel via un partage réseau Windows

Pour installer le complément sur une version bureau de Excel sans déploiement centralisé, vous pouvez configurer un partage réseau et y charger le manifeste. Cela peut s'effectuer uniquement sur un système d'exploitation Windows.

Suivez les instructions ci-dessous pour charger le complément latéralement via un partage réseau. Les instructions sont adaptées de la documentation Microsoft officielle. Pour plus d'informations, voir Chargement latéral de compléments Office à des fins de test depuis un partage réseau ou d'autres ressources Microsoft.

Étape 1 : création et partage d'un dossier

Procédez comme suit :

1. Créez un dossier pour héberger le complément Qlik. Par exemple : C:\Complément Qlik Excel

2. Dans l'explorateur de fichiers Windows, accédez au dossier parent ou à la lettre de lecteur du dossier à utiliser comme catalogue de dossiers partagés. Par exemple : C:\

3. Cliquez sur le dossier à l'aide du bouton droit de la souris et sélectionnez Propriétés.

4. Ouvrez l'onglet Partage et cliquez sur le bouton Partager....

   

5. Dans la boîte de dialogue, ajoutez-vous et ajoutez tous les autres utilisateurs et/ou groupes avec lequel partager le complément. Vous devrez être titulaire au minimum d'une autorisation d'accès en lecture/écriture sur le dossier. Une fois que vous avez sélectionné les personnes avec lesquelles partager le complément, cliquez sur Partager.

6. Lorsque vous voyez apparaître la confirmation que le dossier a été partagé, notez le chemin d'accès au réseau complet qui s'affiche immédiatement après le nom de dossier. Cliquez sur Terminé pour fermer la boîte de dialogue.

   

7. Cliquez sur Fermer pour fermer la boîte de dialogue Propriétés.

Étape 2 : configuration manuelle du dossier partagé comme catalogue fiable

Procédez comme suit :

1. 1. Ouvrez un nouveau classeur vide dans la version bureau de Excel.

2. Cliquez sur l'onglet Fichier, puis sur Options dans le coin inférieur gauche.

3. Cliquez sur Centre de gestion de la confidentialité, puis sur le bouton Paramètres du Centre de gestion de la confidentialité....

   

4. Cliquez sur Catalogues de compléments fiables.

   

5. Dans la case URL du catalogue, saisissez le chemin d'accès au réseau complet jusqu'au dossier précédemment partagé.

6. Cliquez sur Ajouter le catalogue.

7. Cochez la case Afficher dans le menu du nouvel élément ajouté, puis cliquez sur OK pour fermer la boîte de dialogue Centre de gestion de la confidentialité.

   

8. Cliquez sur OK pour fermer la boîte de dialogue.

9. Fermez et rouvrez Excel afin que les modifications prennent effet.

Étape 3 : chargement latéral du complément

Procédez comme suit :

1. Ajoutez le fichier XML de manifeste du complément au dossier partagé.

2. Dans Excel, cliquez sur Mes compléments dans l'onglet Insérer du ruban.

3. Cliquez sur DOSSIER PARTAGÉ tout en haut de la boîte de dialogue Compléments Office.

4. Sélectionnez Qlik pour insérer le complément.

5. Vous verrez peut-être apparaître une boîte de dialogue indiquant un message tel que le suivant : Qlik souhaite afficher une nouvelle fenêtre. Cliquez sur Autoriser.

Suppression d'un complément installé via le partage réseau

Pour supprimer un complément chargé latéralement, supprimez le contenu de ce dossier : %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Si votre installation utilise un déploiement centralisé, il se peut que vous ne soyez pas en mesure de désinstaller le complément. Cela dépend de la politique appliquée par votre administrateur système.

Ajout de plusieurs compléments Qlik à Microsoft Excel

Chaque complément Qlik ajouté peut être utilisé avec un seul Qlik Cloud client. Pour utiliser plusieurs clients, vous devrez déployer le manifeste du complément pour chaque client.

Suivant votre version de Microsoft Excel et le navigateur utilisé, lors du chargement de plusieurs compléments, la barre de ruban peut afficher des icônes pour chacun d'entre eux ou une seule icône correspondant à la dernière instance déployée.

Si vous utilisez différentes versions du complément liées à différents clients et si le client spécifique auquel vous souhaitez vous connecter n'apparaît pas dans la barre de ruban, répétez la procédure d'installation pour le client en question et actualisez la page du navigateur.