Wdrażanie i instalowanie dodatków Qlik dla Microsoft Office

Wdróż i zainstaluj dodatki Qlik dla Microsoft Office, aby umożliwić użytkownikom w Twojej organizacji tworzenie szablonów raportów. Prześlij szablony raportów utworzone za pomocą dodatków do aplikacji Qlik Cloud, aby wygenerować raport wyjściowy z zadań raportowania.

Dodatki Qlik dla Microsoft Office można wdrożyć i zainstalować dla zgodnych wersji internetowych i komputerowych programów Excel, PowerPoint i Word w ramach Microsoft 365.

Dodatki są instalowane przy użyciu pliku manifestu. Ten plik manifestu jest wymagany przez administratora Microsoft 365 (lub ewentualnie użytkownika, w niektórych metodach instalacji) do wdrożenia i zainstalowania dodatków dla siebie lub użytkowników w swojej organizacji. Plik manifestu umożliwia instalację dodatków dla pojedynczej dzierżawy Qlik Cloud.

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

• Wdrożenie scentralizowane: Scentralizowane wdrożenie, instalacja i aktywacja

• Ładowanie bezpośrednie (sideloading): Instalowanie dodatków przy użyciu ładowania bezpośredniego (sideloading) lub udostępniania sieciowego

Więcej informacji można znaleźć w sekcji Projektowanie szablonów raportów z dodatkami Qlik dla Microsoft Office.

Przygotowywanie i uzyskiwanie manifestu dodatku

Dodatki Qlik dla Microsoft Office instaluje się w środowisku Microsoft przy użyciu pliku manifestu. Jest to plik XML. W przypadku scentralizowanego wdrożenia adres URL pliku manifestu prawdopodobnie będzie musiał zostać udostępniony przez administratora Microsoft.

Plik manifestu jest specyficzny dla pojedynczej dzierżawy Qlik Cloud. Tego samego pliku manifestu używa się do instalacji dodatków dla programów Excel, PowerPoint i Word.

Do zainstalowania dodatku wymagana jest 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, używając wymaganej konfiguracji. Pełne instrukcje można znaleźć w sekcji Tworzenie klientów OAuth dla dodatków Qlik dla Microsoft Office.

2. Przejdź do centrum aktywności Administrowanie i wygeneruj łącze do manifestu. Możesz również pobrać plik manifestu bezpośrednio dla alternatywnych przypadków użycia. Zobacz Zarządzanie manifestami instalacji dla dodatków Qlik do Microsoft Office.

Tworzenie klientów OAuth dla dodatków Qlik dla 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 wdrożenie, instalacja i aktywacja

Zaleca się udostępnianie dodatków Qlik dla Microsoft Office za pomocą scentralizowanego wdrożenia i instalacji. Scentralizowane wdrożenie wymaga działania ze strony administratora Microsoft 365 w Twojej organizacji.

W przypadku scentralizowanego wdrożenia manifest dodatku jest ładowany do centrum administracyjnego Microsoft 365 w Twojej organizacji i dystrybuowany do użytkowników jako wstępnie skonfigurowana instalacja. Dystrybucję można ograniczyć do członków określonych grup zabezpieczeń.

Należy użyć scentralizowanego wdrożenia, gdy:

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

• Chcesz zarządzać dystrybucją do członków Twojej organizacji

Postępuj zgodnie z poniższymi sekcjami procedur, aby zapoznać się z pełnym przepływem pracy.

Scentralizowane wdrożenie i instalacja

Scentralizowane wdrożenie jest przeprowadzane przez administratora systemu Microsoft 365.

Wykonaj następujące czynności:

1. Uzyskaj plik manifestu dodatku lub adres URL manifestu po utworzeniu klienta OAuth. Zobacz Przygotowywanie i uzyskiwanie manifestu dodatku.

2. Rozpowszechnij dodatek zgodnie z oficjalną dokumentacją firmy Microsoft: Wdrażanie i publikowanie dodatków pakietu Office. Należy pamiętać, że dystrybucja poprzez scentralizowane wdrożenie jest możliwa tylko przy użyciu centrum administracyjnego Microsoft 365.

Dzięki powyższej procedurze dodatki są instalowane dla użytkowników, którym przyznano do nich dostęp. Następnie użytkownicy aktywują dodatki w swojej wersji programu Excel, PowerPoint lub Word.

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

Aktywacja dodatku po scentralizowanym wdrożeniu

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 Twoja instalacja korzysta ze scentralizowanego wdrożenia, odinstalowanie dodatku może nie być możliwe. Zależy to od zasad stosowanych przez administratora Microsoft 365.

Instalowanie dodatków przy użyciu ładowania bezpośredniego (sideloading) lub udostępniania sieciowego

Ładowanie bezpośrednie i instalacja z udziału sieciowego to odpowiednie sposoby na szybkie uzyskanie dostępu do dodatków w celach testowych lub próbnych. Nie są to odpowiednie metody wdrażania dodatków w środowiskach produkcyjnych i na skalę przedsiębiorstwa.

W zależności od wersji programu 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 należy ponownie przesłać manifest do aplikacji Microsoft Office.

Opcja 2: Instalowanie dodatku w aplikacjach komputerowych Microsoft Office przy użyciu udziału sieciowego Windows

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

Postępuj zgodnie z poniższymi wytycznymi, aby załadować bezpośrednio dodatki za pośrednictwem udziału sieciowego. Instrukcje zostały zaadaptowane z oficjalnej dokumentacji firmy Microsoft. Zobacz Ładowanie bezpośrednie dodatków pakietu Office do testowania z udziału sieciowego lub inne zasoby firmy Microsoft, aby uzyskać więcej informacji.

Krok 1: Utworzenie i udostępnienie folderu

Wykonaj następujące czynności:

1. Utwórz folder do hostowania dodatku Qlik. Na przykład: C:\Qlik Office add-ins

2. W Eksploratorze plików Windows przejdź do folderu nadrzędnego lub litery dysku folderu, którego chcesz użyć 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 i/lub grupy, którym chcesz udostępnić swój dodatek. Będziesz potrzebować co najmniej uprawnień do odczytu/zapisu w folderze. Po zakończeniu wybierania osób, którym chcesz udostępnić, kliknij Udostępnij.

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

   

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

Krok 2: Ręczne skonfigurowanie udostępnionego folderu jako zaufanego katalogu

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 kliknij Opcje w lewym dolnym rogu.

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

   

4. Kliknij Zaufane katalogi dodatków.

   

5. W polu Adres URL katalogu wprowadź pełną ścieżkę sieciową do folderu, który został wcześniej udostępniony.

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 OK, aby zamknąć okno dialogowe.

9. Zamknij i ponownie otwórz aplikację, aby zmiany odniosły skutek.

Krok 3: Ładowanie bezpośrednie dodatku

Wykonaj następujące czynności:

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

2. W programie 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 pojawić się okno dialogowe z komunikatem podobnym do następującego: Qlik chce wyświetlić nowe okno. Kliknij Zezwalaj.

Usuwanie dodatku zainstalowanego za pośrednictwem udziału sieciowego

Wykonaj następujące czynności:

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

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

Opcja 3: Ładowanie bezpośrednie dodatku w aplikacjach komputerowych w systemie macOS

W przypadku systemu macOS dodatki można instalować w komputerowych wersjach programów Excel, PowerPoint lub Word w ramach Microsoft 365. Wymagania systemowe i programowe można znaleźć w sekcji Wymagania systemowe i programowe.

Postępuj zgodnie z poniższymi wytycznymi. Instrukcje zostały zaadaptowane z oficjalnej dokumentacji firmy Microsoft. Pełne instrukcje można znaleźć w oficjalnej dokumentacji firmy Microsoft: Ładowanie bezpośrednie dodatku w pakiecie Office na komputerze Mac

Wykonaj następujące czynności:

1. Otwórz aplikację Finder na swoim komputerze.

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

   Otworzy się menu Idź do folderu.

3. Wprowadź jedną z poniższych ścieżek w zależności od aplikacji Microsoft Office:

   • 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

   Może się zdarzyć, że folder wef nie istnieje jeszcze na Twoim komputerze. Jeśli tak, utwórz go w tej lokalizacji.

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

5. Otwórz program Excel, PowerPoint lub Word. Jeśli masz go już otwartego, musisz go ponownie uruchomić.

6. Na pasku wstążki przejdź do Narzędzia główne > Dodatki.

7. Wybierz dodatek Qlik.

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

Usuwanie bezpośrednio załadowanego dodatku z aplikacji komputerowych w systemie macOS

Aby usunąć dodatek Qlik, musisz wyczyścić pamięć podręczną pakietu Office na swoim komputerze. Więcej informacji można znaleźć w sekcji:

• Usuwanie bezpośrednio załadowanego dodatku

• Czyszczenie pamięci podręcznej pakietu Office

Rozwiązywanie problemów

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

Dodatkowe wskazówki dotyczące rozwiązywania problemów można znaleźć w sekcji 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