连接至 QlikView 文档

您可连接至 QlikView 服务器上的您具有访问权限的任何 QlikView 文档。

备注: 该页面概述了如何将特定 QlikView 文档连接至 Qlik NPrinting。如果您在安装 Qlik NPrinting 并尝试连接至 QlikView 服务器或安装证书,请参阅:将 Qlik NPrinting 连接到 QlikView

不支持的 QlikView 文档

在您创建指向 QlikView 文档的连接之前,确保 QlikView 文档不会使用以下任何项目:

  • 交替状态
  • 工作表和文档触发器
  • Always one selected(始终选择一个)列表框属性
  • WebView 模式

    必须关闭 WebView 模式。请参阅:AJAX/WebView。

Qlik NPrinting 不能修改或删除这些选项。因此,在缓存生成期间以及生成报表时,Qlik NPrinting 可能没有连接的 QlikView 文档的整个数据集的访问权限。

如果您希望将 QlikView 文档用于这些不受支持的功能,请执行以下操作:

  1. 创建 QlikView 文档的副本。
  2. 从新的 QlikView 文档删除所有交替状态、工作表和文档触发器,以及 Always one selected(始终选择一个)列表框属性。确保已经关闭 WebView 模式。
  3. 将复制的 QlikView 文档用于报表。

要求

必须已经安装和激活 Qlik NPrinting 服务器和至少一个 Qlik NPrinting Engine

QlikView 文档的连接规则

以下规则适用于指向 QlikView 文档的连接:

  • 您可在单个 Qlik NPrinting 应用程序中创建指向多个 QlikView 文档的连接。
  • 连接不会在 Qlik NPrinting 应用程序之间共享。如果您希望将同一 QlikView 文档连接至多个 Qlik NPrinting 应用程序,您必须为每个创建连接。
  • QlikView 文档和 Qlik NPrinting 应用程序之间仅能创建一个连接。
  • 要创建连接,您的 QlikView 文档必须保存在以下位置的一个中:

    • 您的本地计算机
    • 共享的网络文件夹
    • 您有权限访问的 QlikView 服务器
    • QlikView 群集

连接状态的类型

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

  • 从不生成:连接从未被打开。
  • 挂起Qlik NPrinting 正在尝试连接。
  • 生成中Qlik NPrinting 已连接并正在导入元数据。
  • 已生成:已成功连接所有 Qlik NPrinting 引擎。
  • 错误:连接在所有可用引擎上失败。在失败两分钟后,Qlik NPrinting scheduler service 将尝试再次连接。

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

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

要了解有关连接状态和重新载入连接元数据的更多信息,请参阅:重新加载连接元数据

测试和故障排除

您可使用我们的 QlikView 示例文件 Sales Demo.qvwBudget.qvw 来测试自己的连接。要下载这些文件,请访问示例文件

有数种方式可解决警告错误连接失败状态。要开始,可打开您要排除故障的连接,并单击运行验证按钮。这将会为您提供可能问题的列表。这里是验证失败的示例,因为文档路径不正确:

您还可检查以下方面:

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

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

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

连接至本地 QlikView 文档

进行以下操作:

  1. 应用程序菜单中单击连接

    显示连接页面。

  2. 单击创建连接以打开新的连接窗口。
  3. 名称字段中,输入连接的名称。

    例如,输入 Sales Demo

  4. 应用程序下拉列表中,选择您要从其创建连接的 Qlik NPrinting 应用程序。

    例如,输入 Sales Demo

  5. 文档路径字段中,输入指向您要连接的 QlikView 文档的路径。

    例如,输入 C:\NPrintingServer\QlikViewDocuments\Samples\Sales Demo.qvw

    使用安装了 Qlik NPrinting 的计算机上的路径。

    警告: 映射的网络驱动器(例如 Z:\NPrintingServer\QlikViewDocuments)不受 Qlik NPrinting 支持。您必须使用 UNC(通用命名约定)路径,例如 \\ServerName\NPrintingServer\QlikViewDocuments
  6. 确保类型设置为本地
  7. 如果收到提示,为 QlikView 文档输入用户名和密码。

    如果您连接至具有Section Access的本地 QlikView 文档,您必须输入具有 ADMIN 角色的用户的凭据,否则缓存生成将以错误结束。不支持 Windows 域用户。必须在脚本中定义Section Access用户。我们建议您在没有过滤器的情况下使用用户,从而让缓存完成。

  8. 单击运行验证按钮。这确保您的连接有效。

    如果连接有效,将会看到“验证成功”消息。如果无效,您将看到以下消息:“检测到错误。请查看下列详细信息。”

  9. 一旦验证了您的连接设置,则单击创建。您将自动移动回连接菜单。
  10. 单击您的新连接。您将看到状态:缓存状态 - 生成中。这意味着 Qlik NPrinting 连接至 QlikView 并导入元数据。如果您有大型 QlikView 文档,这可能需要几分钟时间。

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

您现在将能够在连接屏幕上看到新连接。

备注: 无法撤消连接删除。您必须重新创建连接。

QlikView ServerQlikView Cluster 连接的前提条件

要使用 QlikView ServerQlikView Cluster 连接生成报表,需要满足以下条件:

  • 至少能够访问一个 QlikView Server
  • 运行 Qlik NPrinting Engine Windows 服务的 Windows 用户必须属于 QlikView Server 计算机上的 QlikView Administrators Windows 组。
  • 要为 NTFS 授权配置 Qlik NPrinting,必须在 Qlik Management Console 中对其进行配置。也就是说,Windows 操作系统会通过 NTFS 安全设置控制用户和组的文件(文档)访问权限。
  • 要为 DMS 授权 QlikView 控制的文件访问配置 Qlik NPrinting,请参阅JWT 身份验证

如果您同时在使用 section access,则还需要满足以下要求:

  • 要使用服务器身份验证,必须配置连接。
  • 必须在用户设置中配置域帐户,而不管在 Qlik NPrinting 常规设置中启用的身份验证类型如何。

连接至 QlikView Server 上的 QlikView 文档

备注: 您需要得到许可的 QlikView Server,并访问目标 QlikView 文档以打开 .qvw文件。
备注: 要将 Qlik NPrinting 连接至 QlikView 服务器的集群,必须使用 QlikView 管理员用户组管理 QlikView 安装中的验证。

进行以下操作:

  1. 应用程序菜单中单击连接

    显示连接页面。

  2. 单击创建连接

  3. 名称字段中,输入连接的名称。

    例如,输入 Sales Demo from Server

  4. 应用程序下拉列表中,选择您要从其创建连接的 Qlik NPrinting 应用程序。

    例如,选择 Sales Demo

  5. 类型行单击服务器按钮。

    出现 qvp:// 表。

  6. qvp:// 表中,插入 QlikView Server 地址,后接 .qvw 文件名。

    例如,ServerAddress/DocumentName.qvw

  7. 如果需要,选中连接需要身份验证复选框,然后选择服务器身份验证文档身份验证

    • 服务器身份验证:输入将用于连接至服务器的域用户凭据。使用以下格式:

      \用户名

      如果要在为特定用户生成报表时应用他们的section access,请启用为报表应用用户区域权限标记。

    • 文档身份验证:输入文档上具有管理权限的用户的用户名密码

  8. 单击运行验证按钮。这确保您的连接有效。

    如果连接有效,将会看到“验证成功”消息。如果无效,您将看到以下消息:“检测到错误。请查看下列详细信息。”

  9. 一旦验证了您的连接设置,则单击创建。您将自动移动回连接菜单。
  10. 单击您的新连接。您将看到状态:缓存状态 - 正在生成。这意味着 Qlik NPrinting 连接至 QlikView 并导入元数据。如果您有大型 QlikView 文档,这可能需要几分钟时间。

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

您现在将能够在连接屏幕上看到新连接。

连接至 QlikView Cluster 上的 QlikView 文档

Qlik NPrinting可连接至 QlikView Server 的群集。这可通过平衡 Qlik NPrinting Engine 以及 QlikView Server 的群集之间的工作服装实现报表生成优化。

备注: 要将 Qlik NPrinting 连接至 QlikView 服务器的集群,必须使用 QlikView 管理员用户组管理 QlikView 安装中的验证。

要创建指向 QlikView Server 的群集的连接,您需要:

  • QlikView Server 的至少一个活动的群集。

    如果您有多个群集,您将能够选择您要使用的一个群集。

  • 可从 Qlik NPrinting Engine 连接的 QMS 和 QVS 计算机。
  • 由用户运行的 Qlik NPrinting Engine 服务,该用户为:
    • 域用户。
    • 属于群集中所有节点上的 QlikView Administrators 安全组
    • 属于运行 QMS 的计算机上的 QlikView Management API 安全组。

      警告: QlikView在安装期间不会创建管理 API 安全组,因此必须手动创建和填充它们。

要配置 QlikView Cluster 连接,您需要以下信息,这些信息可以从 Qlik Management Console 中获得:

  • 群集地址和 ID 位于系统 > 设置下方。

    • 群集地址位于管理服务 > 摘要选项卡中。
    • 可通过在 QlikView Web Server 下选择 QVWS 服务器来找到群集 ID。群集 ID 位于常规选项卡的名称字段中。

您还将需要完整文档路径。这可在 QlikView Desktop 中找到。

进行以下操作:

  1. 通过选择文件 > 在服务器中打开,启动 QlikView Desktop 并打开您的文档。请勿使用本地路径来打开文档。
  2. 选择帮助 > 文档支持信息
  3. 文档信息下方,找到文档。您将看到以 qvp:// 开头的文本。
  4. 删除 qvp:// 以及服务器名称以获得完整文档路径

    • 如果其内容为 qvp://vmwin099.rdlund.qliktech.com/SalesDemo2017.qvw,则完整文档路径SalesDemo2017.qvw
    • 如果您的文档在子文件夹内,则它们必须是完整文档路径的一部分。例如,如果其内容为 qvp://vmwin099.rdlund.qliktech.com/AppDemo/Sales/SalesDemo2017.qvw,则完整文档路径AppDemo/Sales/SalesDemo2017.qvw

进行以下操作:

  1. 应用程序菜单中单击连接

    显示连接页面。

  2. 单击创建连接

  3. 名称字段中,输入连接的名称。
  4. 输入描述为可选操作。
  5. 应用程序下拉列表中,选择您要从其创建连接的 Qlik NPrinting 应用程序。
  6. 类型行单击群集按钮。

    显示相关表。

  7. 地址表中插入 QMS 的地址。
  8. 群集 ID 中输入您要连接的群集的名称。
  9. 输入完整文档路径

  10. 如果需要,激活连接需要身份验证标记,并输入您的身份
  11. 如果要在为特定用户生成报表时应用他们的section access,请激活为报表应用用户区域权限标记。
  12. 单击运行验证按钮。这确保您的连接有效。

    如果连接有效,将会看到“验证成功”消息。如果无效,您将看到以下消息:“检测到错误。请查看下列详细信息。”

  13. 一旦验证了您的连接设置,则单击创建。您将自动移动回连接菜单。
  14. 单击您的新连接。您将看到状态:缓存状态 - 正在生成。这意味着 Qlik NPrinting 连接至 QlikView 并导入元数据。如果您有大型 QlikView 文档,这可能需要几分钟时间。

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

您现在将能够在连接屏幕上看到新连接。

修改或删除连接

警告: 如果您尝试删除有关联的报表或过滤器的连接,则会看到警告弹出窗口,其中列出在删除后将变得无效的元素。

进行以下操作:

  1. 应用程序菜单中单击连接

  2. 单击您要修改或删除的连接。

    1. 要进行修改,执行所选修改,然后单击保存
    2. 进行删除:单击 Ö

      警告: 该操作无法撤消。