# 任务执行

任务执行页面显示有关 Qlik NPrinting Server 任务的详细信息。

您可通过单击管理员并选择任务执行来打开任务执行页面。

将根据登录用户的时区显示任务执行时间。这些时区可能不同于 Qlik NPrinting Server 的时区。您可通过单击右上角的用户名并选择设置来更改自己的时区。



## 执行阶段

发布任务具有三个阶段：

1. 内容解析：Qlik NPrinting 从 QlikView 或 Qlik Sense 获取创建报表所需的数据。
2. 内容制作：Qlik NPrinting 创建报表。
3. 发布：报表根据您的任务设置发送。

这些步骤按顺序为每个报表和用户的组合执行。它们为不同报表并行执行，并且许多报表可同时于相同阶段执行。

## 过滤任务

默认情况下，会显示所有进行中或完成的任务。您可按视图、任务类型或日期范围过滤。您还可按任务名称来搜索。单击任何列标题旁的黑色三角形将按字母顺序将列项目排序。

视图下拉列表具有以下选项：

* 所有执行
* 进行中
* 已完成

任务类型下拉列表具有以下选项：

* 导入过滤器和收件人
* 发布报表
* 生成连接缓存
* 生成报表模板：此任务与迁移 QlikView NPrinting 16 报表模板有关。请参阅：[使用迁移工具](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/Migrate/Import-reports.htm) （仅提供英文版本）。
* 搜索字段值：如果您在添加未缓存的字段时按下搜索按钮，Qlik NPrinting 将开始任务以检索未缓存的值。

有两个日期范围下拉列表：

* 创建时间：
  * 创建时间
  * 上次更新时间
* 全部时间：
  * 全部时间

  * 今日

  * 昨日

  * 本周

  * 本月

  * 过去 7 天

  * 过去 30 天

  * 自定义：让您设置特定日期范围。

要按名称搜索，将您查找的任务的名称键入右侧的搜索表。将会动态过滤任务的列表。

## 任务执行状态

任务执行字段

| 字段 | 描述 |
| --- | --- |
| 任务名称 | 任务的名称。 |
| 任务类型 | 任务的类型。 |
| 状态 | 闪烁状态意味着任务正在运行。固定状态意味着任务已完成，或者以警告、失败或中止停止。 |
| 进度 | 发布完成的百分比。在内容解析和内容制作期间，进度将保持为 0%。当发布开始或者条件计算返回 false 时，它将开始增大。这意味着将不会生成某些报表，并且这些报表会被计为已完成。 |
| 创建时间 | 上次创建任务的日期和时间。 |
| 上次更新时间 | 上次更新任务的日期和时间。 |

您可通过单击页面底部的编号按钮更改可见行数。

有数个类型的状态：

* 警告（仅闪烁）：一些报表正确创建，但是还有一些存在问题。

  任务仍在运行。

* 警告（仅持续亮起）：一些报表正确创建，但是还有一些存在问题。

  任务已完成，状态为警告。

* 失败：所有报表都存在问题。

* 正在运行（仅闪烁）：一切良好，但是任务仍然在执行。

* 已完成（仅静止）：所有报表都正确创建并发送。

* 已排队：任务在等待开始执行。

* 中止：任务执行被手动停止，因为用户按下了任务详细信息页面的中止按钮。

## 任务执行详细信息

单击任务名称以打开其详细信息页面。详细信息页面分为三个部分：

* 概览
* 统计信息
* 日志

当打开该页面时，您需要等待所有日志完成加载。这可能需要数秒。

### 概览

该部分包含有关任务的基本信息：

* 任务名称
* 任务类型
* 状态
* 进度
* 创建时间
* 上次更新时间

### 统计信息

第二部分显示任务的统计信息。

任务执行统计信息

| 字段 | 描述 |
| --- | --- |
| 耗时 | 自任务开始或自最新任务开始经过的时间。该时间仅在存在有关任务的定时更新时更新。如果任务受阻，则不会更新耗时。对于所有类型的任务可见。 |
| 已开始解析 | 已经开始内容解析步骤的报表数。仅对发布报表任务可见。 |
| 已完成解析 | 已经完成内容解析步骤的报表数。仅对发布报表任务可见。 |
| 已开始制作 | 已经开始内容制作步骤的报表数。仅对发布报表任务可见。 |
| 已完成制作 | 已经完成内容制作步骤的报表数。仅对发布报表任务可见。 |
| 开始发布 | 已开始发布步骤的报表数。仅对发布报表任务可见。 |
| 完成的发布 | 已结束发布步骤的报表数。仅对发布报表任务可见。 |
| 报表失败 | 有任何执行步骤失败的报表数。仅对发布报表任务可见。 |

### 日志

包含详细日志的任务详细信息页面的最后部分。每个日志包括：

任务日志字段

| 字段 | 描述 |
| --- | --- |
| 日期和时间 | Qlik NPrinting Server 时区中日志生成的日期和时间。 |
| 层级 | 日志级别是关于记录的事件的严重性的提示。值 Error 或 Warn 意味着发生了错误，我们建议进行调查。值 Info 意味着事件正确结束。 |
| 说明 | 记录的操作的详细说明。 |

#### 通过日志中的 ID 检索报表

在任务执行详细信息页面的日志中没有解析报表 ID。报表名称不可见，并且您将需要检索它们。

进行以下操作：

1. 打开任务详细信息页面。
2. 选择并复制您要解析的报表 ID。
3. 转到发布任务页面。
4. 打开和初始日志相关的发布任务。
5. 打开其中一个可用报表。
6. 通过粘贴复制的报表 ID，更换 URL 的最后部分（最后的反斜线右侧的字符串）。
7. 按下 Enter。

## 中止任务

您可随时停止执行任务。

进行以下操作：

1. 单击任务的名称。
2. 单击右上角的中止按钮。
3. 任务的执行停止，并且显示已中止状态。

## 更改任务设置

管理员可设置当报表或变量未呈现时会发生什么。他们也可选择接收任务通知电子邮件。

### 要求

您必须确保配置了 NewsStand 和 Qlik NPrinting web 控制台 URL 设置，方可经由电子邮件设置任务通知。如果您没有配置 URL，通知电子邮件中的链接将无效。

进行以下操作：

1. 在主菜单中，转到管理员 > 设置。
2. 单击系统按钮。
3. 在 Web 控制台 URL 中输入包含端口号的 Qlik NPrinting web 控制台 URL。您可从 Qlik NPrinting web 控制台 浏览器地址栏复制包含端口号的 URL。
4. 在 NewsStand URL 中输入包含端口号的 NewsStand URL。
5. 单击更新。

### 错误处理：报表

默认情况下，如果报表生成失败，收件人仍会收到计划的电子邮件。用户没有看到报表，而是看到错误消息和联系管理员的指示。管理员可禁用此行为，从而不会在报表失败时发送电子邮件。报表失败将作为错误出现在日志文件中。

在禁用该行为时，如果至少一个报表成功创建，仍会发送电子邮件。

例如：

您在单个任务中有 3 个用户。任务对每个用户有 2 个报表，这些报表通过电子邮件发送。

* 用户 A：报表生成成功。
* 用户 B：一个报表生成失败。
* 用户 C：所有报表生成失败。

在该情况下：

* 用户 A 收到具有两个附件的电子邮件。
* 用户 B 收到具有单个附件的电子邮件。将不会提到失败的报表。
* 用户 C 将收不到任何电子邮件。

进行以下操作：

1. 在主菜单中，转到管理员 > 设置。
2. 单击任务按钮。
3. 在电子邮件分配错误下，转到当发布任务无法生成一个或多个报表时。从以下选项中进行选择：
   * 收件人将收到成功的报告，并附带列出失败的报表的信息

   * 收件人将接收成功的报表，没有错误信息

     信息注释如果所有报表失败，收件人将不会收到电子邮件。
4. 单击更新。

### 错误处理：变量

管理员可设置如果未解析电子邮件中的变量会发生什么。

进行以下操作：

1. 在主菜单中，转到管理员 > 设置。
2. 单击任务按钮。
3. 在电子邮件分配错误下，转到当发布任务无法解析变量标签时。从以下选项中进行选择：
   * 发送带有原样标签的电子邮件
   * 发送删除了标签的电子邮件
   * 请勿发送电子邮件
4. 单击更新。

### 任务执行通知

如果任务以成功、错误或警告结束，您可收到通知。通知可被发送至多个电子邮件地址。

进行以下操作：

1. 在主菜单中，转到管理员 > 设置。

2. 单击任务按钮。

3. 在通知下，如果任务以下列方式结束，您可选择发送电子邮件：

   * 错误
   * 警告
   * 成功

4. 在电子邮件通知下，您必须添加：

   * 发件人地址
   * 发件人姓名
   * 收件人

5. 您可选择添加抄送人或密件抄送人。

   信息注释您可使用分号来添加多个收件人、抄送人或密件抄送人地址。

6. 单击更新。

7. 如果您希望收到任务的通知电子邮件，则需要将它们启用。打开任务，转到概览底部，并选择发送任务通知。