# 针对迁移的故障排除

本部分列出了迁移期间可能显示的错误信息的解决办法。

下面花括号 `{}` 内的任何文本将替换为您的实体的确切值或名称。

在主要导入页面，您可单击蓝色图标以在新选项卡中查看实体。

![Main import details page, entity with warning](https://help.qlik.com/zh-CN/nprinting/February2025/Content/Resources/Images/ui_migrate_ResultsWarn.png)

如果实体存在错误或警告信息，解决这些信息，然后回到导入页面。

![PixelPerf report with migration warning](https://help.qlik.com/zh-CN/nprinting/February2025/Content/Resources/Images/ui_migrate_EntityWarning.png)

## 主要导入页面

以下信息仅显示在主要迁移页面上。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不受支持的 NSQ 文件版本。请用 NPrinting 16 打开 NSQ 项目，然后保存并再次导出它。

您在尝试导入具有以旧格式保存的 .nsq 文件的 QlikView NPrinting 16 项目。

解决办法：

1. 在最新的 QlikView NPrinting 16 版本中，打开初始 .nsq 文件。
2. 保存该文件，即使您没有进行任何修改也进行保存，以强制转换成受支持的格式
3. 再次导出项目。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### NPrinting 16 项目不包含任何连接。

您在尝试导入没有任何连接的 QlikView NPrinting 16 项目。

解决办法：检查 QlikView NPrinting 16 中的连接，并再次导出项目。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 上传的文件并非有效的 NPrinting 16 导出的项目

您在上传不包含 .nsq 文件的导出项目文件 (.zip)。

解决办法：在 QlikView NPrinting 16 中再次导出项目。

## 过滤器

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 变量过滤器导入失败： {name}

变量过滤器的导入失败。检查变量 `{name}` 是否存在于相关 .qvw 中。

要解决问题，请尝试以下办法中的一个或多个：

* 在 .qvw 中创建变量并刷新连接缓存。
* 修改过滤器，以避免使用变量。
* 删除过滤器。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 过滤器字段导入因为链接的字段不受支持而失败： {name}

链接的字段在 Qlik NPrinting November 2019 或更新的版本中不受支持。

解决办法：手动修改过滤器以从不同的连接使用初始字段。过滤器将如预期发挥作用，但是无法作为层级、页面或循环应用。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 过滤器书签导入因为 QlikView 书签不受支持而失败： {name}

Qlik NPrinting November 2019 或更新的版本不支持书签过滤器。

解决办法：手动修改过滤器以使用初始字段重新创建书签。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不支持应用了“锁定”的字段。该过滤器的行为可能和初始过滤器行为不同： {name}

QlikView 锁定字段选项在 Qlik NPrinting November 2019 或更新的版本中不受支持。

解决办法：手动更新所创建的过滤器。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 无法导入字段：{name}。该 QlikView 字段用在多个字段中： {qvId}

使用相同字段一次以上的 QlikView NPrinting 16 过滤器在 Qlik NPrinting November 2019 或更新版本中不受支持。

解决办法：手动更新所生成的过滤器。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 无法导入过滤器变量：{name}。该 QlikView 变量已用在另一过滤器中： {qvId}

使用相同变量一次以上的 QlikView NPrinting 16 过滤器在 Qlik NPrinting November 2019 或更新版本中不受支持。

解决办法：手动更新所生成的过滤器。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 已跳过字段，因为它没有值： {name}

您在尝试导入没有字段值的过滤器，该过滤器没有标记清除所有选择选项。

解决办法：在新创建的过滤器中手动添加字段。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 过滤器字段导入失败： {name}

所导入的 QlikView NPrinting 16 项目中不存在指向字段 `{name}` 的连接。

要解决问题，请尝试以下办法中的一个或多个：

* 手动更新所导入的过滤器。
* 删除过滤器。
* 更新 QlikView NPrinting 16 项目，将其导出，然后再次导入它。

## 报表

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 报表过滤器导入失败： {name}

与报表相关的过滤器 `{name}` 的导入失败，因为没有找到该过滤器。

解决办法：手动创建缺失的过滤器。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 报表对象过滤器导入失败： {name}

在报表中作为对象过滤器使用的过滤器 `{name}` 的导入失败。

解决办法：手动创建缺失的过滤器，并将其作为对象过滤器添加。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 报表条件导入失败： {name}

与报表相关的条件 `{name}` 的导入失败。

解决办法：手动创建缺失的条件，并将其添加至报表。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 当不支持循环时，自定义“添加报表名称的字段”： {name}

在 Qlik NPrinting 19 November 或更新的版本中，如果字段的值和循环中使用的字段不同，则您无法将其添加至报表文件名称。

解决办法：使用受支持的动态命名功能，手动修改报表文件名称的创建方式。

请参阅：[循环报表](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/ReportsDevelopment/Cycling-your-reports.htm) （仅提供英文版本） 和 [动态报表名称](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/ReportsDevelopment/Dynamic-report-naming.htm) （仅提供英文版本）。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 需要验证过滤器： {name}

实体在使用存在错误或警告信息的过滤器 `{name}`。

解决办法：解决过滤器 `{name}` 中的错误或警告。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到连接：{name}。它与循环字段相关： {field}

在循环中使用的字段 `{field}` 的连接 `{name}` 缺失。

解决办法：手动添加循环的字段。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到连接：{name}。它和动态命名中使用的变量相关： {variable}

指向动态命名中使用的变量 `{variable}` 的连接 `{name}` 缺失。

解决办法：通过添加变量手动更新动态命名配置。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到动态命名中使用的 QlikView 变量： {name}

动态命名中使用的 QlikView 变量 `{name}` 缺失。

解决办法：手动更新动态命名配置。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不受支持的变量类型： {name}

在所导入的动态命名配置中使用的变量 `{name}` 的类型不受支持。

解决办法：打开报表并编辑动态命名配置。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到 QlikView 对象： {name}

在报表模板中所使用的 QlikView 对象 `{name}` 缺失。

解决办法：在源 .qvw 中重新创建对象并重新生成连接缓存。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 在读取 QlikView 实体时出错

在读取 QlikView 实体时发生一般错误。错误存在于所导入的 QlikView NPrinting 16 项目中。

解决办法：

1. 打开生成错误的实体。
2. 更新实体并确保其正常发挥作用。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 没有找到该报表的模板文件

报表模板文件缺失。

解决办法：

* 检查模板文件是否存在于源 QlikView NPrinting 16 项目中。它是基于文件的系统，因此可能已经从初始模板文件夹中删除了模板。在该情况下，您必须从备份中检索它，或者在 Qlik NPrinting 安装中重新创建它。
* 检查 QlikView NPrinting 16 报表是否包含模板的正确路径，包括文件名。语法已经被修改为错误的值。
* 如果您在 QlikView NPrinting 16 模板文件夹中找到文件，可在 Qlik NPrinting 安装中手动创建报表，并将其用作自定义模板。然后：
  * 在 Qlik NPrinting Designer 中打开它，并在树视图中添加所需的 QlikView 实体，或者
  * 导出 QlikView NPrinting 16 项目并再次将其导入，并验证模板是否正确。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 模板转换失败

报表模板转换失败。

解决办法：

1. 在 Qlik NPrinting Designer 中打开模板。
2. 解决出现的错误信息。
3. 单击保存并关闭。这将强制转换再次运行。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 该报表中的一些实体未存在于连接缓存中

在连接缓存中缺失模板中使用的一些实体。

解决办法：

1. 在 Qlik NPrinting Designer 中打开模板以获得所缺失实体的详细列表。
2. 通过在源 .qvw 文档中创建缺失的实体来解决列表中的问题。或者将它们从模板中删除。
3. 重新生成连接缓存。

这些错误也可能出现在 QlikView NPrinting 16 项目中。例如，如果在 .qvw 中删除了实体，但是仍然在模板中使用这些实体。在该情况下：

1. 在 QlikView NPrinting 16 安装中解决错误。
2. 将它导出，然后再导入。

## 条件

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 需要验证条件： {name}

在任务的报表内所使用的导入条件 `{name}` 存在警告或错误信息。

解决办法：验证并修正所列错误。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到连接： {name}

在所导入的条件中使用的连接 `{name}` 缺失。

解决办法：手动更新条件。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到运算符： {name}

所导入的条件运算符 `{name}` 缺失。

解决办法：通过设置受支持的运算符更新条件。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到值选项： {name}

在所导入的条件中使用的值选项 `{name}` 缺失。

解决办法：打开条件并更新它。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到 QlikView 变量： {name}

在所导入的条件中使用的 QlikView 变量 `{name}` 缺失。

解决办法：

* 通过使用现有变量更改条件。
* 在源 .qvw 中创建变量并刷新连接缓存。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 未找到 QlikView 图表： {name}

所导入的条件使用的 QlikView 图表 `{name}` 缺失。

解决办法：在源 .qvw 中创建图表并刷新连接缓存。

## 任务

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 任务过滤器导入失败： {name}

导入的任务中所使用的过滤器 `{name}` 缺失。

解决办法：手动创建过滤器并将其与任务关联。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 需要验证过滤器： {name}

实体在使用过滤器 `{name}`，该过滤器存在错误或警告信息。

解决办法：解决过滤器中的错误或警告。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 需要验证报表： {name}

您在任务中尝试使用报表 `{name}`，该报表存在警告或错误信息。

解决办法：打开报表 `{name}` 并修正错误。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 任务报表导入失败： {name}

导入的任务中所使用的报表 `{name}` 缺失。

解决办法：

1. 检查导入日志，确定在报表导入期间是否出错。
2. 在您的 Qlik NPrinting November 2019 安装中从头开始创建报表。或者将 QlikView NPrinting 16 模板用作自定义模板。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 跳过了任务报表：{name}。存在具有相同设置和输出格式的另一个报表： {format}

在 Qlik NPrinting November 2019 或更新的版本中，您无法针对每个任务添加一次以上具有相同输出格式和相同质量的同一报表。仅会导入第一个报表并且将跳过其余报表。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 任务报表导入失败：{name}。输出格式不受支持： {format}

Qlik NPrinting November 2019 或更新的版本不支持一些输出格式（例如具有宏 .docm 的 Word 文档，以及 .csv 格式的 PixelPerfect 报表）。

解决办法：将报表添加至任务，并选择一个受支持的输出格式。请参阅：[报表输出格式](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/DistributionSchedulesAutomation/Report-output-formats.htm) （仅提供英文版本）。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 任务报表导入失败：{name}。 {type} 报表不支持输出格式 {format}

您在任务中尝试以不受支持的输出格式 `{format}` 导入报表 `{name}`。

解决办法：将报表添加至任务，并选择一个受支持的输出格式。请参阅：[报表输出格式](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/DistributionSchedulesAutomation/Report-output-formats.htm) （仅提供英文版本）。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 该任务报表不支持着色类型 {type}： {name}

在 Qlik NPrinting November 2019 或更新的版本中，彩色是唯一受支持的模式。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 该任务报表不支持多页面高级设置： {name}

报表 `{name}` 不支持报表多页面。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不支持自定义分隔符。对于任务报表将改为使用逗号： {name}

在 Qlik NPrinting November 2019 或更新的版本中不支持使用自定义分隔符。它们将由逗号替代。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 该任务报表不支持自定义页面范围： {name}

任务中的报表 `{name}` 不支持自定义页面范围。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 任务电子邮件不支持该标签： {name}

Qlik NPrinting November 2019 或更新的版本不支持特定电子邮件正文标签。

解决办法：相应地更新电子邮件正文。请参阅：[计划您的迁移](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/Migrate/Before-you-migrate.htm)。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不支持将外部 HTML 文件用作电子邮件正文： {name}

您无法将外部 HTML 文件用作电子邮件正文。

解决办法：复制 HTML 文件的内容，并将其粘贴在电子邮件正文编辑器中。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不支持将外部文件附加至任务电子邮件： {name}

外部电子邮件附件不受支持。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 电子邮件页脚图像不受支持： {name}

电子邮件页脚图像不受支持。您无法手动添加它们。

要解决问题，请尝试以下办法之一：

* 通过嵌入图像编辑电子邮件正文
* 创建带有图像的 HTML 正文文本。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### “创建包含压缩报表的档案”选项不受支持

您无法创建包含压缩报表的档案。

解决办法：发送未压缩的报表。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### 不支持“低”和“中”报表质量。对于该任务报表将改为使用“普通”： {name}

“低”和“中”报表质量不受支持。

解决办法：手动更新质量设置。请参阅：[图像质量](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/ReportsDevelopment/Image-quality.htm) （仅提供英文版本）。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### “打印机复印件配置”选项不受支持

Qlik NPrinting November 2019 或更新的版本无法将所生成的报表直接发送至打印机。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### NPrinting 16 任务输出文件夹设置为“任务输出文件夹”

未导入 QlikView NPrinting 16 目的地，您必须手动将它们添加至所导入的任务。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### NPrinting 16 任务输出文件夹设置为“收件人文件夹”

未导入 QlikView NPrinting 16 目的地，您必须手动将它们添加至所导入的任务。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### NPrinting 16 任务输出文件夹设置为“带收件人子文件夹的任务文件夹”

未导入 QlikView NPrinting 16 目的地，您必须手动将它们添加至所导入的任务。

[](https://help.qlik.com/en-US/nprinting/Content/NPrinting/Migrate/Troubleshoot-migration.htm)

#### NPrinting 16 任务输出文件夹设置为“自定义文件夹”

未导入 QlikView NPrinting 16 目的地，您必须手动将它们添加至所导入的任务。

## 了解详情

* [计划您的迁移](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/Migrate/Before-you-migrate.htm)