部署和安装适用于 Microsoft Office 的 Qlik 插件

部署和安装适用于 Microsoft Office 的 Qlik 插件，以允许您组织中的用户创建报表模板。将使用插件创建的报表模板上传到 Qlik Cloud 应用程序中，以从报表任务生成报表输出。

适用于 Microsoft Office 的 Qlik 插件可以部署和安装在 Microsoft 365 中兼容的 Excel、PowerPoint 和 Word 的 Web 和桌面版本上。

插件使用清单文件进行安装。此清单文件是 Microsoft 365 管理员（在某些安装方法中可能是用户）为自己或其组织中的用户部署和安装插件所必需的。清单文件允许为单个 Qlik Cloud 租户安装插件。

获取清单文件或 URL 后，有两种不同的方法来部署和安装插件：

• 集中部署：集中部署、安装和激活

• 旁加载：使用旁加载或网络共享安装插件

有关详细信息，请参阅 使用 Microsoft Office 的 Qlik 外接程序设计报表模板。

准备和获取插件清单

您可以使用清单文件在 Microsoft 环境中安装适用于 Microsoft Office 的 Qlik 插件。这是一个 XML 文件。对于集中部署，可能需要由 Microsoft 管理员提供清单文件的 URL。

清单文件特定于单个 Qlik Cloud租户。您使用相同的清单文件来安装适用于 Excel、PowerPoint 和 Word 的插件。

安装插件需要 OAuth 客户端配置。配置 OAuth 客户端后，从 Administration 活动中心获取清单文件链接以及清单文件本身。

执行以下操作：

1. 使用所需配置在 Qlik Cloud 租户中创建 OAuth 客户端。有关完整说明，请参阅 为适用于 Microsoft Office 的 Qlik 插件创建 OAuth 客户端。

2. 导航到 Administration 活动中心并生成清单链接。 您也可以直接下载清单文件以用于替代用例。请参阅 管理适用于 Microsoft Office 的 Qlik 加载项的安装清单。

为适用于 Microsoft Office 的 Qlik 插件创建 OAuth 客户端

需要 OAuth 客户端配置才能安装 Microsoft Office 的 Qlik 外接程序。报表开发人员使用外接程序来准备 报表模板，以便通过 Qlik Cloud 进行应用程序内报表。

为了使 OAuth 在外接程序中工作，需要使用下面所示的确切配置来配置 OAuth 客户端。

执行以下操作：

1. 在 Administration 活动中心的 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 客户端后，从 Administration 活动中心获取到更新的清单 XML 链接。转到 Settings 页面，然后选择 Email and reports 选项卡。在 共享和报告 部分中，选择 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 的桌面版或 Web 版。

2. 转到主页 > 加载项 > 获取加载项。

3. 在对话框的 ADMIN MANAGED 选项卡中，选择 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. 在您的计算机上打开 访达 应用程序。

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 的最佳实践和规则