部署與安裝適用於 Microsoft Office 的 Qlik 增益集

部署與安裝適用於 Microsoft Office 的 Qlik 增益集，以允許您組織中的使用者建立報告範本。將使用增益集建立的報告範本上傳至 Qlik Cloud 應用程式，以從報告工作產生報告輸出。

適用於 Microsoft Office 的 Qlik 增益集可以部署並安裝在 Microsoft 365 內相容的 Excel、PowerPoint 和 Word 網頁版與桌面版中。

增益集是使用資訊清單檔案安裝的。Microsoft 365 管理員 (或在某些安裝方法中可能是使用者) 需要此資訊清單檔案，才能為自己或其組織中的使用者部署和安裝增益集。資訊清單檔案允許為單一 Qlik Cloud 租用戶安裝增益集。

取得資訊清單檔案或 URL 後，有兩種不同的方法可以部署和安裝增益集：

• 集中式部署：集中式部署、安裝與啟動

• 側載：使用側載或網路共用安裝增益集

如需詳細資訊，請參閱 搭配 Qlik 增益集設計報告範本，適用於 Microsoft Office。

準備並取得增益集資訊清單

您可以使用資訊清單檔案在 Microsoft 環境中安裝適用於 Microsoft Office 的 Qlik 增益集。這是一個 XML 檔案。對於集中式部署，可能需要由 Microsoft 管理員提供資訊清單檔案的 URL。

資訊清單檔案專屬於單一 Qlik Cloud租用戶。您可以使用相同的資訊清單檔案來安裝適用於 Excel、PowerPoint 和 Word 的增益集。

安裝增益集需要 OAuth 用戶端組態。設定 OAuth 用戶端後，請從 管理 活動中心取得資訊清單檔案連結以及資訊清單檔案本身。

請執行下列動作：

1. 使用所需的組態在 Qlik Cloud 租用戶中建立 OAuth 用戶端。如需完整指示，請參閱 建立適用於 Microsoft Office 的 Qlik 增益集的 OAuth 用戶端。

2. 導覽至 管理 活動中心並產生資訊清單連結。 您也可以直接下載資訊清單檔案以用於替代選項使用案例。請參閱 管理 Microsoft Office 的 Qlik 增益集安裝資訊清單。

建立適用於 Microsoft Office 的 Qlik 增益集的 OAuth 用戶端

需要 OAuth 用戶端設定才能安裝 Microsoft Office 的 Qlik 增益集。增益集由報告開發人員用來準備 報告範本，以便搭配 Qlik Cloud 進行應用程式內報告。

為了讓 OAuth 在增益集運作，需要使用以下所示的確切設定來設定 OAuth 用戶端。

請執行下列動作：

1. 在 管理 活動中心內，於 Qlik Cloud 中，前往 OAuth。

2. 按一下新建。

3. 在用戶端類型下拉式功能表中，選取單頁應用程式。將會顯示更多欄位。

4. 插入名稱。描述為選填。

5. 至少應選取核取方塊，以納入 user_default 範圍。您可以在設定中納入其他範圍，但沒有 user_default，安裝將無法運作。

   請參閱 可用的 OAuth 範圍 瞭解每個可用範圍的完整描述。

6. 在新增重新導向 URL 欄位中，插入 Qlik Cloud 租用戶的 URL，接著插入此固定字串：/office-add-ins/oAuthLoginSuccess.html

   結果應如下所示：https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html。例如：http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. 按一下新增。

8. 在新增允許來源欄位中，插入租用戶 URL，並按一下新增。

9. 按一下建立。

10. 就會顯示複製用戶端 ID 視窗。您可以選擇將用戶端 ID 複製到剪貼簿，或按一下完成以關閉視窗。

建立 OAuth 用戶端後，從 管理 活動中心取得更新後的資訊清單 XML 連結。前往 設定 頁面，並選取 電子郵件與報告 索引標籤。在 共用與報告 區段中，選取 Microsoft Office 的 Qlik 增益集。使用提供的連結部署並安裝增益集。

集中式部署、安裝與啟動

建議透過集中式部署與安裝來提供適用於 Microsoft Office 的 Qlik 增益集。集中式部署需要您組織中的 Microsoft 365 管理員採取動作。

透過集中式部署，增益集資訊清單會載入至您組織的 Microsoft 365 系統管理中心，並以預先設定的安裝形式散發給使用者。散發可以限制為特定安全性群組的成員。

您應在下列情況下使用集中式部署：

• 您希望為組織成員永久安裝增益集

• 您希望管理對組織成員的散發

請遵循下方的程序區段以了解完整工作流程。

集中式部署與安裝

集中式部署由 Microsoft 365 系統管理員完成。

請執行下列動作：

1. 建立 OAuth 用戶端後，取得增益集資訊清單檔案或資訊清單 URL。請參閱 準備並取得增益集資訊清單。

2. 根據官方 Microsoft 文件散發增益集：部署和發佈 Office 增益集。請注意，只能使用 Microsoft 365 系統管理中心透過集中式部署進行散發。

透過上述程序，增益集會安裝給獲得存取權的使用者。然後，使用者在其 Excel、PowerPoint 或 Word 版本中啟動增益集。

若要在沒有集中式部署的情況下，於 Excel、PowerPoint 或 Word 的桌面版上安裝增益集，您可以設定網路共用並將資訊清單載入其中。這只能在 Windows 作業系統上完成。

在集中式部署後啟動增益集

Microsoft 管理員為您的組織安裝了 Qlik 增益集之後，若您已獲得存取權限，則可以啟用並使用。

根據您的 Microsoft Office 應用程式版本，這些步驟可能會稍有不同。請參閱官方 Microsoft 文件瞭解完整詳細資訊。

請執行下列動作：

1. 開啟 Excel、PowerPoint 或 Word 的電腦版或網頁版本。

2. 前往首頁 > 增益集 > 取得增益集。

3. 在對話方塊的管理員 管理索引標籤中，選取 Qlik 增益集。

Qlik 增益集圖示會新增至功能區列。

檢視、管理及安裝適用於 Excel、PowerPoint 和 Word 的增益集

移除增益集

如果您的安裝使用集中式部署，您可能無法解除安裝增益集。這取決於您的 Microsoft 365 管理員所使用的原則。

使用側載或網路共用安裝增益集

側載和網路共用安裝是為了測試或試用目的而快速取得增益集存取權的合適方法。它們不適合用於為生產和企業規模使用案例部署增益集。

視您的 Excel、PowerPoint 或 Word 版本以及其他因素而定，使用這些方法載入的增益集最終可能會從您的功能區長條中移除。發生這種情況時，請將資訊清單重新上傳至 Microsoft Office 應用程式。

選項 2：使用 Windows 網路共用在桌面版 Microsoft Office 應用程式上安裝增益集

若要在沒有集中式部署的情況下，於 Excel、PowerPoint 或 Word 的桌面版上安裝增益集，您可以設定網路共用並將資訊清單載入其中。這只能在 Windows 作業系統上完成。

請遵循下方的指導方針，透過網路共用側載增益集。這些指示改編自官方 Microsoft 文件。如需詳細資訊，請參閱 從網路共用側載 Office 增益集以進行測試 或其他 Microsoft 資源。

步驟 1：建立並共用資料夾

請執行下列動作：

1. 建立一個資料夾來裝載 Qlik 增益集。例如：C:\Qlik Office add-ins

2. 在 Windows 檔案總管中，移至您要用作共用資料夾目錄的資料夾的父資料夾或磁碟機代號。例如：C:\

3. 以滑鼠右鍵按一下資料夾，然後選取 內容。

4. 開啟「共用」索引標籤，然後按一下 共用... 按鈕。

   

5. 在對話方塊視窗中，新增您自己以及您想要與其共用增益集的任何其他使用者和/或群組。您至少需要該資料夾的讀取/寫入權限。完成選擇要共用的人員後，按一下 共用。

6. 當您看到資料夾已共用的確認訊息時，請記下緊接在資料夾名稱後方顯示的完整網路路徑。按一下 完成 以關閉對話方塊視窗。

   

7. 按一下 關閉 以關閉 內容 對話方塊視窗。

步驟 2：手動將共用資料夾設定為信任的目錄

請執行下列動作：

1. 在 Excel、PowerPoint 或 Word 的桌面版中開啟新的空白活頁簿。

2. 按一下 檔案 索引標籤，然後按一下左下角的 選項。

3. 按一下 信任中心，然後按一下 信任中心設定... 按鈕。

   

4. 按一下 信任的增益集目錄。

   

5. 在 目錄 URL 方塊中，輸入您先前共用之資料夾的完整網路路徑。

6. 按一下 新增目錄。

7. 勾選新加入項目的 顯示在功能表中 核取方塊，然後按一下 確定 以關閉信任中心對話方塊視窗。

   

8. 按一下 確定 以關閉對話方塊視窗。

9. 關閉並重新開啟應用程式，讓您的變更生效。

步驟 3：側載增益集

請執行下列動作：

1. 將增益集資訊清單 XML 檔案新增至共用資料夾。

2. 在 Excel、PowerPoint 或 Word 中，按一下功能區 常用 索引標籤上的 增益集。

3. 按一下 更多增益集。

4. 按一下 Office 增益集 對話方塊頂端的 共用資料夾。

5. 選取 Qlik 以插入增益集。

6. 您可能會看到類似下列內容的對話方塊視窗：Qlik 想要顯示新視窗。按一下 允許。

移除透過網路共用安裝的增益集

請執行下列動作：

1. 如果您已開啟 Excel、PowerPoint 或 Word，請將其關閉。

2. 刪除此資料夾的內容：%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

選項 3：在桌面版 macOS 應用程式上側載增益集

針對 macOS，增益集可以安裝在 Microsoft 365 桌面版的 Excel、PowerPoint 或 Word 上。如需系統與軟體需求，請參閱 系統與軟體需求。

請遵循下方的指導方針。這些指示改編自官方 Microsoft 文件。如需完整指示，請參閱官方 Microsoft 文件：在 Mac 上的 Office 中側載增益集

請執行下列動作：

1. 在您的電腦上開啟 Finder 應用程式。

2. 輸入下列鍵盤組合：Command+Shift+G

   前往資料夾 功能表隨即開啟。

3. 根據 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

   您的電腦上可能還不存在 wef 資料夾。如果是這樣，請在此位置建立它。

4. 在 wef 資料夾中，新增 XML 資訊清單檔案的複本。

5. 開啟 Excel、PowerPoint 或 Word。如果您已經開啟它，則需要重新啟動它。

6. 在功能區長條中，導覽至 常用 > 增益集。

7. 選取 Qlik 增益集。

Qlik 增益集現在應該可以在您的功能區長條中使用了。

從桌面版 macOS 應用程式移除側載的增益集

若要移除 Qlik 增益集，您需要清除電腦上的 Office 快取。如需詳細資訊，請參閱：

• 移除側載的增益集

• 清除 Office 快取

疑難排解

本區段提供解決常見部署與安裝問題的秘訣。

如需其他疑難排解秘訣，請參閱 疑難排解 - 應用程式內報告。

部署適用於 Microsoft Office 的 Qlik 增益集後，在驗證期間顯示空白對話方塊

若使用者嘗試驗證適用於 Microsoft Excel、Microsoft PowerPoint 或 Microsoft Word 的報告增益集，其驗證快顯對話方塊可能會空白。或者，使用者可能會在對話方塊中看見錯誤 (尤其是 12006)。

若使用者要使用 Microsoft Office 的 Qlik 增益集，驗證流程需要在您的 租用戶 和在不同網域託管的識別提供者之間重新導向。您的識別提供者會以限制設定來設定 Cross-Origin-Opener-Policy。因此，會封鎖驗證流程的交叉網域通訊部分，以防登入資訊正確傳回增益集。

建議的行動  

應由負責設定識別提供者的網路管理員執行下列解決方案。

請執行下列動作：

• 從 IDP 到對話方塊將回應標頭設定為：

  Cross-Origin-Opener-Policy: unsafe-none

如需更多資訊，請參閱官方 Microsoft 文件：Office 對話方塊 API 的最佳做法和規則