开始使用 Microsoft Excel 的 Qlik 加载项

本主题有助于您熟悉 Microsoft Excel 的 Qlik 加载项的一些基本信息，例如激活它、打开它以及连接到 Qlik Sense 内容。有关向模板中添加内容的信息，请参阅使用 Microsoft Excel 的 Qlik 加载项和相关主题。

必须先安装加载项，然后才能开始使用它。相关信息，请参阅部署和安装 Microsoft Excel 的 Qlik 加载项。

使用加载项的要求

若要使用加载项为共享空间中的 Qlik Sense 应用程序生成报告模板，您必须具有该空间中的可查看权限。

若要使用加载项为托管空间中的 Qlik Sense 应用程序生成报告模板，您必须至少在该空间中具有受限的查看权限。

如果您使用的是 Microsoft 365 的 Microsoft Excel 的网页版本，则需要允许在浏览器设置中出现弹出窗口。但是，请保存导航历史记录和 Cookie。否则，每次打开 Excel 时都需要重新安装加载项。

激活加载项

Microsoft 管理员为您的组织安装了 Qlik 加载项后，如果您有权访问该外接程序，则可以激活并使用它。

根据您的 Microsoft Excel 版本，这些步骤可能略有不同。有关详细信息，请参阅 Microsoft 官方文档。

执行以下操作：

1. 打开 Excel 的桌面或 Web 版本。

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

3. 在对话框的 ADMIN MANAGED 选项卡中，选择 Qlik 加载项。

Qlik 加载项图标将添加到功能区栏中。

查看、管理和安装 Microsoft 365 程序的加载项

打开加载项

若要打开加载项，请单击主页选项卡下功能区栏中的 Qlik 图标。

连接到租户并登录

打开加载项时，系统会提示您连接到为其安装加载项的 Qlik Cloud 租户。请记住，单个加载项安装会为一个特定租户配置加载项。单击连接。

需要 OAuth 客户端配置才能安装加载项。

系统会要求您在第一次连接时登录，或者如果服务器端的连接已关闭时登录。在使用 Excel 的网页版本时，如果您没有保存导航历史记录和 Cookie，则可能需要稍后再次登录。

执行以下操作：

1. 当系统提示您登录时，请按照您 Qlik 帐户的登录过程进行操作，并使用租户的身份提供者配置（如适用）。

2. 在“应用程序授权”对话框中，单击批准，使用 OAuth 客户端对应用程序进行授权。您只需要在第一次登录到租户后执行此操作。

为模板选择 Qlik Sense 应用程序

登录后，您必须选择要用作正在创建的模板的源的 Qlik Sense 空间和应用程序。报告模板使用单个应用程序。您只能将一个 Qlik Sense 应用程序中的对象添加到每个 Excel 模板文件中。

执行以下操作：

1. 在空间下，选择 Qlik Cloud 分析 空间。

2. 在应用程序下，从空间中选择 Qlik Sense 应用程序。

3. 单击保存。

加载应用程序并将其元数据填充到文件中后，您可以单击 以在 Qlik Cloud 中打开源应用程序。

将模板连接到源应用程序后，您可以返回到加载项中的 选项卡来更改应用程序。有关更多信息，请参阅更改已连接的 Qlik Sense 应用程序。

应用程序中工作表的可用性

当您登录 Microsoft Excel 的 Qlik 加载项时，您将只能在源 Qlik Sense 应用程序中看到您可以访问的内容。例如，对于您个人空间中的应用程序，您可以访问所有内容。对于共享空间中的应用程序，您只能查看和使用应用程序中公共或私人的内容。共享空间应用程序中其他用户的私人工作表中的内容无法查看或使用。

预览报告

在开发模板时，您可能需要检查它将创建的输出是否符合您的要求。预览报告以查看它的外观，而无需配置报告任务并通过电子邮件发送给自己。

要预览报告，请单击加载项右上角工具栏中的 图标。您可以使用以下选项：

• 以 Excel (.xlsx) 形式预览

• 以 PDF 形式预览

打开 PDF 格式的报告预览时，报告将使用您 Excel 设置中的当前语言来应用区域格式（用于日期、数字等）。

根据您的浏览器配置，您的报告将显示在浏览器窗口中，或下载到您的计算机。如果您没有看到报告，请验证您是否允许在浏览器中弹出窗口。

打开生成的文件以检查结果。

准备 PDF 和打印输出

如果您的报告将以 PDF 格式生成或打印，您可能需要调整模板中的打印设置。使用 Microsoft Excel 中的原生功能来准备模板。这些设置可能可以在页面布局下找到。

其中一些页面设置配置可能包括：

• 纸张大小

• 页面方向

• 选择的打印区域

• 分页符

配置打印区域和页面设置的导航体验将取决于您的 Excel 版本、操作系统以及可能的 web 浏览器。有关这些 Excel 特性的详细信息，请参阅特定环境的 Microsoft Excel 文档。

稍后，当您配置报告输出时，您可以在报告中定义取决于区域的格式的区域设置。这包括日期、数字和其他信息的格式。配置此设置的位置将取决于您的用例：

• 基于任务的报告：配置报告任务时的区域格式设置。

  第 3 部分：配置输出

• 生成按需报告：配置文件设置中的首选语言设置。

  取决于区域的格式

• 打开 PDF 格式的报告预览时，报告将使用您 Excel 设置中的当前语言来应用区域格式（用于日期、数字等）。

在 Qlik Sense 中打开源对象

如果要在 Qlik Sense 中查看源对象，请选择 Excel 工作簿中的项目。接下来，在加载项的源应用程序下，单击 。

如果源对象是图表，则会将您带到 Qlik Sense 应用程序中查看相应的工作表。您可能需要再次登录 Qlik Cloud 才能打开应用程序。

保存您的工作

按正常方式保存 Excel 工作簿。您可以像往常一样重新打开 .xlsx 文件，您会看到自己的模板。

查找加载项版本和连接的服务器地址

您可以找到加载项版本和 Qlik Cloud 租户（服务器）地址。

执行以下操作：

1. 在加载项窗口中，单击工具栏中的 选项卡。

2. 在源应用程序旁边，单击 。

3. 单击关于。

4. 查看租户 URL 和 Office 加载项版本，以及 Qlik Sense 应用程序的空间和名称。

将加载项与 Qlik Cloud 租户同步

如果连接的 Qlik Cloud 租户发生了更改，则使用加载项的 Excel 文档不会自动更新。例如，您可能需要刷新：

• 可以使用的可用空间列表。

• 您可以使用的可用应用程序的列表。

• 所选 Qlik Sense 应用程序中可用实体的列表。

• 您在模板中使用的图表图像。例如，如果您在源 Qlik Sense 应用程序中进行了选择，您可能希望您的图表图像反映图像占位符中的选择。

• 您在模板中使用的图像和表格的状态（例如，因为它们已被删除或标题已更改）。

按照以下步骤刷新连接元数据。

执行以下操作：

1. 在加载项窗口中，单击工具栏中的 选项卡。

2. 在源应用程序旁边，单击 。

3. 单击刷新所有图像。

这将应用全局刷新。您还可以在加载项的其他选项卡中刷新某些单独的实体和对象。当这些可用时， 图标就会出现。

编辑 Qlik Sense 应用程序时，模板中的数据和对象不会更新，除非应用了刷新。

共享 Excel 报告模板文件

模板文件仅包含表标记和预览图像。如果其他用户想要编辑和预览模板，则必须具备：

• 安装在其 Microsoft Excel 版本中的 Qlik 加载项。

• 访问 Qlik Cloud 租户。

• 如果应用程序在共享空间中：空间中或应用程序的可以查看或更高的空间角色（这样他们就可以连接到加载项中的应用程序，并访问其数据）。

• 如果应用程序在托管空间中：空间中或应用程序的可以受限地查看或更高的空间角色（这样他们就可以连接到加载项中的应用程序，并访问其数据）。

但是，报告模板是一个普通 Excel 工作簿，其中包含创建预览时可用的数据。您可以与任何人共享模板文件，但只有具有源应用程序访问权限的用户才能在加载项中连接到该文件并应用刷新。有关全局刷新的详细信息，请参阅将加载项与 Qlik Cloud 租户同步。

在加载项中搜索 Qlik Sense 对象

您可以通过展开并滚动单击添加按钮后右侧显示的列表来查找特定 Qlik Sense 对象，也可以在搜索表单中插入字符串。按 Enter 键后，它将在插入的 Qlik Sense 应用程序的以下字段中搜索字符串：

• 对象 ID：

• 对象名称（包括工作表）

• 图表类型

为了快速找到正确的对象，在开发 Qlik Sense 应用程序时使用正确的命名约定非常重要。

访问错误消息

Excel 加载项中存在原生错误消息。为了在联系 Qlik 时帮助报告错误，请在浏览器的开发工具的 JavaScript 控制台和“网络”选项卡中检查错误消息。

应用程序对象命名的最佳实践

您在 Qlik Sense 应用程序中命名对象的方式可能会影响报告模板的有效性和可用性。有关最佳做法的列表，请参阅表格报告的最佳实践。