# 重新加载连接元数据

连接元数据包含有关所链接的 QlikView 文档或 Qlik Sense 应用程序的数据和结构的信息。

当创建了新连接时，Qlik NPrinting 会自动上传元数据。一旦您更改了连接至 Qlik NPrinting 的 QlikView 文档或 Qlik Sense 应用程序的数据结构或内容，则也必须更新元数据。这确保 Qlik NPrinting 了解这些更改。

重新加载元数据后，与该连接相关的 Qlik NPrinting Engine 上运行的所有 QV.exe 和 reporting\_web\_renderer.exe 实例都将自动停止并重新启动，以将它们上传。现有报表不会自动重新运行，因此它们可能包含旧数据。重新加载元数据之后执行的报表将显示已更新的数据。

会相对于登录用户的时区显示上次缓存更新时间。这些时区可能不同于 Qlik NPrinting Server 的时区。您可通过单击右上角的用户名并选择设置来更改自己的时区。

## 连接状态的类型

缓存状态列为配置的连接显示以下值之一：

* 从不生成：连接从未被打开。
* 挂起：Qlik NPrinting 正在尝试连接。
* 生成中：Qlik NPrinting 已连接并正在导入元数据。
* 已生成：已成功连接所有 Qlik NPrinting 引擎。
* 错误：连接在所有可用引擎上失败。在失败两分钟后，Qlik NPrinting 排程器服务 将尝试再次连接。

连接状态列为配置的连接显示以下值之一：

* 已成功连接所有 NPrinting 引擎。
* 警告：一个或多个引擎未工作。
* 连接所有 NPrinting 引擎失败。

## 故障排除

有数种方式可解决警告、错误或连接失败状态。要开始，可打开您要排除故障的连接，并单击运行验证按钮。这将会为您提供可能问题的列表。这里是验证失败的示例，因为 Qlik Sense 证书没有正确安装：

![](https://help.qlik.com/zh-CN/nprinting/May2026/Content/Resources/Images/ex_ConnectionScreenVerificationFailure.png)

您还可检查以下方面：

* 连接属性：例如，检查 QlikView 文档路径、用户名和密码。在 Qlik Sense 中，检查证书是否存在于 Qlik NPrinting Engine 计算机上。
* Qlik NPrinting Engine 安装及配置：例如，采用 QlikView Desktop 12 的引擎无法打开 QlikView 11.2 服务器上的文档。另外检查对于运行服务的 Windows 用户，QlikView Desktop 是否有激活的许可证。

在解决所有问题之后，重新启动缓存生成或运行任务。

这里是一些常见的连接错误原因：

* [在设置指向 Qlik Sense 应用程序的连接时，验证连接错误](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Troubleshooting/Verify-connection-to-Sense-errors.htm)
* [在设置指向 QlikView 文档的连接时，验证连接错误](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Troubleshooting/Verify-connection-to-QlikView-errors.htm)
* [连接状态错误](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Troubleshooting/Connection-status-error.htm)
* [连接状态没有在 Qlik NPrinting web 控制台 中示出](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Troubleshooting/Connection-status-not-shown-in-Qlik-NPrinting-Web-Console.htm)
* [连接超时以及长时间运行任务](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Troubleshooting/Connection-timeouts-long-running-tasks.htm)

## 手动重新加载元数据

进行以下操作：

1. 在主菜单上，单击应用程序下拉菜单，然后单击连接。

   查看上次缓存更新列中的条目。如果上次缓存更新值为 -，则应当刷新元数据。

2. 单击连接名称以打开连接。

3. 在通知下，可选择在元数据重新加载结束时发送电子邮件通知。一封电子邮件将被发送至在设置 > 任务下指定的地址。请参阅：[任务执行通知](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/AdministeringQVNprinting/Tasks/Task-executions.htm#Sending)。

4. 单击重新加载元数据。

   您将看到状态：缓存状态 - 正在生成。这意味着 Qlik NPrinting 连接至 Qlik Sense 或 QlikView 并导入元数据。如果您有大型应用程序或文档，这可能需要几分钟时间。

   ![连接缓存生成状态](https://help.qlik.com/zh-CN/nprinting/May2026/Content/Resources/Images/PublishSimpleReportSenseTutorial/ex_PublishSimpleReportSenseTutorial_MetaPend.png)

5. 一旦缓存状态显示已生成，则可新建报表模板。如果您得到错误状态，请检查您的连接信息。

   ![生成了连接缓存](https://help.qlik.com/zh-CN/nprinting/May2026/Content/Resources/Images/PublishSimpleReportSenseTutorial/ex_PublishSimpleReportSenseTutorial_MetaGen.png)

您的连接元数据已经更新。您现在可创建或更新与这些连接相关的报表。

## 经由计划的触发器重新加载元数据

您可创建触发器来计划元数据定期重新加载。

进行以下操作：

1. 在主菜单上，单击应用程序下拉菜单，然后单击连接。
2. 单击连接名称以打开连接。
3. 单击触发器按钮。
4. 单击创建触发器。
5. 键入触发器名称。
6. 选择调度类型和时间。
7. 设置开始日期和时区。
8. 单击已启用按钮。
9. 单击创建按钮。

您的元数据现在将根据您的设置自动重新加载。

## 元数据重新加载的最佳实践

一旦您更改了连接至 Qlik NPrinting 的 QlikView 文档或 Qlik Sense 应用程序的数据结构，则必须更新元数据。这可以确保更改在 Qlik NPrinting 连接缓存中正确传播，并且缓存中可用的对象与相应的 QlikView 文档或 Qlik Sense 应用程序是最新的。

在以下情况下，必须触发计划或手动重新加载：

* 编辑报告时，连接的文档或应用程序中的对象不会显示在 Qlik NPrinting Designer 中。

* 创建 QlikEntity 报告时，连接的文档或应用程序中的对象不会显示在可用对象列表中。

* 创建或编辑 Qlik NPrinting 筛选器时，筛选器字段值不会显示在建议中。

* 在 Qlik NPrinting 中编辑变量相关值时，不会列出文档或应用程序中的变量。例如：条件、文件夹路径、嵌入在电子邮件中的变量。

如果在 QlikView 文档或 Qlik Sense 应用程序中重新加载数据之前和之后运行后续任务，则文档和应用程序数据可以缓存在现有连接中，而不会更新。数据推送取决于特定的文档配置。

通过重新加载元数据，可以刷新所有数据连接，确保在任务执行期间使用最新版本的数据。

在以下情况下，建议在运行发布任务之前重新加载元数据：

* 您经常在 QlikView 文档或 Qlik Sense 应用程序中重新加载数据。

* 您经常在 Qlik NPrinting 中运行任务，以保持数据连接处于活动状态。

您可以重新加载元数据：

* 手动

* 使用计划的触发器

* 使用连接重新加载 API。有关更多信息，请参阅 [POST /连接/{id}/重新加载](https://help.qlik.com/en-US/nprinting/May2021/APIs/NP+API/index.html?page=22)。