De Qlik-invoegtoepassingen voor Microsoft Office implementeren en installeren

Implementeer en installeer Qlik-invoegtoepassingen voor Microsoft Office om gebruikers in uw organisatie in staat te stellen rapportsjablonen te maken. Upload met de invoegtoepassingen gemaakte rapportsjablonen naar de Qlik Cloud-app om rapportuitvoer te genereren vanuit rapporttaken.

Qlik-invoegtoepassingen voor Microsoft Office kunnen voor compatibele web- en desktopversies van Excel, PowerPoint en Word in Microsoft Outlook 365 worden geïmplementeerd en geïnstalleerd.

Invoegtoepassingen worden geïnstalleerd met behulp van een manifestbestand. Dit manifestbestand is vereist voor de Microsoft Outlook 365-beheerder (of, bij bepaalde installatiemethoden, mogelijk een gebruiker) om invoegtoepassingen te implementeren en te installeren voor zichzelf of gebruikers in hun organisatie.Een manifestbestand maakt installatie van invoegtoepassingen mogelijk voor één Qlik Cloudtenant.

Nadat u het manifestbestand of de URL hebt verkregen, zijn er twee verschillende methoden om invoegtoepassingen te implementeren en te installeren:

• Gecentraliseerde implementatie: Gecentraliseerde implementatie, installatie en activering

• Sideloading: Invoegtoepassingen installeren met gebruik van sideloading of een netwerkshare

Ga voor meer informatie naar Rapportsjablonen ontwerpen met Qlik invoegtoepassingen voor Microsoft Office.

Systeem- en softwarevereisten

Opmerking over Qlik Cloud Government

Qlik-invoegtoepassingen voor Microsoft Office worden ondersteund voor het ontwikkelen van rapportsjablonen voor apps in Qlik Cloud Government- of Qlik Cloud Government - DoD-tenants. De invoegtoepassingen zijn alleen beschikbaar voor Office 365 Commercial.

Om Qlik invoegtoepassingen te installeren en te gebruiken, moet u voldoen aan de volgende vereisten.

Qlik-add-in voor Microsoft Excel

Voor Windows installaties:

• Windows 10 v.1903 of hoger

• Microsoft Outlook 365 v.16.0.11629 of hoger

Voor macOS installaties:

• macOS v.14 of hoger

• Microsoft Outlook 365 v.16.83 of hoger

Ook, om de Qlik-invoegtoepassing voor Microsoft Excel uit te voeren, moet u een Microsoft Excel installatie met ExcelAPI 1.9 of nieuwer hebben. Om te controleren of uw Excel-installatie compatibel is, raadpleegt u de officiële Microsoft-documentatie op Excel JavaScript API requirement sets.

Als uw ExcelAPI lager is dan de minimaal vereiste versie, wordt er een foutmelding weergegeven die aangeeft dat de Qlik-invoegtoepassing een latere versie van Microsoft Excel vereist.

Het kan zijn dat u op het witte gebied moet klikken rechts in Microsoft Excel en op F5 moet drukken om de pagina bij te werken om de foutmelding te zien.

Als u deze fout ziet, dient u uw Microsoft Excel-installatie bij te werken.

Qlik-add-in voor Microsoft PowerPoint

Voor Windows installaties:

• Windows 10 v.1903 of hoger

• Microsoft Outlook 365 versie 2504 (build 18730.20030) of hoger

Voor macOS installaties:

• macOS v.14 of hoger

• Microsoft Outlook 365 v.16.96 of hoger

Qlik-add-in voor Microsoft Word

Voor Windows installaties:

• Windows 10 v.1903 of hoger

• Microsoft Outlook 365 versie 2208 (build 15601.20148) of hoger

Voor macOS-installaties:

• macOS v.14 of hoger

• Microsoft Outlook 365 v.16.64 of hoger

Het manifest van de invoegtoepassing voorbereiden en verkrijgen

Qlik-add-ins voor Microsoft Office worden in de Microsoft-omgeving geïnstalleerd met behulp van een manifestbestand. Dit is een XML-bestand. Voor gecentraliseerde implementatie moet de Microsoft-beheerder waarschijnlijk een URL naar het manifestbestand verstrekken.

Een manifestbestand is specifiek voor één Qlik Cloudtenant. U gebruikt hetzelfde manifestbestand om de add-ins te installeren voor Excel, PowerPoint en Word.

Configuratie voor een OAuth-client is vereist om de invoegtoepassing te installeren. Nadat u de OAuth-client hebt geconfigureerd, haalt u vanuit het Beheer-activiteitencentrum de koppeling naar het manifestbestand en het manifestbestand zelf op.

Doe het volgende:

1. Maak de OAuth-client in de Qlik Cloud-tenant met de vereiste configuratie. Zie OAuth-clients maken voor Qlik-add-ins voor Microsoft Office voor volledige instructies.

2. Ga naar het Beheer-activiteitencentrum en genereer de manifestkoppeling. Voor alternatieve gebruikscenario's kunt u het manifestbestand ook rechtstreeks downloaden. Zie: Installatiemanifests beheren voor Qlik add-ins voor Microsoft Office.

OAuth-clients maken voor Qlik-add-ins voor Microsoft Office

Configuratie voor een OAuth-client is vereist om Qlik add-ins voor Microsoft Office te installeren. Add-ins worden gebruikt door rapportontwikkelaars om rapportsjablonen voor te bereiden voor in-app rapportage met Qlik Cloud.

Om OAuth te kunnen gebruiken in de add-ins, moet de OAuth-client precies zoals de hieronder getoonde configuratie worden geconfigureerd.

Doe het volgende:

1. In het Beheer-activiteitencentrum gaat u in Qlik Cloud naar OAuth.

2. Klik op Nieuwe maken.

3. Selecteer App met één pagina in het vervolgkeuzemenu Clienttype. Er worden nu meer velden weergegeven.

4. Voer een naam in. De Beschrijving is optioneel.

5. Selecteer tenminste het selectievakje op om het user_default-bereik te gebruiken. U kunt andere bereiken gebruiken in de configuratie, maar zonder user_default werkt de installatie niet.

   Zie Beschikbare OAuth-bereiken voor een volledige beschrijving van elk bereik dat beschikbaar is.

6. Voer in het veld Omleidings-URL's toevoegen de URL van uw Qlik Cloud-tenant in, gevolgd door de vaste tekenreeks: /office-add-ins/oAuthLoginSuccess.html

   Het resultaat zou er als volgt uit moeten zien: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Bijvoorbeeld: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Klik op Toevoegen.

8. Voer in het veld Toegestane oorsprongen toevoegen uw tenant-URL in en klik op Toevoegen.

9. Klik op Maken.

10. Het venster Client-id kopiëren wordt geopend. U kunt nu de Client-id naar het klembord kopiëren of u kunt u op Gereed klikken om het venster te sluiten.

Nadat u de OAuth-client hebt gemaakt, haalt u de bijgewerkte manifest XML koppeling op uit het Beheer activiteitencentrum. Ga naar de Instellingen pagina en selecteer het tabblad E-mail en rapporten. Selecteer in de sectie Delen en rapporten de Qlik add-ins voor Microsoft Office. Gebruik de opgegeven koppeling om de add-in te implementeren en te installeren.

Gecentraliseerde implementatie, installatie en activering

Het wordt aanbevolen dat Qlik-invoegtoepassingen voor Microsoft Office beschikbaar worden gesteld met gecentraliseerde implementatie en installatie. Gecentraliseerde implementatie vereist actie van een Microsoft Outlook 365-beheerder in uw organisatie.

Met gecentraliseerde implementatie wordt het manifest van de invoegtoepassing in het Microsoft Outlook 365-beheercentrum van uw organisatie geladen en als vooraf geconfigureerde installatie naar gebruikers verspreid. Distributie kan worden beperkt tot leden van specifieke veiligheidsgroepen.

In de volgende vallen dient u gecentraliseerde implementatie te gebruiken:

• Als u wilt dat de invoegtoepassing permanent wordt geïnstalleerd voor leden van uw organisatie

• Als u de distributie naar de leden binnen uw organisatie wilt beheren

Volg de proceduresecties hieronder voor de volledige workflow.

Gecentraliseerde implementatie en installatie

Gecentraliseerde implementatie wordt uitgevoerd door een Microsoft Outlook 365-systeembeheerder.

Doe het volgende:

1. Nadat u een OAuth-clien hebt gemaakt, haalt u het manifestbestand of de manifest-URL van de invoegtoepassing op. Zie: Het manifest van de invoegtoepassing voorbereiden en verkrijgen.

2. Distribueer de invoegtoepassing volgens de officiële Microsoft-documentatie: Implementeer en publiceer Office-invoegtoepassingen. De distributie door gecentraliseerde implementatie is alleen mogelijk met gebruik van het Microsoft Outlook 365-beheercentrum.

Met de bovenstaande procedure worden de invoegtoepassingen geïnstalleerd voor gebruikers die er toegang toe krijgen. Gebruikers kunnen vervolgens invoegtoepassingen activeren in hun versie van Excel, PowerPoint of Word.

Om invoegtoepassingen zonder gecentraliseerde implementatie op een desktopversie van Excel, PowerPoint of Word te installeren, kunt u een netwerkshare opzetten en het manifest er op laden. Dit kan alleen worden gedaan op een Windows-besturingssysteem.

De invoegtoepassing activeren na gecentraliseerde implementatie

Nadat een Microsoft-beheerder een Qlik add-in voor uw organisatie heeft geïnstalleerd, kunt u deze activeren en gebruiken als u er toegang toe hebt gekregen.

Afhankelijk van de versie van uw Microsoft Office applicatie, kan het zijn dat deze stappen er iets anders uitzien. Raadpleeg de officiële documentatie van Microsoft voor meer informatie.

Doe het volgende:

1. Open een desktop- of webversie van Excel, PowerPoint of Word.

2. Ga naar Start > Add-ins > Add-ins ophalen.

3. Selecteer de Qlik add-in op het tabblad BEHEERD DOOR BEHEERDER van het dialoogvenster.

Het Qlik add-inpictogram wordt toegevoegd aan uw lintbalk.

Add-ins weergeven, beheren en installeren voor Excel, PowerPoint en Word

De invoegtoepassing verwijderen

Als uw installatie gebruikmaakt van gecentraliseerde implementatie, kan het zijn dat u de invoegtoepassing niet kunt verwijderen. Dit is afhankelijk van het beleid dat door uw Microsoft Outlook 365-beheerder wordt gehanteerd.

Invoegtoepassingen installeren met gebruik van sideloading of een netwerkshare

Installatie via sideloading en netwerkshares is een geschikte manier om snel toegang te krijgen tot invoegtoepassingen voor test- of proefdoeleinden. Dit zijn geen geschikte methoden om invoegtoepassingen te implementeren voor productie en gebruikscenario's op enterprise-schaal.

Afhankelijk van uw versie van Excel, PowerPoint, of Word, evenals andere factoren, kunnen invoegtoepassingen die zijn geladen met deze methoden mogelijk uiteindelijk van uw lintbalk worden verwijderd. Als dit gebeurt, moet u het manifest opnieuw uploaden naar de Microsoft Office toepassing.

Optie 2: een add-in installeren op desktop Microsoft Office-toepassingen met een Windows-netwerkshare

Om add-ins te installeren op een desktopversie van Excel, PowerPoint of Word zonder gecentraliseerde implementatie, kunt u een netwerkshare opzetten en het manifest erin laden. Dit kan alleen worden gedaan op een Windows-besturingssysteem.

Volg de onderstaande richtlijnen om add-ins via een netwerkshare te sideloaden. De instructies worden aangepast vanuit de officiële Microsoft-documentatie. Zie Sideload Office Add-ins for testing from a network share of andere Microsoft-informatiebronnen voor meer informatie.

Stap 1: een map maken en delen

Doe het volgende:

1. Maak een map om de Qlik-invoegtoepassing te hosten. Bijvoorbeeld: C:\Qlik Office add-ins

2. Ga in de Windows Verkenner naar de bovenliggende map, of de stationsletter, van de map die u als uw gedeelde mapcatalogus wilt gebruiken. Bijvoorbeeld: C:\

3. Klik met de rechtermuisknop op de map en selecteer Eigenschappen.

4. Open het tabblad Delen en klik op de knop Delen....

   

5. Voeg op het dialoogvenster uzelf en eventuele andere gebruikers en/of groepen toe met wie u uw invoegtoepassing wilt delen. U hebt tenminste lees- en schrijfmachtiging voor de map nodig. Als u klaar bent met het kiezen van mensen met wie u wilt delen, klikt u op Delen.

6. Wanneer u bevestiging ziet dat uw map is gedeeld, maakt u een notitie van het volledige netwerkpad dat direct na de mapnaam wordt weergegeven. Klik op Klaar om het dialoogvenster te sluiten.

   

7. Klik op Sluiten om het dialoogvenster Eigenschappen te sluiten.

Stap 2: de gedeelde map handmatig als een vertrouwde catalogus configureren

Doe het volgende:

1. Open een nieuwe, lege werkmap in de desktopversie van Excel, PowerPoint of Word.

2. Klik op het tabblad Bestand en vervolgens linksonder aan de pagina op Opties.

3. Klik op Vertrouwenscentrum en vervolgens op de knop Instellingen vertrouwenscentrum....

   

4. Klik op Vertrouwde invoegtoepassing-catalogi.

   

5. Voer in het vak Catalogus-url het volledige netwerkpad in in de map die u eerder hebt gedeeld.

6. Klik op Catalogus toevoegen.

7. Schakel het selectievakje Tonen in menu voor het onlangs toegevoegde item en klik vervolgens op OK om het dialoogvenster Vertrouwenscentrum te sluiten.

   

8. Klik op OK om het dialoogvenster te sluiten.

9. Sluit de toepassing en open deze opnieuw zodat uw wijzigingen van kracht worden.

Stap 3: de invoegtoepassing sideloaden

Doe het volgende:

1. Voeg het XML-manifestbestand voor de invoegtoepassing toe aan de gedeelde map.

2. Klik in ExcelPowerPoint of Word op Invoegtoepassingen op het tabblad Start van het lint.

3. Klik op Meer invoegtoepassingen.

4. Klik bovenaan in het dialoogvenster Office-invoegtoepassingen op GEDEELDE MAP.

5. Selecteer Qlik om de invoegtoepassing in te voegen.

6. Het kan zijn dat er een dialoogvenster wordt weergegeven met iets in de trant van: Qlik wil een nieuw venster weergeven. Klik op Toestaan.

Een invoegtoepassing die via een netwerkshare is geïnstalleerd verwijderen

Doe het volgende:

1. Als Excel, PowerPoint of Word is geopend, moet u dit sluiten.

2. Verwijder de inhoud van deze map: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Optie 3: Een invoegtoepassing sideloaden op desktop macOS toepassingen

In het geval van macOS kunnen invoegtoepassingen worden geïnstalleerd op Microsoft Outlook 365 desktopversies van Excel, PowerPoint of Word. Voor de systeem- en softwarevereisten raadpleegt u Systeem- en softwarevereisten.

Volg de onderstaande richtlijnen. De instructies worden aangepast vanuit de officiële Microsoft-documentatie. Voor de volledige instructies raadpleegt u de officiële Microsoft-documentatie: Sideload an add-in in Office on Mac

Doe het volgende:

1. Open de Verkenner applicatie op uw computer.

2. Voer de volgende toetsenbordcombinatie in: Command+Shift+G

   Het menu Ga naar map wordt geopend.

3. Voer een van de volgende paden in, afhankelijk van de Microsoft Office toepassing:

   • 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

   Het is mogelijk dat de wef-map nog niet aanwezig is op uw computer. Als dit het geval is, moet de map in deze locatie aanmaken.

4. In de wef-map voegt u een kopie van het XML-manifestbestand toe.

5. Open Excel, PowerPoint of Word. Als u dit al hebt geopend, moet u het programma opnieuw opstarten.

6. Navigeer in de lintbalk naar Start > Invoegtoepassingen.

7. Selecteer de Qlik-invoegtoepassing.

De Qlik-invoegtoepassing zou nu beschikbaar moeten zijn in uw lint.

Een sideloaded invoegtoepassing verwijderen van desktop macOS apps

Om de Qlik-invoegtoepassing te verwijderen, moet u de Office-cache op uw computer wissen. Ga voor meer informatie naar:

• Een met sideloading toegevoegde invoegtoepassing verwijderen

• De Office-cache wissen

Problemen oplossen

In deze sectie vindt u tips voor het oplossen van algemene problemen bij de implementatie en installatie.

Zie Probleemoplossing - In-app rapportage voor aanvullende tips voor probleemoplossing.

Leeg dialoogvenster getoond tijdens de authenticatie na de implementatie van een Qlik add-in voor Microsoft Office

Als een gebruiker probeert te verifiëren naar een rapportage-add-in voor Microsoft Excel, Microsoft PowerPoint of Microsoft Word, is het pop-upvenster van de authenticatie mogelijk leeg. In plaats daarvan wordt er mogelijk een fout in het dialoogvenster getoond (met name 12006).

Als een gebruiker wil werken met een Qlik add-in voor Microsoft Office, moet de authenticatiestroom u omleiden tussen uw tenant en de identiteitsprovider die wordt gehost in een ander domein. Uw identiteitsprovider stelt een Cross-Origin-Opener-Policy in met beperkte instellingen. Het interdomein-communicatiedeel van de authenticatiestroom is geblokkeerd om te voorkomen dat aanmeldgegevens correct teruggestuurd worden naar de add-in.

Voorgestelde actie  

De volgende resolutie moet worden uitgevoerd door een netwerkbeheerder die verantwoordelijk is voor het instellen van identiteitsproviders.

Doe het volgende:

• Stel de responsheader van uw IDP naar uw dialoogvenster in op:

  Cross-Origin-Opener-Policy: unsafe-none

Raadpleeg de officiële Microsoft-documentatie voor meer informatie: Aanbevolen procedures en regels voor de Office Dialog API