Wdrażanie i instalowanie Qlik dodatków do programu Microsoft Office

Wdróż i zainstaluj Qlik dodatki do programu Microsoft Office, aby umożliwić użytkownikom w organizacji tworzenie szablonów raportów. Przesyłaj szablony raportów utworzone za pomocą dodatków do aplikacji Qlik Cloud, aby wygenerować raporty wynikowe z zadań raportowania.

Qlik dodatki do programu Microsoft Office można wdrożyć i zainstalować w zgodnych wersjach internetowych i stacjonarnych programu Excel, PowerPoint i Word w ramach pakietu Microsoft 365.

Dodatki są instalowane przy użyciu pliku manifestu. Ten plik manifestu jest wymagany, aby administrator Microsoft 365 (lub ewentualnie użytkownik w przypadku niektórych metod instalacji) mógł wdrożyć i zainstalować dodatki dla siebie albo użytkowników w swojej organizacji.Plik manifestu umożliwia instalację dodatków dla pojedynczej Qlik Clouddzierżawy.

Po uzyskaniu pliku manifestu lub adresu URL istnieją dwie różne metody wdrażania i instalacji dodatków:

• Scentralizowane wdrażanie: Scentralizowane wdrażanie, instalacja i aktywacja

• Pobieranie lokalne: Instalowanie dodatków przy użyciu pobierania lokalnego lub udostępniania sieciowego

Więcej informacji zawiera temat Projektowanie szablonów raportów z dodatkami Qlik dla Microsoft Office.

Wymagania systemowe i programowe

Uwaga dotycząca Qlik Cloud Government

Dodatki Qlik dla Microsoft Office są obsługiwane do tworzenia szablonów raportów dla aplikacji w dzierżawach Qlik Cloud Government lub Qlik Cloud Government - DoD. Dodatki są dostępne tylko dla Office 365 Commercial.

Aby zainstalować i używać dodatków Qlik, należy spełnić następujące wymagania.

Dodatek Qlik do programu Microsoft Excel

Dla instalacji Windows:

• Windows 10 v.1903 lub wyższa wersja

• Microsoft 365 v.16.0.11629 lub wyższa wersja

Dla instalacji macOS:

• macOS v.14 lub wyższa wersja

• Microsoft 365 v.16.83 lub wyższa wersja

Ponadto, do uruchamiania dodatku Qlik dla Microsoft Excel, jest wymagana instalacja Microsoft Excel z ExcelAPI 1.9 lub nowszą wersją. Aby sprawdzić, czy Twoja instalacja Excel jest zgodna, zapoznaj się z oficjalną dokumentacją firmy Microsoft na stronie Excel JavaScript API requirement sets.

Jeśli wersja ExcelAPI będzie niższa od minimalnej, zostanie wyświetlony błąd wskazujący, że dodatek Qlikwymaga nowszej wersji programu Microsoft Excel.

W celu wyświetlenia komunikatu o błędzie być może trzeba będzie kliknąć biały obszar po prawej stronie w programie Microsoft Excel i nacisnąć klawisz F5, aby zaktualizować stronę.

Jeśli widzisz ten błąd, zaktualizuj instalację programu Microsoft Excel.

Dodatek Qlik do programu Microsoft PowerPoint

Dla instalacji Windows:

• Windows 10 v.1903 lub wyższa wersja

• Microsoft 365 wersja 2504 (kompilacja 18730.20030) lub nowsza

W przypadku instalacji macOS:

• macOS v.14 lub wyższa wersja

• Microsoft 365 v.16.96 lub wyższa wersja

Dodatek Qlik do programu Microsoft Word

W przypadku instalacji Windows:

• Windows 10 v.1903 lub wyższa wersja

• Microsoft 365 w wersji 2208 (kompilacja 15601.20148) lub nowszej

Dla macOS instalacji:

• macOS v.14 lub wyższa wersja

• Microsoft 365 v.16.64 lub wyższa wersja

Przygotowanie i uzyskanie manifestu dodatku

Qlik dodatki do Microsoft Office są instalowane w środowisku Microsoft przy użyciu pliku manifestu. To jest plik XML. W przypadku wdrożenia scentralizowanego adres URL pliku manifestu trzeba będzie prawdopodobnie uzyskać od administratora oprogramowania firmy Microsoft.

Plik manifestu jest specyficzny dla pojedynczej dzierżawy Qlik Cloud. Używasz tego samego pliku manifestu do instalowania dodatków dla Excel, PowerPoint i Word.

Do instalacji dodatku jest wymagana konfiguracja klienta OAuth. Po skonfigurowaniu klienta OAuth uzyskaj łącze do pliku manifestu, a także sam plik manifestu z centrum aktywności Administrowanie.

Wykonaj następujące czynności:

1. Utwórz klienta OAuth w dzierżawie Qlik Cloud przy użyciu wymaganej konfiguracji. Pełną instrukcję zawiera temat Tworzenie klientów OAuth dla dodatków Qlik do Microsoft Office.

2. Przejdź do centrum aktywności Administrowanie i wygeneruj łącze do manifestu. Na potrzeby alternatywnych zastosowań możesz także pobrać plik manifestu bezpośrednio. Zob. Zarządzanie manifestami instalacji dodatków Qlik do Microsoft Office.

Tworzenie klientów OAuth dla dodatków Qlik do Microsoft Office

Do zainstalowania dodatków Qlik do programu Microsoft Office wymagana jest konfiguracja klienta OAuth. Dodatki są używane przez twórców raportów do przygotowywania szablonów raportów do raportowania w aplikacji z Qlik Cloud.

Aby protokół OAuth działał w dodatkach, klient OAuth musi być skonfigurowany dokładnie tak, jak pokazano poniżej.

Wykonaj następujące czynności:

1. W centrum aktywności Administrowanie, w Qlik Cloud, przejdź do OAuth.

2. Kliknij polecenie Utwórz nowe.

3. Z menu rozwijanego Typ klienta wybierz opcję Aplikacja jednostronicowa. Pojawi się więcej pól.

4. Wstaw Nazwę. Opis jest opcjonalny.

5. Zaznacz co najmniej pole wyboru, aby uwzględnić zakres user_default. Można też uwzględnić inne zakresy w konfiguracji, ale bez user_default instalacja nie będzie działać.

   Pełny opis każdego dostępnego zakresu zawiera temat Dostępne zakresy OAuth.

6. W polu Dodaj adresy URL przekierowania wstaw adres URL Qlik Cloud dzierżawy, a następnie ten stały ciąg znaków: /office-add-ins/oAuthLoginSuccess.html

   Rezultat powinien wyglądać następująco: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Na przykład: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Kliknij Dodaj.

8. W polu Dodaj dozwolone pochodzenia wpisz adres URL dzierżawy i kliknij przycisk Dodaj.

9. Kliknij Utwórz.

10. Pojawi się okno Skopiuj identyfikator klienta. Możesz skopiować identyfikator klienta do schowka lub kliknąć Gotowe, aby zamknąć okno.

Po utworzeniu klienta OAuth uzyskaj łącze do zaktualizowanego manifestu XML z centrum aktywności Administrowanie. Przejdź do strony Ustawienia i wybierz kartę E-mail i raporty. W sekcji Udostępnianie i raporty wybierz dodatki Qlik do programu Microsoft Office. Użyj podanego łącza, aby wdrożyć i zainstalować dodatek.

Scentralizowane wdrażanie, instalacja i aktywacja

Zaleca się, aby dodatki Qlik dla Microsoft Office były udostępniane w ramach scentralizowanego wdrażania i instalacji. Scentralizowane wdrożenie wymaga działania administratora Microsoft 365 w Twojej organizacji.

W przypadku wdrożenia scentralizowanego manifest dodatku jest ładowany do centrum administracyjnego Microsoft 365 organizacji i rozpowszechniany wśród użytkowników w postaci wstępnie skonfigurowanej instalacji. Dystrybucję można ograniczyć do członków określonych grup zabezpieczeń.

Wdrożenia scentralizowanego należy używać, gdy:

• Chcesz, aby dodatek był zainstalowany na stałe dla członków Twojej organizacji

• Chcesz zarządzać dystrybucją wśród członków organizacji

Pełny przepływ pracy opisano w poniższych sekcjach procedur.

Scentralizowane wdrażanie i instalacja

Wdrożenie scentralizowane przeprowadza administrator systemu Microsoft 365.

Wykonaj następujące czynności:

1. Uzyskaj plik manifestu dodatku lub adres URL manifestu po utworzeniu klienta OAuth. Zob. Przygotowanie i uzyskanie manifestu dodatku.

2. Rozpowszechnij dodatek zgodnie z oficjalną dokumentacją firmy Microsoft: Deploy and publish Office Add-ins. Należy pamiętać, że dystrybucja za pośrednictwem wdrożenia scentralizowanego jest możliwa tylko przy użyciu Centrum administracyjnego Microsoft 365.

Przy użyciu powyższej procedury dodatki są instalowane dla użytkowników, którzy uzyskają do nich dostęp. Następnie użytkownicy aktywują dodatki w swojej wersji programu Excel, PowerPoint lub Word.

Aby zainstalować dodatki w wersji komputerowej programu Excel, PowerPoint lub Word bez wdrażania scentralizowanego, możesz skonfigurować udział sieciowy i załadować do niego manifest. Można to zrobić tylko w systemie operacyjnym Windows.

Aktywowanie dodatku po wdrożeniu scentralizowanym

Gdy administrator produktów Microsoft zainstaluje dodatek Qlik w Twojej organizacji, możesz aktywować ten dodatek i go używać, jeśli masz do niego dostęp.

W zależności od wersji Twojej Microsoft Office aplikacji, te kroki mogą się nieco różnić. Szczegółowe informacje zawiera oficjalna dokumentacja firmy Microsoft.

Wykonaj następujące czynności:

1. Otwórz wersję komputerową lub internetową programu Excel, PowerPoint lub Word.

2. Wybierz Strona główna > Dodatki > Pobierz dodatki.

3. Na karcie ZARZĄDZANE PRZEZ ADMINISTRATORA w oknie dialogowym wybierz dodatek Qlik.

Ikona dodatku Qlik zostanie dodana do paska wstążki.

Wyświetlaj, zarządzaj i instaluj dodatki dla programów Excel, PowerPoint i Word

Usuwanie dodatku

Jeśli instalacji dokonano w ramach wdrożenia scentralizowanego, odinstalowanie dodatku może nie być możliwe. Zależy to od zasad stosowanych przez administratora Microsoft 365.

Instalowanie dodatków przy użyciu pobierania lokalnego lub udostępniania sieciowego

Pobieranie lokalne i instalacja z udziału sieciowego to odpowiednie sposoby szybkiego uzyskania dostępu do dodatków w celach testowych lub próbnych. Nie są to odpowiednie metody wdrażania dodatków na skalę produkcyjną i korporacyjną.

W zależności od wersji Excel, PowerPoint lub Word, a także innych czynników, dodatki załadowane tymi metodami mogą ostatecznie zostać usunięte z paska wstążki. W takim przypadku prześlij ponownie manifest do aplikacji Microsoft Office.

Opcja 2: Instalacja dodatku w stacjonarnych aplikacjach Microsoft Office z udziału sieciowego Windows

Aby zainstalować dodatki w wersji komputerowej programu Excel, PowerPoint lub Word bez wdrażania scentralizowanego, możesz skonfigurować udział sieciowy i załadować do niego manifest. Można to zrobić tylko w systemie operacyjnym Windows.

Postępuj zgodnie z poniższymi wskazówkami, aby pobrać lokalnie dodatki za pośrednictwem udziału sieciowego. Instrukcje zostały zaczerpnięte z oficjalnej dokumentacji firmy Microsoft i adaptowane. Więcej informacji zawiera temat Sideload Office Add-ins for testing from a network share lub inne zasoby firmy Microsoft.

Krok 1: tworzenie i udostępnianie folderu

Wykonaj następujące czynności:

1. Utwórz folder, w którym będzie hostowany dodatek Qlik. Na przykład: C:\Dodatki Qlik Office

2. W Eksploratorze plików Windows przejdź do folderu nadrzędnego lub litery dysku folderu, którego chcesz używać jako katalogu folderu udostępnionego. Na przykład: C:\

3. Kliknij folder prawym przyciskiem myszy i wybierz Właściwości.

4. Otwórz kartę Udostępnianie, a następnie kliknij przycisk Udostępnij.

   

5. W oknie dialogowym dodaj siebie oraz innych użytkowników lub grupy, którym chcesz udostępnić dodatek. Będziesz potrzebować co najmniej uprawnień do odczytu/zapisu do folderu. Po zakończeniu wybierania osób, którym chcesz udostępnić dodatek, kliknij Udostępnij.

6. Gdy zobaczysz potwierdzenie, że Twój folder został udostępniony, zanotuj pełną ścieżkę sieciową wyświetloną bezpośrednio po nazwie folderu. Kliknij przycisk Gotowe, aby zamknąć okno dialogowe.

   

7. Kliknij przycisk Zamknij, aby zamknąć okno dialogowe Właściwości.

Krok 2: ręczna konfiguracja folderu udostępnionego jako katalog zaufany

Wykonaj następujące czynności:

1. Otwórz nowy pusty skoroszyt w komputerowej wersji programu Excel, PowerPoint lub Word.

2. Kliknij kartę Plik, a następnie Opcje w lewym dolnym rogu.

3. Kliknij Centrum zaufania, a następnie kliknij przycisk Ustawienia Centrum zaufania.

   

4. Kliknij opcję Zaufane wykazy dodatków.

   

5. W polu Adres URL wykazu wprowadź pełną ścieżkę sieciową do udostępnionego wcześniej folderu.

6. Kliknij Dodaj katalog.

7. Zaznacz pole wyboru Pokaż w menu dla nowo dodanego elementu, a następnie kliknij OK, aby zamknąć okno dialogowe Centrum zaufania.

   

8. Kliknij przycisk OK, aby zamknąć okno dialogowe.

9. Zamknij i ponownie otwórz aplikację, aby zmiany zaczęły obowiązywać.

Krok 3: pobieranie lokalne dodatku

Wykonaj następujące czynności:

1. Dodaj plik XML manifestu dodatku do folderu udostępnionego.

2. W ExcelPowerPoint lub Word, kliknij Dodatki na karcie Narzędzia główne na wstążce.

3. Kliknij Więcej dodatków.

4. Kliknij FOLDER UDOSTĘPNIONY u góry okna dialogowego Dodatki pakietu Office.

5. Wybierz Qlik, aby wstawić dodatek.

6. Może zostać wyświetlone okno dialogowe z komunikatem podobnym do następującego: Qlik chce wyświetlić nowe okno. Kliknij Zezwól.

Usuwanie dodatku zainstalowanego z udziału sieciowego

Wykonaj następujące czynności:

1. Jeśli program Excel, PowerPoint lub Word jest otwarty, zamknij go.

2. Usuń zawartość tego folderu: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Opcja 3: Ładowanie dodatku bezpośrednio w aplikacjach klasycznych macOS

W systemie macOS dodatki można zainstalować w Microsoft 365 wersjach klasycznych programów Excel, PowerPoint lub Word. Wymagania systemowe i programowe zawiera temat Wymagania systemowe i programowe.

Skorzystaj z poniższych wskazówek. Instrukcje zostały zaczerpnięte z oficjalnej dokumentacji firmy Microsoft i adaptowane. Pełną instrukcję można znaleźć w oficjalnej dokumentacji firmy Microsoft: Sideload an add-in in Office on Mac

Wykonaj następujące czynności:

1. Otwórz aplikację Finder na komputerze.

2. Wprowadź następującą kombinację klawiszy: Command+Shift+G

   Zostanie otwarte menu Przejdź do folderu .

3. Wprowadź jedną z następujących ścieżek w zależności od Microsoft Office aplikacji:

   • 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

   Folder wef może jeszcze nie istnieć na komputerze. W takim przypadku utwórz go w tej lokalizacji.

4. W folderze wef dodaj kopię pliku XML manifestu.

5. Otwórz Excel, PowerPoint, lub Word. Jeśli jest już otwarty, należy uruchomić go ponownie.

6. Na pasku wstążki przejdź do pozycji Strona główna > Dodatki.

7. Wybierz dodatek Qlik.

Dodatek Qlik powinien być teraz dostępny na pasku wstążki.

Usuwanie pobranego lokalnie dodatku z komputerowych macOS aplikacji

Aby usunąć dodatek Qlik, należy wyczyścić pamięć podręczną pakietu Office na komputerze. Więcej informacji zawiera temat:

• Usuwanie dodatku pobranego lokalnie

• Wyczyść pamięć podręczną Office

Rozwiązywanie problemów

W tej sekcji znajdują się wskazówki dotyczące rozwiązywania typowych problemów z wdrażaniem i instalacją.

Więcej wskazówek na temat rozwiązywania problemów zawiera temat Rozwiązywanie problemów — raporty w aplikacji.

Puste okno dialogowe wyświetlane podczas uwierzytelniania po wdrożeniu dodatku Qlik dla Microsoft Office

Gdy użytkownik próbuje uwierzytelnić się w dodatku do raportowania dla Microsoft Excel, Microsoft PowerPoint lub Microsoft Word, wyskakujące okno dialogowe uwierzytelniania może być puste. Zamiast tego użytkownik może zobaczyć błąd w oknie dialogowym (w szczególności 12006).

Aby użytkownik mógł pracować z dodatkiem Qlik do Microsoft Office, przepływ uwierzytelniania wymaga przekierowania między Twoją dzierżawą a dostawcą tożsamości hostowanym w innej domenie. Twój dostawca tożsamości ustawia Cross-Origin-Opener-Policy z restrykcyjnymi ustawieniami. W rezultacie część przepływu uwierzytelniania obejmująca komunikację między domenami jest blokowana, co uniemożliwia prawidłowe zwrócenie danych logowania do dodatku.

Proponowane działanie  

Poniższe rozwiązanie powinien wykonać administrator sieci odpowiedzialny za konfigurowanie dostawców tożsamości.

Wykonaj następujące czynności:

• Ustaw nagłówek odpowiedzi od swojego dostawcy tożsamości w oknie dialogowym na:

  Cross-Origin-Opener-Policy: unsafe-none

Aby uzyskać więcej informacji, zapoznaj się z oficjalną dokumentacją firmy Microsoft: Best practices and rules for the Office Dialog API