Implementeren en installeren van Qlik-invoegtoepassingen voor Microsoft Office

Implementeer en installeer Qlik-invoegtoepassingen voor Microsoft Office zodat gebruikers in uw organisatie rapportsjablonen kunnen maken. Upload rapportsjablonen die met de invoegtoepassingen zijn gemaakt naar de Qlik Cloud-applicatie om rapportuitvoer te genereren vanuit rapporttaken.

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

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

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 behulp van sideloading of netwerkdeling

Zie Rapportsjablonen ontwerpen met Qlik invoegtoepassingen voor Microsoft Office voor meer informatie.

Het manifest van de invoegtoepassing voorbereiden en verkrijgen

U installeert Qlik-invoegtoepassingen voor Microsoft Office in de Microsoft-omgeving met behulp van een manifestbestand. Dit is een XML-bestand. Voor een gecentraliseerde implementatie moet waarschijnlijk een URL naar het manifestbestand worden verstrekt door de Microsoft-beheerder.

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

Een OAuth-clientconfiguratie is vereist om de invoegtoepassing te installeren. Nadat u de OAuth-client hebt geconfigureerd, haalt u de koppeling naar het manifestbestand, evenals het manifestbestand zelf, op in het Beheer-activiteitencentrum.

Doe het volgende:

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

2. Navigeer naar het Beheer-activiteitencentrum en genereer de manifestkoppeling. U kunt het manifestbestand ook rechtstreeks downloaden voor alternatieve gebruiksscenario's. Zie Installatiemanifesten beheren voor Qlik-invoegtoepassingen voor Microsoft Office.

OAuth-clients maken voor Qlik-invoegtoepassingen 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-applicatie 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-scopes 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 om Qlik-invoegtoepassingen voor Microsoft Office beschikbaar te maken via gecentraliseerde implementatie en installatie. Gecentraliseerde implementatie vereist actie van een Microsoft Outlook 365-beheerder in uw organisatie.

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

U moet gecentraliseerde implementatie gebruiken wanneer:

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

• U de distributie naar leden van uw organisatie wilt beheren

Volg de onderstaande procedurele secties voor de volledige workflow.

Gecentraliseerde implementatie en installatie

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

Doe het volgende:

1. Verkrijg het manifestbestand van de invoegtoepassing of de manifest-URL na het maken van een OAuth-client. Zie Het manifest van de invoegtoepassing voorbereiden en verkrijgen.

2. Distribueer de invoegtoepassing volgens de officiële Microsoft-documentatie: Deploy and publish Office Add-ins. Houd er rekening mee dat distributie via gecentraliseerde implementatie alleen mogelijk is met behulp van het Microsoft Outlook 365-beheercentrum.

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

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

Een 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

Een invoegtoepassing verwijderen

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

Invoegtoepassingen installeren met behulp van sideloading of netwerkdeling

Sideloading en installatie via een netwerkshare zijn geschikte manieren om snel toegang te krijgen tot invoegtoepassingen voor test- of proefdoeleinden. Het zijn geen geschikte methoden voor het implementeren van invoegtoepassingen voor productie- en enterprise-schaal gebruiksscenario's.

Afhankelijk van uw versie van Excel, PowerPoint of Word, evenals andere factoren, kunnen invoegtoepassingen die met deze methoden zijn geladen, uiteindelijk uit uw lint worden verwijderd. Wanneer dit gebeurt, uploadt u het manifest opnieuw in de Microsoft Office-applicatie.

Optie 2: Een invoegtoepassing installeren op desktop-Microsoft Office-applicaties met behulp van een Windows-netwerkshare

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

Volg de onderstaande richtlijnen om invoegtoepassingen te sideloaden via een netwerkshare. De instructies zijn aangepast van de officiële Microsoft-documentatie. Zie Sideload Office Add-ins for testing from a network share of andere Microsoft-bronnen 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 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 vervolgens op de knop Delen....

   

5. Voeg in het dialoogvenster uzelf en eventuele andere gebruikers en/of groepen toe met wie u uw invoegtoepassing wilt delen. U hebt minimaal lees-/schrijfrechten voor de map nodig. Nadat u klaar bent met het kiezen van personen om mee te delen, klikt u op Delen.

6. Wanneer u de bevestiging ziet dat uw map is gedeeld, noteert u het volledige netwerkpad dat direct na de mapnaam wordt weergegeven. Klik op Gereed om het dialoogvenster te sluiten.

   

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

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

Doe het volgende:

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

2. Klik op het tabblad Bestand en klik vervolgens op Opties in de linkerbenedenhoek.

3. Klik op Vertrouwenscentrum en klik vervolgens op de knop Instellingen voor het Vertrouwenscentrum....

   

4. Klik op Vertrouwde invoegtoepassingscatalogi.

   

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

6. Klik op Catalogus toevoegen.

7. Schakel het selectievakje Weergeven in menu in voor het nieuw 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 applicatie en open deze opnieuw zodat uw wijzigingen van kracht worden.

Stap 3: De invoegtoepassing sideloaden

Doe het volgende:

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

2. Klik in Excel, PowerPoint of Word op Invoegtoepassingen op het tabblad Start van het lint.

3. Klik op Meer invoegtoepassingen.

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

5. Selecteer Qlik om de invoegtoepassing in te voegen.

6. Mogelijk ziet u een dialoogvenster met een tekst als de volgende: Qlik wil een nieuw venster weergeven. Klik op Toestaan.

Een invoegtoepassing verwijderen die is geïnstalleerd via een netwerkshare

Doe het volgende:

1. Als u Excel, PowerPoint of Word open hebt staan, sluit u deze.

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

Optie 3: Een invoegtoepassing sideloaden op desktop-macOS-applicaties

Voor macOS kunnen invoegtoepassingen worden geïnstalleerd op Microsoft Outlook 365-desktopversies van Excel, PowerPoint of Word. Zie Systeem- en softwarevereisten voor de systeem- en softwarevereisten.

Volg de onderstaande richtlijnen. De instructies zijn aangepast van de officiële Microsoft-documentatie. Raadpleeg de officiële Microsoft-documentatie voor volledige instructies: Sideload an add-in in Office on Mac

Doe het volgende:

1. Open de Finder-applicatie op uw computer.

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

   Het menu Ga naar map wordt geopend.

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

   • 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 kan gebeuren dat de map wef nog niet op uw computer bestaat. Als dat zo is, maakt u deze op deze locatie aan.

4. Voeg in de map wef een kopie toe van het XML-manifestbestand.

5. Open Excel, PowerPoint of Word. Als u deze al open hebt staan, moet u deze opnieuw opstarten.

6. Navigeer in het lint naar Start > Invoegtoepassingen.

7. Selecteer de Qlik-invoegtoepassing.

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

Een gesideloadde invoegtoepassing verwijderen uit desktop-macOS-applicaties

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

• Remove a sideloaded add-in

• Clear the Office cache

Problemen oplossen

Deze sectie biedt tips voor het oplossen van veelvoorkomende implementatie- en installatieproblemen.

Zie Probleemoplossing - In-applicatie rapportage voor aanvullende tips voor het oplossen van problemen.

Leeg dialoogvenster weergegeven tijdens authenticatie na implementatie van een Qlik-invoegtoepassing 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