Déploiement et installation de compléments Qlik pour Microsoft Office

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

Les compléments Qlik pour Microsoft Office peuvent être déployés et installés sur les versions Internet et bureau compatibles de Excel, PowerPoint et Word dans Microsoft 365.

Les compléments sont installés 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 des compléments pour lui-même ou pour des utilisateurs de son organisation. Un fichier de manifeste permet l'installation de compléments pour un seul client Qlik Cloud.

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

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

• Chargement latéral : Installation de compléments via un chargement latéral ou un partage réseau

Pour plus d'informations, consultez Conception de modèles de rapport à l'aide de compléments Qlik pour Microsoft Office.

Conditions requises pour le système et les logiciels

Note Qlik Cloud Government

Les compléments Qlik pour Microsoft Office sont supportés pour le développement de modèles de rapport par rapport aux applications dans les clients Qlik Cloud Government ou Qlik Cloud Government - DoD. Les compléments sont disponibles uniquement pour Office 365 Commercial.

Pour installer et utiliser des compléments Qlik, vous devez remplir les conditions suivantes.

Complément Qlik pour Microsoft Excel

Pour les installations Windows :

• Windows 10 v.1903 ou une version supérieure

• Microsoft 365 v.16.0.11629 ou une version supérieure

Pour les installations macOS :

• macOS v.14 ou une version supérieure

• Microsoft 365 v.16.83 ou une version supérieure

De plus, pour pouvoir exécuter le complément Qlik pour Microsoft 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.

Complément Qlik pour Microsoft PowerPoint

Pour les installations Windows :

• Windows 10 v.1903 ou une version supérieure

• Microsoft 365 version 2504 (build 18730.20030) ou une version supérieure

Pour les installations macOS :

• macOS v.14 ou une version supérieure

• Microsoft 365 v.16.96 ou une version supérieure

Complément Qlik pour Microsoft Word

Pour les installations Windows :

• Windows 10 v.1903 ou une version supérieure

• Microsoft 365 version 2208 (build 15601.20148) ou une version supérieure

Pour les installations macOS :

• macOS v.14 ou une version supérieure

• Microsoft 365 v.16.64 ou une version supérieure

Préparation et obtention du manifeste du complément

Les compléments Qlik pour Microsoft Office sont installés 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 client Qlik Cloud. Le même fichier de manifeste peut être utilisé pour installer les compléments pour Excel, PowerPoint et Word.

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 fichier de manifeste lui-même auprès du centre d'activités Administration.

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 de clients OAuth pour les compléments Qlik pour Microsoft Office.

2. Accédez au centre d'activités Administration et générez le lien du manifeste. Pour d'autres cas d'utilisation, vous pouvez également télécharger le fichier de manifeste directement. Consultez Gestion des manifestes d'installation pour les compléments Qlik pour Microsoft Office.

Création de clients OAuth pour les compléments Qlik pour Microsoft Office

Pour installer des compléments Qlik pour Microsoft Office, il convient de configurer un client OAuth. Les compléments sont utilisés par les développeurs de rapports pour préparer des modèles de rapport pour la génération de rapports dans l'application avec Qlik Cloud.

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

Procédez comme suit :

1. Dans le centre d'activités Administration , dans Qlik Cloud, accédez à OAuth.

2. Cliquez sur Créer.

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 Étendues OAuth disponibles.

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

   Le résultat devrait ressembler à ceci : https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Par exemple : http://example-company-123.us.qlikcloud.com/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 XML vers le manifeste mis à jour auprès du centre d'activités Administration. Accédez à la page Paramètres, puis sélectionnez l'onglet E-mail et rapports. Dans la section Partage et rapports, sélectionnez Compléments Qlik pour Microsoft Office. Utilisez le lien fourni pour déployer et installer le complément.

Déploiement, installation et activation centralisés

Il est recommandé de mettre les compléments Qlik pour Microsoft Office à disposition via un déploiement et une installation centralisés. Le déploiement centralisé nécessite l'action d'un administrateur Microsoft 365 de votre organisation.

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. Consultez 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, les compléments sont installés pour les utilisateurs qui en reçoivent l'accès. Les utilisateurs activent ensuite les compléments dans leur version d'Excel, de PowerPoint ou de Word.

Pour installer des compléments sur une version bureau d'Excel, de PowerPoint ou de Word 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.

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

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

Suivant la version de votre application Microsoft Office, 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 une version bureau ou Internet d'Excel, de PowerPoint ou de Word.

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 Excel, PowerPoint et Word

Suppression d'un 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 de compléments 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 à des compléments à des fins de test ou d'évaluation. Ces méthodes ne sont pas adaptées pour le déploiement de compléments dans des scénarios de production ou à l'échelle de l'entreprise.

Suivant votre version d'Excel, de PowerPoint ou de Word et d'autres facteurs, les compléments chargés à l'aide de ces méthodes peuvent éventuellement être supprimés de votre barre de ruban. Si cela se produit, chargez de nouveau le manifeste dans l'application Microsoft Office.

Option 2 :  installation d'un complément sur des applications Microsoft Office de bureau via un partage réseau Windows

Pour installer des compléments sur une version bureau d'Excel, de PowerPoint ou de Word 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 latéralement des compléments 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éez et partagez un dossier

Procédez comme suit :

1. Créer un dossier pour héberger le complément Qlik. Par exemple : C:\Compléments Qlik Office

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 : configurez manuellement le dossier partagé sous forme de catalogue fiable

Procédez comme suit :

1. Ouvrez un nouveau classeur vide dans la version bureau d'Excel, de PowerPoint ou de Word.

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 l'application afin que les modifications prennent effet.

Étape 3 : chargez latéralement le complément

Procédez comme suit :

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

2. Dans Excel, PowerPoint ou Word, cliquez sur Compléments dans l'onglet Accueil du ruban.

3. Cliquez sur Autres compléments.

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

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

6. Vous verrez peut-être apparaître une fenêtre de 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

Procédez comme suit :

1. Si Excel, PowerPoint ou Word est ouvert, fermez-le.

2. Supprimez le contenu de ce dossier : %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Option 3 : chargement latéral d'un complément sur des applications macOS de bureau

Pour macOS, les compléments peuvent être installés sur des versions bureau Microsoft 365 d'Excel, de PowerPoint ou de Word. Pour les conditions requises pour le système et les logiciels, voir Conditions requises pour le système et les logiciels.

Suivez les lignes directrices ci-dessous. Les instructions sont adaptées de la documentation Microsoft officielle. Pour des instructions complètes, voir la documentation Microsoft officielle : Charger une version test des compléments Office sur Mac

Procédez comme suit :

1. Ouvrez l'application Finder sur votre ordinateur.

2. Appuyez sur la combinaison de touches du clavier suivante : Commande+Maj+G

   Le menu Aller au dossier s'ouvre.

3. Saisissez l'un des chemins d'accès suivants en fonction de l'application Microsoft Office :

   • Excel : /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   • PowerPoint : /Users/<username>/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   • Word : /Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

   Il se peut que le dossier wef n'existe pas encore sur votre ordinateur. Si c'est le cas, créez-le à cet emplacement.

4. Dans le dossier wef, ajoutez une copie du fichier de manifeste XML.

5. Ouvrez Excel, PowerPoint ou Word. S'il est déjà ouvert, vous devrez le redémarrer.

6. Dans la barre de ruban, accédez à Accueil > Compléments.

7. Sélectionnez le complément Qlik.

Le complément Qlik devrait être maintenant disponible dans votre barre de ruban.

Suppression d'un complément chargé latéralement d'applications macOS de bureau

Pour supprimer le complément Qlik, vous devez vider le cache Office de votre ordinateur. Pour plus d'informations, consultez :

• Supprimer un complément chargé de manière indépendante

• Effacer le cache Office

Dépannage

Cette section fournit des conseils pour résoudre les problèmes de déploiement et d'installation courants.

Pour des conseils de dépannage supplémentaires, consultez Dépannage - Génération de rapports dans l'application.

Boîte de dialogue vide affichée lors de l'authentification après le déploiement d'un complément Qlik pour Microsoft Office

Lorsqu'un utilisateur tente de s'authentifier auprès d'un complément de génération de rapports pour Microsoft Excel, Microsoft PowerPoint ou Microsoft Word, il se peut que sa boîte de dialogue contextuelle d'authentification soit vide. Sinon, il se peut que l'utilisateur voit apparaître une erreur dans la boîte de dialogue (en particulier, 12006).

Pour qu'un utilisateur puisse utiliser un complément Qlik pour Microsoft Office, le flux d'authentification requiert une redirection entre votre client et le fournisseur d'identité hébergé dans un domaine différent. Votre fournisseur d'identité définit une Cross-Origin-Opener-Policy avec des paramètres restrictifs. En conséquence, la partie communication inter-domaines du flux d'authentification est bloquée, empêchant le renvoi correct des informations d'identification de connexion au complément.

La résolution suivante doit être effectuée par un administrateur réseau chargé de configurer les fournisseurs d'identité.

Procédez comme suit :

• Définissez l'en-tête de réponse de votre IdP dans votre boîte de dialogue sur :

  Cross-Origin-Opener-Policy: unsafe-none

Pour plus d'informations, consultez la documentation Microsoft officielle : Meilleures pratiques et règles pour l'API Office Dialog.