De Qlik-add-in voor Microsoft Excel implementeren en installeren

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

De Qlik Excel-add-in kan voor compatibele web- en desktopversie van Microsoft Excel in Microsoft Outlook 365 worden geïmplementeerd en geïnstalleerd. Om de add-in te gebruiken met desktopversies van Excel in Microsoft Outlook 365 moet u een Windows-besturingssysteem gebruiken.

De add-in wordt 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 de add-in voor zichzelf of gebruikers in hun organisatie te installeren. Een manifestbestand maakt installatie van de add-in voor één Qlik Cloud tenant mogelijk.

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

• Gecentraliseerde implementatie: Gecentraliseerde implementatie, installatie en activering

• Sideloading: De add-in installeren met gebruik van sideloading of een netwerkshare

Microsoft Excel versievereisten

Om de Qlik Excel-add-in uit te voeren, moet u een Microsoft Excel-installatie met ExcelAPI 1.9 of later 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-add-in 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.

Het add-in-manifest voorbereiden en verkrijgen

De Qlik Excel-add-in wordt 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 Cloud tenant.

Configuratie voor een OAuth-client is vereist om de add-in te installeren. Nadat u de OAuth-client hebt geconfigureerd, haalt u vanuit de Qlik Cloud Beheerconsole 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 Een OAuth-client maken voor de Qlik-add-in voor Microsoft Excel voor volledige instructies.

2. Ga naar de Beheerconsole en genereer de manifestkoppeling. Voor alternatieve gebruikscases kunt u het manifestbestand ook rechtstreeks downloaden. Zie: Installatiemanifests beheren voor de Qlik-add-in voor Microsoft Excel.

Een OAuth-client maken voor de Qlik-add-in voor Microsoft Excel

Configuratie voor een OAuth-client is vereist om de Qlik-add-in voor Microsoft Excel te installeren. De add-in wordt gebruikt door rapportontwikkelaars om rapportsjablonen op te zetten die de uitvoer van rapporten in tabelvorm vanuit de Qlik Sense-app regelen.

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

Doe het volgende:

1. Ga in de Beheerconsole 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 Een OAuth-client maken voor een volledige beschrijving van elk bereik dat beschikbaar is.

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

   Het resultaat zou er als volgt uit moeten zien: https://YourServer/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, kunt u de koppeling naar het bijgewerkte XML-manifestbestand ophalen in de Beheerconsole. Ga naar de pagina Instellingen en navigeer naar Delen en rapporten > Excel-invoegtoepassing binnen de Beheerconsole. Gebruik deze koppeling om de add-in te installeren in te implementeren.

Gecentraliseerde implementatie, installatie en activering

Het wordt aanbevolen dat de Qlik-add-in beschikbaar wordt gesteld met gecentraliseerde implementatie en installatie. Gecentraliseerde implementatie vereist de tussenkomst van een Microsoft Outlook 365-beheerder in uw organisatie.

Met gecentraliseerde implementatie wordt het add-in-manifest 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 add-in 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 add-in op. Zie: Het add-in-manifest voorbereiden en verkrijgen.

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

Met de bovenstaande procedure wordt de add-in geïnstalleerd voor gebruikers die er toegang toe krijgen. Gebruikers kunnen de add-in vervolgens in hun Microsoft Excel-versie activeren.

De add-in activeren na gecentraliseerde implementatie

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

Afhankelijk van uw versie van Microsoft Excel, 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 de desktop- of webversie van Excel.

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 voor Microsoft Outlook 365-programma's weergeven, beheren en installeren

De add-in verwijderen

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

De add-in installeren met gebruik van sideloading of een netwerkshare

Installatie via sideloading en netwerkshares is een geschikte manier om snel toegang te krijgen tot de add-in voor testdoeleinden. Dit zijn geen geschikte methoden om de add-in te implementeren voor productie en gebruikscases op enterprise-schaal.

Bij beide methoden wordt de add-in maximaal 48 uur in uw persoonlijke omgeving bewaard. Na 48 uur moet u het manifest opnieuw uploaden Lees de instructies hieronder voor de methode die u wilt gebruiken.

Optie 1: de add-in naar internet sideloaden

Om de add-in met Excel 365 op internet te sideloaden, uploadt de gebruiker het manifestbestand naar zijn/haar browser.

Sideloading wordt ondersteund door webversies van Excel van Microsoft Outlook 365.

Gebruik sideloading in de volgende situaties:

• U hebt snel toegang nodig tot de add-in.

• U wilt de functionaliteit van de add-in geïsoleerd testen.

• U wilt de add-in testen zonder tussenkomst van een Microsoft Outlook 365-beheerder.

Doe het volgende:

1. Bereid het manifestbestand voor en download het. Zie: Het add-in-manifest voorbereiden en verkrijgen.

2. Open Microsoft Office online op https://office.live.com/.

3. Open een nieuw Excel document.

4. Open het tabblad Invoegen op de lintbalk en kies Office-add-ins in de sectie Add-ins.

5. Selecteer in het dialoogvenster Office-add-ins het tabblad MIJN ADD-INS, kies Mijn add-ins beheren en selecteer vervolgens Mijn add-in uploaden.

6. Brader naar het manifestbestand van de add-in en selecteer Uploaden.

7. Meld u indien nodig aan bij uw Qlik Cloud-account.

Een met sideloading toegevoegd add-in verwijderen

Om de met sideloading toevoegde add-in te verwijderen, wist u de cache uit de webbrowser waarmee u de add-in gebruikt.

Optie 2: de add-in op desktopversies van Excel met een Windows-netwerkshare installeren

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

Volg de onderstaande richtlijnen om de add-in 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-add-in te hosten. Bijvoorbeeld: C:\Qlik Excel add-in

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 add-in 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. 1. Open een nieuwe, lege werkmap in de desktopversie van Excel.

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 add-in-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 Excel en open het weer om de wijzigingen toe te passen.

Stap 3: de add-in sideloaden

Doe het volgende:

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

2. Klik in Excel op Mijn add-ins op het tabblad Invoegen van het lint.

3. Klik bovenaan in het dialoogvenster Office-add-ins op GEDEELDE MAP.

4. Selecteer Qlik om de add-in in te voegen.

5. 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 add-in die via een netwerkshare is geïnstalleerd verwijderen

Om een sideloaded add-in te verwijderen, verwijdert u de inhoud van deze map: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Als uw installatie gebruikmaakt van gecentraliseerde implementatie, kan het zijn dat u de add-in niet kunt verwijderen. Dit is afhankelijk van het beleid dat door uw systeembeheerder wordt gehanteerd.

Meerdere Qlik-add-ins toevoegen aan Microsoft Excel

Iedere Qlik-add-in die wordt toegevoegd, staat het gebruik van de add-in voor één Qlik Cloud tenant toe. Om met meerdere tenants te werken, moet u het add-in-manifest voor iedere, afzonderlijke tenant implementeren.

Afhankelijk van uw versie van Microsoft Excel en de browser die u gebruikt, kan het zijn dat als er meerdere add-ins worden geladen, de lintbalk voor elke add-in pictogrammen toont of maar één pictogram met de meest recent geïmplementeerde instantie.

Als u met verschillende versies van de add-in werkt die zijn verbonden met verschillende tenants en als de specifieke tenant waarmee u verbinding wilt maken, niet wordt weergegeven in de linktbalk, herhaalt u de installatieprocedure voor die specifieke tenant en vernieuwt u de browserpagina.