Distribuera och installera Qlik-tillägg för Microsoft Office

Distribuera och installera Qlik-tillägg för Microsoft Office så att användare i din organisation kan skapa rapportmallar. Ladda upp rapportmallar som skapats med tilläggen till Qlik Cloud-appen för att generera rapportutdata från rapportuppgifter.

Qlik-tillägg för Microsoft Office kan distribueras och installeras på kompatibla webb- och skrivbordsversioner av Excel, PowerPoint och Word i Microsoft 365.

Tillägg installeras med en manifestfil. Den här manifestfilen krävs för att Microsoft 365-administratören (eller eventuellt en användare, för vissa installationsmetoder) ska kunna distribuera och installera tillägg för sig själva eller användare i deras organisation.En manifestfil möjliggör installation av tillägg för en enstaka Qlik Cloudklientorganisation.

När du har skaffat manifestfilen eller URL:en finns det två olika metoder för att distribuera och installera tillägg:

• Centraliserad distribution: Centraliserad distribution, installation och aktivering

• Sidoladdning: Installera tillägg med sidoladdning eller nätverksdelning

Mer information finns i Designa rapportmallar med Qlik-tillägg för Microsoft Office.

System- och programvarukrav

Information om Qlik Cloud Government

Qlik tillägg för Microsoft Office stöds för att utveckla rapportmallar mot appar i Qlik Cloud Government eller Qlik Cloud Government - DoD klientorganisationer. Tilläggen är endast tillgängliga för Office 365 Commercial.

För att installera och använda Qlik-tillägg måste följande krav vara uppfyllda.

Qlik-tillägget för Microsoft Excel

För Windows installationer:

• Windows 10 v.1903 eller högre

• Microsoft 365 v.16.0.11629 eller högre

För macOS installationer:

• macOS v.14 eller högre

• Microsoft 365 v.16.83 eller högre

Dessutom, för att köra Qlik-tillägget för Microsoft Excel, måste du ha en Microsoft Excel installation med ExcelAPI 1.9 eller nyare. För att kontrollera om din Excel-installation är kompatibel kontrollerar du i den officiella Microsoft-dokumentationen på kravspecifikation för Excel JavaScript API.

Om din ExcelAPI är lägre än den minsta nödvändiga versionen visas ett fel som anger att det krävs en nyare version av Microsoft Excel för Qlik-tillägget.

Du kan behöva klicka på hela det vita området till höger i Microsoft Excel och trycka på F5 för att uppdatera sidan för att se felet.

Om du ser det här felet ska du uppgradera din Microsoft Excel-installation.

Qlik-tillägget för Microsoft PowerPoint

För Windows installationer:

• Windows 10 v.1903 eller högre

• Microsoft 365 version 2504 (build 18730.20030) eller senare

För macOS installationer:

• macOS v.14 eller högre

• Microsoft 365 v.16.96 eller högre

Qlik-tillägget för Microsoft Word

För Windows installationer:

• Windows 10 v.1903 eller högre

• Microsoft 365 version 2208 (build 15601.20148) eller senare

För macOS installationer:

• macOS v.14 eller högre

• Microsoft 365 v.16.64 eller högre

Förbereda och skaffa tilläggsmanifestet

Qlik-tillägg för Microsoft Office installeras i Microsoft-miljön med en manifestfil. Detta är en XML-fil. Vid centraliserad distribution kommer antagligen Microsoft-administratören att behöva tillhandahålla en URL till manifestfilen.

En manifestfil är specifik för en viss Qlik Cloudklientorganisation. Du använder samma manifestfil för att installera tilläggen för Excel, PowerPoint och Word.

En OAuth-klientkonfigurering krävs för att installera tillägget. När du har konfigurerat OAuth-klienten hämtar du länken till manifestfilen och själva manifestfilen från aktivitetscentret för Administration.

Gör följande:

1. Skapa OAuth-klienten i Qlik Cloud-klientorganisationen med den nödvändiga konfigurationen. Fullständiga instruktioner finns i Skapa OAuth-klienter för Qlik-tillägg för Microsoft Office.

2. Navigera till aktivitetscentret för Administration och generera manifestlänken. Du kan också hämta manifestfilen direkt för alternativa användningsfall. Se Hantera installationsmanifest till Qlik-tillägg för Microsoft Office.

Skapa OAuth-klienter för Qlik-tillägg för Microsoft Office

En OAuth-klientkonfigurering krävs för att installera Qlik tillägg för Microsoft Office. Tillägg används av rapportutvecklare för att förbereda rapportmallar för rapportering i appen med Qlik Cloud.

För att OAuth ska fungera i tilläggen måste OAuth-klienten konfigureras med exakt den konfiguration som visas nedan.

Gör följande:

1. Gå till OAuth i aktivitetscentret för Administration i Qlik Cloud, .

2. Klicka på Skapa ny.

3. I rullgardinsmenyn Klienttyp väljer du App med en sida. Fler fält kommer att visas.

4. Sätt in ett Namn. Beskrivning är valfritt.

5. Som minimum måste du välja kryssrutan som inkluderar user_default-omfattningen. Du kan inkludera andra omfattningar i konfigurationen, men utan user_default kommer inte installationen att fungera.

   Se Tillgängliga OAuth-omfattningar för en fullständig beskrivning av varje tillgänglig omfattning.

6. I fältet Lägg till omdirigerings-URL anger du URL:en för Qlik Cloud klientorganisationen, följt av den här fasta strängen: /office-add-ins/oAuthLoginSuccess.html

   Resultatet ska se ut så här: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Till exempel: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Klicka på Lägg till.

8. I fältet Lägg till tillåtna ursprung anger du URL:en till din klientorganisation och klickar på Lägg till.

9. Klicka på Skapa.

10. Fönstret Kopiera ditt Klient-ID visas. Du kan välja att kopiera klient-ID till urklipp eller klicka på Klar för att stänga fönstret.

När du har skapat OAuth-klienten hämtar du den uppdaterade XML-manifestlänken från Administration aktivitetscentret. Gå till sidan Inställningar och välj fliken E-post och rapporter. I delavsnittet Delning och rapporter väljer du Qlik tillägg för Microsoft Office. Använd den angivna länken för att distribuera och installera tillägget.

Centraliserad distribution, installation och aktivering

Vi rekommenderar att Qlik-tillägg för Microsoft Office görs tillgängliga genom centraliserad distribution och installation. Vid centraliserad distribution krävs åtgärder från en Microsoft 365-administratör i din organisation.

Vid centraliserad distribution laddas tilläggsmanifestet till din organisations Microsoft 365-admincenter och distribueras till användare som en förkonfigurerad installation. Distributionen kan begränsas till medlemmar i specifika säkerhetsgrupper.

Du ska använda centraliserad distribution när:

• Du vill att tillägget ska installeras permanent för medlemmar i din organisation.

• Du vill hantera distribution till din medlemmarna i din organisation

Följ proceduravsnitten nedan för att se det fullständiga arbetsflödet.

Centraliserad distribution och installation

Centraliserad distribution slutförs av en Microsoft 365-systemadministratör.

Gör följande:

1. Skaffa manifestfilen eller manifest-URL:en för tillägget när du har skapat en OAuth-klient. Se Förbereda och skaffa tilläggsmanifestet.

2. Distribuera tillägget enligt den officiella Microsoft-dokumentationen: distribuera och publicera Office-tillägg. Lägg märke till att distribution via centraliserad distribution bara är möjlig genom att använda Microsoft 365-admincentret.

Med den ovanstående proceduren installeras tilläggen för användare som får åtkomst till dem. Användare aktiverar sedan tilläggen i sin version av Excel, PowerPoint eller Word.

För att installera tillägg på en skrivbordsversion av Excel, PowerPoint eller Word utan central distribution kan du konfigurera en nätverksdelning och läsa in manifestet i den. Detta kan bara göras på ett Windows-operativsystem.

Aktivera ett tillägg efter centraliserad distribution

När en Microsoft-administratör har installerat Qlik-tillägget för din organisation kan du aktivera och använda det om du har fått tillgång till det.

Beroende på din version av Microsoft Office kan de här stegen skilja sig åt något. Se den officiella Microsoft-dokumentationen för fullständig information.

Gör följande:

1. Öppna en skrivbords- eller webbversion av Excel, PowerPoint, eller Word.

2. Gå till Startsida > Tillägg > Hämta tillägg.

3. Välj tillägget Qlik i fliken ADMINHANTERAD på dialogrutan.

Tilläggsikonen för Qlik läggs till i ditt menyfliksområde.

Visa, hantera och installera tillägg för Excel, PowerPoint och Word

Ta bort ett tillägg

Om din installation använder en centraliserad distribution kanske du inte kan avinstallera tillägget. Detta beror på vilken policy din Microsoft 365-administratör använder.

Installera tillägg med sidoladdning eller nätverksdelning

Installation via sidoladdning eller nätverksdelning är lämpliga sätt att snabbt få tillgång till tillägg i test- eller utvärderingssyfte. Det är inte lämpliga metoder för att distribuera tillägg för användningsfall i produktions- eller företagsskala.

Beroende på din version av Excel, PowerPoint eller Word, samt andra faktorer, kan tillägg som laddats med dessa metoder så småningom tas bort från menyfliksområdet. När detta händer laddar du upp manifestet igen till Microsoft Office-applikationen.

Alternativ 2: Installera ett tillägg på skrivbordsapplikationer för Microsoft Office med en Windows-nätverksdelning

För att installera tillägg på en skrivbordsversion av Excel, PowerPoint eller Word utan central distribution kan du konfigurera en nätverksdelning och läsa in manifestet i den. Detta kan bara göras på ett Windows-operativsystem.

Följ riktlinjerna nedan för att sidoladda tillägg via nätverksdelning. Instruktionerna är anpassade efter den officiella Microsoft-dokumentationen. Se Sidoladda Office-tillägg för testning från en nätverksdelning eller andra Microsoft-resurser för mer information.

Steg 1: skapa och dela en mapp

Gör följande:

1. Skapa en mapp som värd för Qlik-tillägget. Till exempel: C:\Qlik Office-tillägg

2. I Windows-utforskaren går du till den överordnade mappen, eller till drivenhetsbokstaven, eller till den mapp du vill använda som din delade mapp. Till exempel: C:\

3. Högerklicka på mappen och välj Egenskaper.

4. Öppna fliken Delning och klicka sedan på Dela...-knappen.

   

5. I dialogfönstret lägger du till dig själv och alla andra användare och/eller grupper som du vill dela ditt tillägg med. Du kommer minst att behöva läs/skriv-behörighet till mappen. När du är klar med att välja personer att dela med klickar du på Dela.

6. När du ser bekräftelsen att din mapp har delat ska du anteckna den fullständiga nätverkssökvägen som visas omedelbart efter mappnamnet. Välj Klar för att stänga dialogfönstret.

   

7. Välj Stäng för att stänga dialogfönstret Egenskaper.

Steg 2: konfigurera den delade mappen som betrodd katalog manuellt

Gör följande:

1. Öppna en ny tom arbetsbok i skrivbordsversionen av Excel, PowerPoint eller Word.

2. Klicka på fliken Arkiv och klicka sedan på Alternativ längst ner i vänstra hörnet.

3. Klicka på Ansvarscenter och klicka sedan på Inställningar för ansvarscenter....

   

4. Klicka på Betrodda tilläggskataloger.

   

5. I rutan Katalog-URL anger du den fullständiga nätverkssökvägen till den mapp som du tidigare delade.

6. Klicka på Lägg till katalog.

7. Markera kryssrutan Visa i meny för elementet som just skapades och klicka sedan på OK för att stänga dialogfönstret i Ansvarscentret.

   

8. Välj OK för att stänga dialogfönstret.

9. Stäng och öppna applikationen igen för att dina ändringar ska börja gälla.

Steg 3: sidoladda tillägget

Gör följande:

1. Lägg till XML-manifestfilen i den delade mappen.

2. I ExcelPowerPoint eller Word klickar du på Tillägg på fliken Start på menyfliken.

3. Klicka på Fler tillägg.

4. Klicka på DELAD MAPP högst upp i Office-tillägg-dialogrutan.

5. Välj Qlik för att infoga tillägget.

6. Du kanske ser en dialogruta som säger något i stil med följande: Qlik vill visa ett nytt fönster. Klicka på Tillåt.

Ta bort ett tillägg som installerats via nätverksdelning

Gör följande:

1. Om du har Excel, PowerPoint eller Word öppet, stäng det.

2. Ta bort innehållet i denna mapp: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Alternativ 3: Sideladda ett tillägg på skrivbordsmacOSappar

För macOS kan tillägg installeras på Microsoft 365 skrivbordsversioner av Excel, PowerPoint eller Word. Information om system- och programvarukrav finns i System- och programvarukrav.

Följ riktlinjerna nedan. Instruktionerna är anpassade efter den officiella Microsoft-dokumentationen. Fullständiga instruktioner finns den officiella Microsoft-dokumentationen: Sidoladda ett tillägg i Office på Mac

Gör följande:

1. Öppna programmet Finder på din dator.

2. Skriv in följande tangentbordskombination: Command+Shift+G

   Menyn Gå till mapp öppnas.

3. Ange en av följande sökvägar beroende på Microsoft Office-appen:

   • 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

   Det kan hända att wef-mappen inte finns på din dator ännu. Om så är fallet skapar du den på den här platsen.

4. I wef-mappen lägger du till en kopia av XML-manifestfilen.

5. Öppna Excel, PowerPoint, eller Word. Om du redan har den öppen måste du starta om den.

6. I menyfliksområdet går du till Hem > Tillägg.

7. Välj Qlik-tillägget.

Qlik-tillägget ska nu vara tillgängligt i ditt menyfliksområde.

Ta bort ett sidoladdat tillägg från skrivbords macOS applikationer

För att ta bort Qlik-tillägget måste du radera Office-cacheminnet på din dator. Mer information finns här:

• Ta bort ett sidoladdat tillägg

• Rensa Office-cacheminnet

Felsökning

I det här avsnittet finns tips för att åtgärda vanliga problem vid distribution och installation.

Ytterligare felsökningstips finns i Felsökning – rapportering i appen.

Tom dialogruta visas under autentisering efter distribution av ett Qlik-tillägg för Microsoft Office

När en användare försöker autentisera sig för ett rapporteringstillägg för Microsoft Excel, Microsoft PowerPoint eller Microsoft Word, kan deras autentiserings-popup-dialogruta vara tom. Alternativt kan användaren istället se ett fel i dialogrutan (särskilt 12006).

För att en användare ska kunna arbeta med ett Qlik tillägg för Microsoft Office kräver autentiseringsflödet en omdirigering mellan din klientorganisation och identitetsleverantören som finns i en annan domän. Din identitetsleverantör ställer in en Cross-Origin-Opener-Policy med restriktiva inställningar. Följden blir att den domänövergripande kommunikationsdelen av autentiseringsflödet blockeras, vilket förhindrar att inloggningsinformation returneras korrekt till tillägget.

Föreslagen åtgärd  

Följande lösning ska utföras av en nätverksadministratör som ansvarar för att konfigurera identitetsleverantörer.

Gör följande:

• Ställ in svarshuvudet från din IDP till din dialog till:

  Cross-Origin-Opener-Policy: unsafe-none

Mer information finns i den officiella Microsoft-dokumentationen: Bästa praxis och regler för Office Dialog API