Bereitstellen und Installieren von Qlik Add-Ins für Microsoft Office

Stellen Sie Qlik Add-Ins für Microsoft Office bereit und installieren Sie sie, damit Benutzer in Ihrer Organisation Berichtsvorlagen erstellen können. Laden Sie mit den Add-Ins erstellte Berichtsvorlagen an die Qlik Cloud App hoch, um eine Berichtsausgabe der Berichtsaufgaben zu generieren.

Qlik Add-Ins für Microsoft Office können auf kompatiblen Web- und Desktopversionen von Excel, PowerPoint und Word innerhalb von Microsoft 365 bereitgestellt und installiert werden.

Add-Ins werden mithilfe einer Manifest-Datei installiert. Diese Manifest-Datei wird vom Microsoft 365-Administrator (bzw. bei bestimmten Installationsmethoden von einem Benutzer) benötigt, um Add-Ins für sich selbst oder für die Benutzer in ihrer Organisation bereitzustellen und zu installieren. Eine Manifest-Datei ermöglicht die Installation von Add-Ins für einen einzelnen Qlik Cloud Mandanten.

Nachdem Sie die Manifest-Datei oder URL erhalten haben, gibt es zwei verschiedene Methoden zum Bereitstellen und Installieren von Add-Ins:

• Zentralisierte Bereitstellung: Zentralisierte Bereitstellung, Installation und Aktivierung

• Querladen: Installieren von Add-Ins über Querladen oder Netzwerkfreigabe

Weitere Informationen finden Sie unter Entwerfen von Berichtsvorlagen mit Qlik Add-Ins für Microsoft Office.

System- und Softwareanforderungen

Hinweis zu Qlik Cloud Government

Qlik Add-Ins für Microsoft Office werden für die Entwicklung von Berichtsvorlagen für Apps in Qlik Cloud Government oder Qlik Cloud Government – DoD Mandanten unterstützt. Die Add-Ins sind nur für Office 365 Commercial verfügbar.

Um Qlik Add-Ins zu installieren und zu verwenden, müssen Sie die folgenden Anforderungen erfüllen.

Qlik Add-In für Microsoft Excel

Für Windows-Installationen:

• Windows 10 V.1903 oder höher

• Microsoft 365 V.16.0.11629 oder höher

Für macOS-Installationen:

• macOS V.14 oder höher

• Microsoft 365 V.16.83 oder höher

Zum Ausführen des Qlik Add-Ins für Microsoft Excel benötigen Sie eine Microsoft Excel-Installation mit ExcelAPI 1.9 oder höher. Um zu prüfen, ob Ihre Excel-Installation kompatibel ist, prüfen Sie die offizielle Microsoft-Dokumentation unter JavaScript-API-Anforderungssätze für Excel.

Wenn Ihre ExcelAPI älter als die mindestens erforderliche Version ist, wird ein Fehler angezeigt, der angibt, dass das Qlik Add-In eine höhere Version von Microsoft Excel erfordert.

Möglicherweise müssen Sie in den leeren Bereich rechts in Microsoft Excel klicken und F5 drücken, um die Seite zu aktualisieren, damit der Fehler angezeigt wird.

Wenn dieser Fehler angezeigt wird, aktualisieren Sie die Microsoft Excel-Installation.

Qlik Add-In für Arbeitsblatt – Microsoft PowerPoint

Für Windows-Installationen:

• Windows 10 V.1903 oder höher

• Microsoft 365 Version 2504 (Build 18730.20030) oder höher

Für macOS-Installationen:

• macOS V.14 oder höher

• Microsoft 365 V.16.96 oder höher

Qlik Add-In für Microsoft Word

Für Windows-Installationen:

• Windows 10 V.1903 oder höher

• Microsoft 365 Version 2208 (Build 15601.20148) oder höher

Für macOS-Installationen:

• macOS V.14 oder höher

• Microsoft 365 V.16.64 oder höher

Vorbereiten und Abrufen des Add-In-Manifests

Qlik Add-Ins für Microsoft Office werden in der Microsoft-Umgebung mithilfe einer Manifest-Datei installiert. Dies ist eine XML-Datei. Für eine zentralisierte Bereitstellung muss wahrscheinlich vom Microsoft-Administrator eine URL zu der Manifest-Datei bereitgestellt werden.

Eine Manifest-Datei ist für einen einzelnen Qlik Cloud Mandanten spezifisch. Die gleiche Manifest-Datei kann zum Installieren von Add-Ins für Excel, PowerPoint und Word verwendet werden.

Eine OAuth-Client-Konfiguration ist erforderlich, um das Add-In zu installieren. Nachdem Sie den OAuth-Client konfiguriert haben, erhalten Sie den Link zur Manifest-Datei sowie die Manifest-Datei selbst über das Aktivitätscenter Administration.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie den OAuth-Client im Qlik Cloud Mandanten mit der erforderlichen Konfiguration. Umfassende Anweisungen hierzu finden Sie unter Erstellen von OAuth-Clients für Qlik Add-Ins für Microsoft Office.

2. Navigieren Sie zum Aktivitätscenter Administration und generieren Sie den Manifest-Link. Für alternative Anwendungsfälle können Sie die Manifest-Datei auch direkt herunterladen. Weitere Informationen finden Sie unter Verwalten von Installations-Manifests für Qlik Add-Ins für Microsoft Office.

Erstellen von OAuth-Clients für Qlik Add-Ins für Microsoft Office

Eine OAuth-Client-Konfiguration ist erforderlich, um Qlik-Add-Ins für Microsoft Office zu installieren. Add-Ins werden von Berichtsentwicklern verwendet, um Berichtsvorlagen für die In-App-Berichterstellung mit Qlik Cloud vorzubereiten.

Damit OAuth mit Add-Ins funktioniert, muss der OAuth-Client exakt mit der unten gezeigten Konfiguration konfiguriert werden.

Gehen Sie folgendermaßen vor:

1. Gehen Sie im Aktivitätscenter Administration in Qlik Cloud zu Einstellungen.

2. Klicken Sie auf Neu erstellen.

3. Wählen Sie im Dropdown-Menü Client-Typ die Option App mit einer Seite aus. Es werden weitere Felder angezeigt.

4. Fügen Sie einen Namen ein. Die Beschreibung ist optional.

5. Aktivieren Sie mindestens das Kontrollkästchen, um den user_default-Anwendungsbereich einzuschließen. Sie können weitere Anwendungsbereiche in die Konfiguration einschließen, aber ohne user_default funktioniert die Installation nicht.

   Unter Verfügbare OAuth-Anwendungsbereiche finden Sie eine vollständige Beschreibung der einzelnen verfügbaren Anwendungsbereiche.

6. Fügen Sie im Feld Umleitungs-URLs hinzufügen die URL des Qlik Cloud Mandanten ein, gefolgt von dieser festen Zeichenfolge: /office-add-ins/oAuthLoginSuccess.html

   Das Ergebnis sollte wie folgt aussehen: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Zum Beispiel: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Klicken Sie auf Hinzufügen.

8. Fügen Sie im Feld Zugelassene Herkünfte hinzufügen Ihre Mandante-URL ein und klicken Sie auf Hinzufügen.

9. Klicken Sie auf Erstellen.

10. Das Fenster Client-ID kopieren wird angezeigt. Sie können die Client-ID in die Zwischenablage kopieren oder auf Fertig klicken, um das Fenster zu schließen.

Nachdem Sie den OAuth-Client erstellt haben, rufen Sie den Link zum aktualisierten XML-Manifest über das Aktivitätscenter Administration ab. Navigieren Sie zur Seite Einstellungen und wählen Sie die Registerkarte E-Mail und Berichte aus. Wählen Sie im Abschnitt Freigaben und Berichte die Option Qlik-Add-Ins für Microsoft Office aus. Verwenden Sie den angegebenen Link, um das Add-In bereitzustellen und zu installieren.

Zentralisierte Bereitstellung, Installation und Aktivierung

Es wird empfohlen, Qlik Add-Ins für Microsoft Office über zentralisierte Bereitstellung und Installation zur Verfügung zu stellen. Eine zentralisierte Bereitstellung erfordert den Eingriff eines Microsoft 365-Administrators in Ihrer Organisation.

Bei einer zentralisierten Bereitstellung wird das Add-In-Manifest in das Microsoft 365 Admin Center Ihrer Organisation geladen und als vorkonfigurierte Installation an die Benutzer bereitgestellt. Die Verteilung kann auf die Mitglieder bestimmter Sicherheitsgruppen beschränkt werden.

Verwenden Sie die zentralisierte Bereitstellung in folgenden Fällen:

• Sie möchten, dass das Add-In für Mitglieder Ihrer Organisation dauerhaft installiert wird

• Sie möchten die Verteilung an die Mitglieder Ihrer Organisation verwalten

In den Abschnitten zum Verfahren unten finden Sie den vollständigen Workflow.

Zentralisierte Bereitstellung und Installation

Die zentralisierte Bereitstellung wird von einem Microsoft 365-Systemadministrator vorgenommen.

Gehen Sie folgendermaßen vor:

1. Rufen Sie die Add-In-Manifest-Datei bzw. Manifest-URL ab, nachdem Sie den OAuth-Client erstellt haben. Weitere Informationen finden Sie unter Vorbereiten und Abrufen des Add-In-Manifests.

2. Verteilen Sie das Add-In gemäß den Anweisungen in der offiziellen Microsoft-Dokumentation: Bereitstellen und Veröffentlichen von Office-Add-Ins. Beachten Sie, dass die Verteilung über zentralisierte Bereitstellung nur über das Microsoft 365 Admin Center möglich ist.

Mit dem obigen Verfahren werden die Add-Ins für die Benutzer installiert, denen Zugriff darauf gewährt wird. Die Benutzer aktivieren die Add-Ins dann in ihrer Excel-. PowerPoint- oder Word-Version.

Um Add-Ins auf einer Desktopversion von Excel, PowerPoint oder Word ohne zentralisierte Bereitstellung zu installieren, können Sie eine Netzwerkfreigabe einrichten und das Manifest darin laden. Das ist nur unter einem Windows-Betriebssystem möglich.

Aktivieren eines Add-Ins nach der zentralisierten Bereitstellung

Nachdem ein Microsoft-Administrator ein Qlik Add-In für Ihre Organisation installiert hat, können Sie es aktivieren und verwenden, wenn Ihnen Zugriff darauf gewährt wurde.

Abhängig von der Version Ihrer Microsoft Office-Anwendung können diese Schritte leicht von der Beschreibung abweichen. Alle Einzelheiten finden Sie in der offiziellen Microsoft-Dokumentation.

Gehen Sie folgendermaßen vor:

1. Öffnen Sie eine Desktop- oder Web-Version von Excel, PowerPoint oder Word.

2. Gehen Sie zu Startseite > Add-Ins > Add-ins abrufen.

3. Wählen Sie auf der Registerkarte VOM ADMINISTRATOR VERWALTET des Dialogfelds das Qlik-Add-In aus.

Das Symbol für das Qlik-Add-In wird auf Ihrer Multifunktionsleiste angezeigt.

Add-Ins für Excel, PowerPoint und Word anzeigen, verwalten und installieren

Entfernen eines Add-Ins

Wenn Ihre Installation über eine zentralisierte Bereitstellung erfolgt ist, können Sie das Add-In möglicherweise nicht deinstallieren. Dies hängt von der Richtlinie ab, die von Ihrem Microsoft 365-Administrator verwendet wird.

Installieren von Add-Ins über Querladen oder Netzwerkfreigabe

Die Installation über Querladen und Netzwerkfreigabe sind geeignete Wege, um zu Test- oder Probezwecken rasch Zugriff auf Add-Ins zu erhalten. Sie eignen sich nicht zum Bereitstellen von Add-Ins für die Produktion und auf Unternehmensebene.

Abhängig von Ihrer Excel-, PowerPoint- oder Word-Version und anderen Faktoren werden mit diesen Methoden geladene Add-Ins möglicherweise aus der Multifunktionsleiste entfernt. Laden Sie in diesem Fall das Manifest erneut in die Microsoft Office-Anwendung.

Option 2: Installieren eines Add-Ins auf Desktopanwendungen von Microsoft Office mithilfe einer Windows-Netzwerkfreigabe

Um Add-Ins auf einer Desktopversion von Excel, PowerPoint oder Word ohne zentralisierte Bereitstellung zu installieren, können Sie eine Netzwerkfreigabe einrichten und das Manifest darin laden. Das ist nur unter einem Windows-Betriebssystem möglich.

Folgen Sie den Anweisungen unten, um Add-Ins über eine Netzwerkfreigabe querzuladen. Die Anweisungen wurden der offiziellen Microsoft-Dokumentation entnommen und angepasst. Weitere Informationen finden Sie unter Querladen von Office-Add-Ins zum Testen von einer Netzwerkfreigabe oder in anderen Microsoft-Ressourcen.

Schritt 1: Einen Ordner erstellen und freigeben

Gehen Sie folgendermaßen vor:

1. Erstellen Sie einen Ordner, um das Qlik Add-In zu hosten. Beispiel: C:\Qlik Office add-ins

2. Gehen Sie im Windows-Datei-Explorer zum übergeordneten Ordner bzw. Laufwerksbuchstaben des Ordners, den Sie als freigegebenen Ordnerkatalog verwenden möchten. Beispiel: C:\

3. Klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Eigenschaften aus.

4. Öffnen Sie die Registerkarte „Freigabe“ und klicken Sie auf die Schaltfläche Freigeben....

   

5. Fügen Sie im Dialogfeld sich selbst und alle anderen Benutzer bzw. Gruppen hinzu, an die Sie das Add-In freigeben möchten. Sie benötigen mindestens Lese-/Schreibzugriff auf den Ordner. Nachdem Sie die Auswahl der Personen für die Freigabe beendet haben, klicken Sie auf Freigeben.

6. Wenn die Bestätigung angezeigt wird, dass Ihr Ordner freigegeben wurde, notieren Sie sich den vollständigen Netzwerkpfad, der direkt nach dem Ordnernamen angezeigt wird. Klicken Sie auf Fertig, um das Dialogfeld zu schließen.

   

7. Klicken Sie auf Schließen, um das Dialogfeld Eigenschaften zu schließen.

Schritt 2: Den freigegebenen Ordner manuell als vertrauenswürdigen Katalog konfigurieren

Gehen Sie folgendermaßen vor:

1. Öffnen Sie in der Desktopversion von Excel, PowerPoint oder Word eine leere Arbeitsmappe.

2. Klicken Sie auf die Registerkarte Datei und dann unten links auf Optionen.

3. Klicken Sie auf Trust Center und dann auf die Schaltfläche Einstellungen für das Trust Center....

   

4. Klicken Sie auf Kataloge vertrauenswürdiger Add-Ins.

   

5. Geben Sie im Feld Katalog-URL den vollständigen Netzwerkpfad zu dem Ordner ein, den Sie zuvor freigegeben haben.

6. Klicken Sie auf Katalog hinzufügen

7. Aktivieren Sie das Kontrollkästchen Im Menü anzeigen für das neu hinzugefügte Element und klicken Sie dann auf OK, um das Trust Center-Dialogfenster zu schließen.

   

8. Klicken Sie auf OK, um das Dialogfenster zu schließen.

9. Schließen und öffnen Sie die Anwendung, damit die Änderungen wirksam werden.

Schritt 3: Add-In querladen

Gehen Sie folgendermaßen vor:

1. Fügen Sie die XML-Manifest-Datei des Add-Ins zum freigegebenen Ordner hinzu.

2. Klicken Sie in Excel, PowerPoint oder Word auf der Registerkarte Startseite der Multifunktionsleiste auf Add-Ins.

3. Klicken Sie auf Weitere Add-Ins.

4. Klicken Sie auf FREIGEGEBENER ORDNER oben im Dialogfeld Office-Add-Ins.

5. Wählen Sie Qlik aus, um das Add-In einzufügen.

6. Möglicherweise wird ein Dialogfenster mit einem Text wie dem Folgenden angezeigt: Qlik möchte ein neues Fenster anzeigen. Klicken Sie auf Zulassen.

Entfernen eines über Netzwerkfreigabe installierten Add-Ins

Gehen Sie folgendermaßen vor:

1. Wenn Sie Excel, PowerPoint oder Word geöffnet haben, schließen Sie die Anwendung.

2. Löschen Sie den Inhalt des folgenden Ordners: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Option 3: Querladen eines Add-Ins in macOS-Desktopanwendungen

Für macOS können Add-Ins in Microsoft 365-Desktopversionen von Excel, PowerPoint oder Word installiert werden. Die System- und Softwareanforderungen finden Sie unter System- und Softwareanforderungen.

Folgen Sie den Anweisungen unten. Die Anweisungen wurden der offiziellen Microsoft-Dokumentation entnommen und angepasst. Umfassende Anweisungen finden Sie in der offiziellen Microsoft-Dokumentation: Querladen und Add-In in Office für Mac

Gehen Sie folgendermaßen vor:

1. Öffnen Sie die Finder-Anwendung auf Ihrem Computer.

2. Geben Sie die folgende Tastaturkombination ein: Cmd+Umschalt+G

   Das Menü Gehe zu Ordner wird geöffnet.

3. Geben Sie abhängig von der Microsoft Office-Anwendung einen der folgenden Pfade ein:

   • 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

   Möglicherweise ist der Ordner wef noch nicht auf Ihrem Computer vorhanden. Erstellen Sie ihn dann an diesem Speicherort.

4. Legen Sie im Ordner wef eine Kopie der XML-Manifest-Datei ab.

5. Öffnen Sie Excel, PowerPoint oder Word. Wenn Sie das Programm bereits geöffnet haben, müssen Sie es neu starten.

6. Navigieren Sie in der Multifunktionsleiste zu Startseite > Add-Ins.

7. Wählen Sie das Qlik Add-In aus.

Das Qlik Add-In steht jetzt in der Multifunktionsleiste zur Verfügung.

Entfernen eines quergeladenen Add-Ins aus macOS-Desktopanwendungen

Um das Qlik Add-In zu entfernen, müssen Sie den Office-Cache auf Ihrem Computer löschen. Weitere Informationen finden Sie unter:

• Ein quergeladenes Add-In entfernen

• Den Office-Cache löschen

Fehlerbehebung

Dieser Abschnitt enthält Tipps zum Lösen häufiger Bereitstellungs- und Installationsprobleme.

Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung – In-App-Berichte.

Nach der Bereitstellung eines Qlik Add-Ins für Microsoft Office wird ein leeres Dialogfeld angezeigt

Wenn ein Benutzer versucht, sich bei einem Berichts-Add-In für Microsoft Excel, Arbeitsblatt – Microsoft PowerPoint oder Microsoft Word zu authentifizieren, kann sein Authentifizierungs-Popup-Dialogfeld leer sein. Alternativ wird dem Benutzer möglicherweise ein Fehler im Dialogfeld angezeigt (insbesondere 12006).

Damit ein Benutzer mit einem Qlik Add-In für Microsoft Office arbeiten kann, erfordert der Authentifizierungsfluss eine Umleitung zwischen Ihrem Mandanten und dem Identitätsanbieter, der in einer anderen Domäne gehostet ist. Ihr Identitätsanbieter legt eine Cross-Origin-Opener-Policy mit restriktiven Einstellungen fest. Dadurch wird der Teil der domänenübergreifenden Kommunikation des Authentifizierungsflusses blockiert und verhindert, dass die Anmeldeinformationen korrekt an das Add-In zurückgegeben werden.

Vorgeschlagene Aktion  

Die folgende Lösung sollte von einem Netzwerkadministrator durchgeführt werden, der für die Einrichtung von Identitätsanbietern zuständig ist.

Gehen Sie folgendermaßen vor:

• Setzen Sie den Antwort-Header von Ihrem IDP zu Ihrem Dialog auf:

  Cross-Origin-Opener-Policy: unsafe-none

Weitere Informationen finden Sie in der offiziellen Microsoft-Dokumentation: Empfehlungen und Regeln für die Office-Dialogfeld-API