开始使用 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 和打印输出

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

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

• 纸张大小

• 页面方向

• 选择的打印区域

• 分页符

配置打印区域和页面设置的导航体验将取决于您的 Excel 版本、操作系统以及可能的 web 浏览器。有关这些 Excel 特性的详细信息，请参阅特定环境的 Microsoft 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 应用程序开发中有效的对象命名的最佳实践

当涉及到在 Qlik Sense 应用程序中的命名对象时，遵循某些最佳实践以确保清晰度、一致性和可维护性是很重要的。对象名称是显示在报表模板中的图表和表格标记。以下是为 Qlik Sense 中的表、图表和其他元素等对象命名的一些建议：

• 为每个对象使用唯一的名称。避免重复，因为重复可能会造成混淆，并导致添加错误的对象。

• 使用清晰的描述性名称。选择准确反映对象用途和内容的名称。避免使用可能让用户混淆的模糊或通用名称。

• 简明扼要，但内容丰富。保持名称简洁，同时提供足够的信息来传达对象的特性或数据。长而复杂的名称使用起来可能很麻烦。

• 使用一致的命名约定。在应用程序中的所有对象之间建立并遵循一致的命名约定。这有助于维护逻辑结构，并使搜索、识别和管理对象变得更容易。

• 避免使用特殊字符。在对象名称中始终使用字母数字字符和下划线。特殊字符可能会导致脚本或表达式出现问题。

• 使用驼峰式大小写或下划线代替空格：选择驼峰式命名法 (myTable) 或下划线 (my_table) 来分隔对象名称中的单词。这提高了可读性，使名称更易于理解。

• 避免使用保留关键字。Qlik Sense 具有不应用作对象名称的保留关键字。这些关键字用于表达式、脚本或 Qlik Sense 环境中。示例包括 "if"、"and"、 "or"、"load" 等。

• 为维度和度量使用有意义且直观的名称。在图表中创建维度和度量时，请使用清晰描述其所代表的基本数据或计算的名称。这增强了开发人员和最终用户之间的理解和协作。

• 文档命名约定。维护概述 Qlik Sense 应用程序中使用的命名约定的文档。这有助于新开发人员理解命名约定，并确保多个开发人员在同一应用程序上工作时的一致性。

• 定期检查和更新对象名称。随着应用程序的发展或需求的变化，定期检查和更新对象名称，以确保它们与应用程序的当前结构和特性保持一致。