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

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

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

Tillägg installeras med hjälp av en manifestfil. Denna manifestfil krävs för att Microsoft 365-administratören (eller eventuellt en användare, i vissa installationsmetoder) ska kunna distribuera och installera tillägg för sig själva eller användare i sin organisation. En manifestfil tillåter installation av tillägg för en enda Qlik Cloud-klientorganisation.

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

• Centraliserad distribution: Centraliserad distribution, installation och aktivering

• Sideloading: Installera tillägg med hjälp av sideloading eller nätverksdelning

För mer information, se Designa rapportmallar med Qlik-tillägg för Microsoft Office.

Förbereda och hämta tilläggsmanifestet

Du installerar Qlik-tillägg för Microsoft Office i Microsoft-miljön med hjälp av en manifestfil. Detta är en XML-fil. För en centraliserad distribution kommer en URL till manifestfilen troligen att behöva tillhandahållas av Microsoft-administratören.

En manifestfil är specifik för en enda Qlik Cloud-klientorganisation. Du använder samma manifestfil för att installera tilläggen för Excel, PowerPoint och Word.

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

Gör följande:

1. Skapa OAuth-klienten i Qlik Cloud-klientorganisationen med den konfiguration som krävs. För fullständiga instruktioner, se Skapa OAuth-klienter för Qlik-tillägg för Microsoft Office.

2. Navigera till aktivitetscentret Administration och generera manifestlänken. Du kan också hämta manifestfilen direkt för alternativa användningsfall. Se Hantera installationsmanifest för 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 applikationen 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

Det rekommenderas att Qlik-tillägg för Microsoft Office görs tillgängliga med centraliserad distribution och installation. Centraliserad distribution kräver åtgärder från en Microsoft 365-administratör i din organisation.

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

Du bör använda centraliserad distribution när:

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

• Du vill hantera distributionen till dina organisationsmedlemmar

Följ proceduravsnitten nedan för hela arbetsflödet.

Centraliserad distribution och installation

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

Gör följande:

1. Hämta tilläggsmanifestfilen eller manifest-URL:en efter att du har skapat en OAuth-klient. Se Förbereda och hämta tilläggsmanifestet.

2. Distribuera tillägget enligt den officiella Microsoft-dokumentationen: Deploy and publish Office Add-ins. Observera att distribution genom centraliserad distribution endast är möjlig genom att använda Microsoft 365-administrationscentret.

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

För att installera tillägg på en skrivbordsversion av Excel, PowerPoint eller Word utan centraliserad distribution kan du konfigurera en nätverksresurs och ladda in manifestet i den. Detta kan endast 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å den policy som används av din Microsoft 365-administratör.

Installera tillägg med hjälp av sideloading eller nätverksdelning

Sideloading och installation via nätverksresurs är lämpliga sätt att snabbt få åtkomst till tillägg för test- eller utvärderingsändamål. De är inte lämpliga metoder för att distribuera tillägg för produktion och användningsfall i 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 ditt menyfliksområde. När detta händer laddar du upp manifestet igen i Microsoft Office-applikationen.

Alternativ 2: Installera ett tillägg på Microsoft Office-skrivbordsapplikationer med hjälp av en Windows-nätverksresurs

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

Följ riktlinjerna nedan för att sideloada tillägg via nätverksresurs. Instruktionerna är anpassade från den officiella Microsoft-dokumentationen. Se Sideload Office Add-ins for testing from a network share eller andra Microsoft-resurser för mer information.

Steg 1: Skapa och dela en mapp

Gör följande:

1. Skapa en mapp för att vara värd för Qlik-tillägget. Till exempel: C:\Qlik Office add-ins

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

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

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

   

5. I dialogfönstret lägger du till dig själv och eventuella andra användare och/eller grupper som du vill dela ditt tillägg med. Du behöver minst läs-/skrivbehörighet till mappen. När du har valt vilka personer du vill dela med klickar du på Dela.

6. När du ser en bekräftelse på att din mapp har delats, notera den fullständiga nätverkssökvägen som visas omedelbart efter mappnamnet. Klicka på Klar för att stänga dialogfönstret.

   

7. Klicka på Stäng för att stänga dialogfönstret Egenskaper.

Steg 2: Konfigurera den delade mappen manuellt som en betrodd katalog

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 i det nedre vänstra hörnet.

3. Klicka på Säkerhetscenter och klicka sedan på knappen Inställningar för Säkerhetscenter....

   

4. Klicka på Betrodda tilläggskataloger.

   

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

6. Klicka på Lägg till katalog.

7. Markera kryssrutan Visa i menyn för det nyligen tillagda objektet och klicka sedan på OK för att stänga dialogfönstret Säkerhetscenter.

   

8. Klicka på OK för att stänga dialogfönstret.

9. Stäng och öppna applikationen igen så att dina ändringar träder i kraft.

Steg 3: Sideloada tillägget

Gör följande:

1. Lägg till tilläggets manifest-XML-fil i den delade mappen.

2. I ExcelPowerPoint eller Word klickar du på Tillägg på fliken Start i menyfliksområdet.

3. Klicka på Fler tillägg.

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

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

6. Du kan se ett dialogfönster 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ätverksresurs

Gör följande:

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

2. Ta bort innehållet i den här mappen: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Alternativ 3: Sideloada ett tillägg på macOS-skrivbordsapplikationer

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

Följ riktlinjerna nedan. Instruktionerna är anpassade från den officiella Microsoft-dokumentationen. För fullständiga instruktioner, se den officiella Microsoft-dokumentationen: Sideload an add-in in Office on Mac

Gör följande:

1. Öppna applikationen Finder på din dator.

2. Ange följande tangentbordskombination: Kommando+Skift+G

   Menyn Gå till mapp öppnas.

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

   • 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 mappen wef inte finns på din dator ännu. Om så är fallet, skapa den på den här platsen.

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

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

6. I menyfliksområdet navigerar du till Start > Tillägg.

7. Välj Qlik-tillägget.

Qlik-tillägget bör nu vara tillgängligt i ditt menyfliksområde.

Ta bort ett sideloadat tillägg från macOS-skrivbordsapplikationer

För att ta bort Qlik-tillägget måste du rensa Office-cachen på din dator. För mer information, se:

• Remove a sideloaded add-in

• Clear the Office cache

Felsökning

Det här avsnittet ger tips för att lösa vanliga distributions- och installationsproblem.

För ytterligare felsökningstips, se 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