# 导入用户

您可使用相关的过滤器和组从 Excel 文件、LDAP 源或二者的组合导入用户。

我们建议为每组用户、组和筛选器设置一个导入任务。同一实体可有不同的来源。例如：一个 Excel 文件用于管理人员，一个 Excel 文件用于供应商，两个文件都有一个共同的组或筛选器。这两个来源都应附加到同一导入任务中。您可以根据需要更改 Excel 和 LDAP 源的路径。

您应该一次运行一个导入任务。如果同时运行多个导入任务，可能会出现冲突，任务有可能会失败。

提示注释您可每天在同名文件中更新 Qlik NPrinting 组、用户和筛选器信息，并将其加载到相同的收件人导入任务路径位置。

## 限制

在导入时存在一些限制：

* 不能使用 LDAP 导入筛选器。您必须使用 Excel 文件。
* 您无法使用 LDAP 导入备用电子邮件。您必须使用 Excel 文件。
* 如果需要创建或删除安全角色，必须在 Qlik NPrinting web 控制台 中手动进行。请参阅：[管理角色](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/DeployingQVNprinting/Managing-roles.htm)
* 您可以从 LDAP 林、树和域导入与 Qlik NPrinting 服务器不同的内容。但是，不支持林之间的交叉成员关系。
* 从 LDAP 导入用户时，不提供地域和时区值。以这种方式导入的用户默认使用英语和 UTC。通过从 Excel 文件导入用户或手动更改，可以设置不同的地域和时区值。通过 LDAP 再次导入相同的用户不会覆盖地域和时区值。

通过 Excel 导入用户时存在一些限制：

* 如果在行中添加的组、角色或筛选器不存在，将会忽略它们。

* 如果过滤器、用户或角色名称包含逗号，可使用双引号作为分隔符。示例："Jeremy Martinson, Jr."

* 如果字段值包含双引号、前置/后置空格或“`{`”、“`}`”，则必须以双引号开始和结束字符串。必须将双引号字符插入两次以将它们与转义引号区分开。

  示例：

  * `[Country]={" Italy, France ", "Germany",Spain} => " Italy, France ","Germany","Spain"` `[Country]={"""Italy"""} => ""Italy""` `[Country]={"{Sweden}"} => {Sweden}`

* 为了导入具有前置/后置空格的字段，您必须以方括号开始和结束字符串。

  示例：[ Country ]={Italy}, CountryBorn ={Italy} => " Country "={Italy}, "CountryBorn"={Italy}

* 不能插入“`[`”、“`]`”作为字段名。

* 添加具有有效的名称和空值列表的字段（值、数值或公式列）可让您删除现有筛选器字段。必须选中如果修改则更新筛选器复选框。

  示例：

  * 忽略 `[Country] =>` 输入
  * 已删除名称国家的 `[Country]={} =>` 筛选字段

## 导入 Excel 文档中的语法

您必须创建具有以下工作表和列上的确切名称的 Excel 文件。您无法对列重新排序或删除列。您不能重新排列或删除工作表。

如果您需要具有示例用户的 Excel 文件来进行测试：请访问 [示例文件](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Examples/Examples.htm)，下载 Examples.zip，并打开 Recipients.xls。

### 导入过滤器语法

第一个工作表包含筛选器定义。如果值或公式包含逗号，可使用双引号作为分隔符。例如：`[SalesmanName]={"Jeremy Martinson, Jr.", Tom Lindwall}`。

如果筛选器使用选择排除 功能排除值，请在结束值处添加`<excluded>`。例如：`[CategoryName]={Babywear, Men´s Wear, Women's Wear}<excluded>`

从 `<override>` 导入筛选器字段时，可使用 Excel 属性，并启用覆盖值标记。例如：

* `[Country]={Sweden}<override>` `[Country]={"France"}<override,excluded>`

过滤器

| 属性 | 必需？ | 描述 | 示例 |
| --- | --- | --- | --- |
| 名称 | 必需 | 筛选器的名称。 | 季度销售额 |
| 描述 | 可选 | 筛选器的用途。 | 当前季度的销售额。 |
| 应用 | 必需 | 和过滤器关联的应用程序名称。应用程序必须存在于服务器上。 | SalesDemoApp |
| 启用 | 必需 | 如果您希望创建活动的筛选器，则设置为 `TRUE`。设置为 `FALSE` 可创建不活动的筛选器，该筛选器将在报告生成期间被忽略。 | 真 |
| 连接 | 必需 | 连接的名称。通过指定该项，您可根据具有来自同一应用程序中不同连接的相同名称的字段创建不同的过滤器。连接必须存在于服务器上。 | SalesDemoConnection |
| 值 | 可选 | 用于筛选字符串值。以 [field name]={value1,value2,...} 形式列出它们。要为多个字段添加值，可用逗号分隔它们。要排除值，可在末尾添加 `<excluded>`。 | `[Country]={Italy,Germany,Spain}, [CategoryName]={Babywear, Men´s Wear, Women's Wear}` |
| 数值 | 可选 | 用于筛选数值。以 [field name]={value1,value2,...} 形式列出它们。 | `CategoryID={1.0,"5",8.2}` |
| 公式 | 可选 | 用于通过使用 QlikView 公式，来计算要过滤的值。以以下形式列出它们：[field name]={formula1,formula2,...}。 | `Year={Year(now()), Year(now())-1,Year(now())-2}` |
| 高级搜索 | 可选 | 使用 QlikView 或 Qlik Sense 高级搜索表达式筛选数值。以 [field name]={advancedformula1,advancedformula2,...} 形式列出它们。 | `ProductName={=ProductName like '*Shoes*'}` |
| 变量 | 可选 | 用于创建基于变量的筛选器。用逗号分隔多个条目。<br><br>[VariableName]={FixedValue} 将变量设置为固定值。<br><br>[VariableName]={"=Formula()"}&lt;evaluate&gt; 使用公式计算变量值。 | `vSales= Sum(Sales)` |

### 导入用户语法

第二个工作表包含用户定义。

在备用电子邮件字段，您可以添加多个电子邮件地址，以分号分隔。您的电子邮件提供商确定每个字段可以添加多少个地址。

用户

| 属性 | 必需？ | 描述 | 示例 |
| --- | --- | --- | --- |
| 电子邮件 | 必需 | 用户的唯一电子邮件地址。它将用于登录。 | john\_brown@qlik.com |
| 用户名 | 必需 | 显示在界面上的标识用户的唯一用户名。<br><br>如果您将具有相同名称的用户作为现有用户导入，导入将会覆盖现有用户。如果您以并非用户的现有实体的形式（组、角色）导入具有相同名称的用户，则会出错。如果您以现有用户的形式导入具有相同名称的组，会出现相同错误。 | John Brown |
| 密码 | 必需 | 用户用于登录 Qlik NPrinting 的密码。 | testpass |
| 域帐户 | 可选 | 分配给用户的唯一域名帐户。<br><br>用户必须具备关联的域帐户方可使用以下功能：<br><br><ul><li>在 <span>Qlik Sense</span> 应用中心中接收报表。</li><li><p>在 <span>QlikView</span> 中创建 <span>On-Demand</span> 报表。</p><p>用户的 Windows Active Directory 用户帐户必须作为域帐户关联。</p></li></ul> | JohnBrown33 |
| 启用 | 必需 | 如果您希望创建活动的用户，则设置为 `TRUE`。设置为 `FALSE` 可创建不活动的用户，该筛选器将在报告生成期间被忽略。 | 真 |
| 时区： | 必需 | 根据用户的时区来计划报告发布。您必须键入和其在 Qlik NPrinting 界面中所显示名称一样的名称。 | 欧洲/罗马 |
| 区域设置 | 必需 | Qlik NPrinting 的显示语言。有八个选项：<br>En（英语）、Es（西班牙语）、Fr（法语）、De（德语）、Pt（葡萄牙语）、Ja（日语）、It（意大利语）、Zh（简体中文）。 | It |
| 描述 | 可选 | 用户的描述。 | 帐户管理员 Vicenza。 |
| 昵称 | 可选 | 用户的昵称。 | JoBrown |
| 标题 | 可选 | 用户的头衔。 | 先生 |
| 公司 | 可选 | 用户的公司。 | Qlik |
| 职称 | 可选 | 用户的工作头衔。 | 帐户管理员 |
| 部门 | 可选 | 用户的部门。 | 销售额 |
| 办公室 | 可选 | 用户的办公室。 | 第 1 层，维琴察 |
| 文件夹 | 可选 | 用户可访问的报表目标文件夹。 | C:\QlikReportingTraining\Output\ |
| 子文件夹 | 可选 | 用户可访问的报告目标子文件夹。 | John Brown |
| 备用电子邮件 1 | 可选 | 报告目的地电子邮件。可以包含多个地址，以分号分隔。 | john.brown@qlik.com |
| 备用电子邮件 2 | 可选 | 报告目的地电子邮件。可以包含多个地址，以分号分隔。 | j.br@qlik.com |
| 备用电子邮件 3 | 可选 | 报告目的地电子邮件。可以包含多个地址，以分号分隔。 | salestraining@qlik.com, salestraining@qlik.eu |
| 读取密码 | 可选 | 打开报告所需的密码。如果没有指定密码，将对该用户禁用凭据验证。 | password33 |
| 写入密码 | 可选 | 编辑报告所需的密码。如果没有指定密码，将对该用户禁用凭据验证。 | password44 |
| 过滤器 | 可选 | 用户可访问的筛选器列表，以逗号分隔。 | 季度销售额 |
| 群组 | 可选 | 用户属于其成员的组列表，以逗号分隔。 | 营销团队、销售团队 |
| 角色 | 可选 | 用户安全角色列表，以逗号分隔。 | 开发人员、管理员 |

### 导入组语法

第三个工作表包含组定义。

群组

| 属性 | 必需？ | 描述 | 示例 |
| --- | --- | --- | --- |
| 名称 | 必需 | 组的名称。 | 营销团队 |
| 描述 | 可选 | 组的用途。 | 全球营销团队 |
| 启用 | 必需 | 如果您希望创建活动的组，则设置为 `TRUE`。设置为 `FALSE` 可创建不活动的组，该筛选器将在报告生成期间被忽略。 | 真 |

## 导入 LDAP 源中的语法

[查看视频短片](https://play.vidyard.com/2huooLc6iL2fs7eatEULfL)

### 连接语法

连接

| 属性 | 必需？ | 描述 | 默认值 |
| --- | --- | --- | --- |
| 连接路径 | 必需 | URI 用于连接至目录服务器。要支持 SSL，可改为将协议指定为 LDAPS。当前，仅对 Active Directory 支持 LDAPS。您可添加可分辨的名称 (DN) 来更改起始容器：ldap[s]://[server address[:port]/][dn] | ldap://company.domain.com |
| 用户名 | 可选 | 用户 ID 用于连接至目录服务器。如果此项为空，则运行储存库的用户用于登录目录服务器。 | - |
| 密码 | 可选 | 用户的密码。 | - |
| 用户目录名称 | 必需 | UDC 实例的名称（用于和 Active Directory 的域名比较）。如果将该字段留空，则会对其填充 Active Directory 服务器内的正确域名，或者是填写可分辨的名称的第一个 DC 组件。 | - |

### 空属性语法

条目属性应反映 LDAP 服务器的属性名称。

条目属性

| 属性 | 必需？ | 描述 | 默认值 |
| --- | --- | --- | --- |
| 类型 | 必需 | 可导入的类型为：用户、组和角色。 | objectClass |
| 用户标识 | 必需 | 标识用户的目录实体的属性值。可假设属性按类型指定的值。 | inetOrgPerson |
| 组标识 | 必需 | 标识组的目录的属性值。可假设属性按类型指定的值。 | 群组 |
| 角色标识 | 必需 | 标识角色的目录实体的属性值。可假设属性按类型指定的值。 | 群组 |
| 帐户名称 | 必需 | 指定用户用于登录的唯一名称的属性。 | sAMAccountName |
| 电子邮件 | 必需 | 保留目录实体（用户）的电子邮件的属性名称。 | 邮件 |
| 显示名称 | 必需 | 保留目录实体（用户、组、角色）的全名的属性。 | 名称 |
| 组成员关系 | 必需 | 指示目录实体属于其成员的直接组的属性。在用户同步期间会解析间接组成员。 | memberOf |
| 目录实体成员 | 必需 | 保留对于该目录实体的直接成员的引用的属性名称。 | 成员 |
| 角色成员 | 必需 | 指示目录实体保留的直接安全角色的属性。在用户同步期间会解析间接安全角色。 | memberOf |

### 高级语法

高级

| 属性 | 必需？ | 描述 | 默认值 |
| --- | --- | --- | --- |
| 超时（秒） | 可选 | 读取来自数据源的数据的超时时间。 | 240 |
| 搜索页面大小 | 可选 | 在读取来自数据源的数据时确定所检索文章的数目。当指定的文章数已经找到时，搜索会停止并返回结果。在搜索重新启动之后，会在离开之处继续。<br><br>提示注释 如果用户同步不成功，可尝试将值设置为 '0'（零），这等同于不进行分页搜索。 | 2000 |
| 备选组路径 | 可选 | 将不同的目录条码用作组搜索的起点的可分辨的名称。 | - |
| 备选角色路径 | 可选 | 将不同的目录条码用作角色搜索的起点的可分辨的名称。 | - |
| 其他用户筛选器 | 可选 | LDAP 查询用于检索目录中的用户。 | - |
| 其他组筛选器 | 可选 | LDAP 查询用于检索目录中的组。 | - |
| 其他角色筛选器 | 可选 | LDAP 查询用于检索目录中的角色。 | - |

### Active directory

激活目录用户应将用户标识值从 inetOrgPerson 更改为用户或个人。默认行为是导入所有组。如果要导入特定组，请使用替代组路径或附加组筛选器字段。

## 合并导入源数据

合并策略是指当合并来自导入步骤的数据和之前步骤的结果时应用的规则。导入源数据合并结果的 Qlik NPrinting 储存库中的同步不使用合并策略。它们基于您的导入任务设置。请参阅：[创建导入任务](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/DeployingQVNprinting/Import-Users-Filters.htm#Creating)。

### 用户合并密钥

此项指定用于标识何时从导入源检索的用户涉及现有用户的用户字段。用于合并用户数据的算法基于实体和关联合并策略。为了对比 Qlik NPrinting 储存库匹配导入的实体，则始终会使用用户名，因此不会考虑该合并密钥。

### 实体合并策略

此项指定用于将检索自不同导入源的数据合并的算法，这些导入源涉及相同的实体（用户、组或筛选器）。它不适用于将关联映射至另一实体（用户筛选器、角色和组以及筛选器字段）的字段。

支持的值为 Overwrite、Update missing 和 Ignore。检索自之前导入源的数据为：

* Overwrite：通过最近的导入删除和替换。存在于之前步骤中但不存在于最新步骤中的列不会更改。
* Update missing：被忽略，但不存在于之前导入任务中的值除外，这些值会被添加。这适用于遗漏的列，而非空单元格。
* Ignore：被忽略。

### 关联合并策略

此项指定用于将检索自不同导入源的数据合并的算法，这些导入源涉及相同的实体（用户、组或筛选器）。它适用于将关联映射至另一实体（用户筛选器、角色和组以及筛选器字段）的字段。

支持的值为 Overwrite、Merge 和 Ignore。检索自之前导入步骤的实体的列表为：

* Overwrite：通过最近的导入删除和替换。存在于之前步骤中但不存在于最新步骤中的列不会更改。
* Merge：被合并。
* Ignore：被忽略。

## 将导入权限分配至安全角色

要导入用户，必须以拥有至少一个安全角色的导入任务权限的用户身份登录到 Qlik NPrinting web 控制台。具有管理员角色的用户拥有导入任务权限。如果对用户应用管理员角色，则他们也将拥有所有其他管理权限。

您还可将导入权限分配至安全角色，而不用对其提供其他管理权限。

进行以下操作：

1. 以具有管理员安全角色的用户身份登录到Qlik NPrinting web 控制台。

2. 在 Qlik NPrinting 主菜单中，单击管理员下拉菜单。

3. 单击安全角色。

4. 单击要给予导入任务权限的角色。

5. 单击应用程序选项卡。

6. 滚动到导入任务权限复选框。

7. 选中导入任务左侧的复选框，向角色分配所有导入任务权限。

   您也可以通过选中相应的复选框来仅选择特定权限。

8. 单击保存。

## 创建导入任务

进行以下操作：

1. 在 Qlik NPrinting 主菜单选择任务，然后选择导入任务。

2. 单击创建导入任务。

3. 插入任务的名称。例如：Import Users。

4. 确保选中启用复选框。否则，您的任务将被 Qlik NPrinting Engine 忽略。

5. 在源下，单击添加源。在下拉菜单中，选择从 Excel 导入或从 LDAP 导入。

6. 后续步骤将取决于源类型：

   1. Excel：添加其中保存 文件的 的Qlik NPrinting Server导入文件路径（在服务器上）Excel。

      例如：C:\ProgramData\NPrinting\Imports\NP\_Web\_Imports.xlsx。这并非您本地计算机上的文件路径。

      您还可使用远程计算机网络路径。运行 Windows 的 Qlik NPrinting 排程器服务 用户必须有从 Qlik NPrinting Server 访问远程文件夹的权限。请参阅：[导入 Excel 文档中的语法](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/DeployingQVNprinting/Import-Users-Filters.htm#Import2)。

   2. LDAP：添加 源的连接路径LDAP。

      您可根据需要填写其他字段。请参阅：[导入 LDAP 源中的语法](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/DeployingQVNprinting/Import-Users-Filters.htm#Import)。

7. 确保选中启用复选框。否则您的源将被 Qlik NPrinting Engine 忽略。

8. 单击添加源以添加另一个源。

9. 单击the 删除 icon（位于右侧）来删除源。单击the 复制 icon 以复制它。

10. 在设置下，选择指定您所需的处理合并冲突的方式的复选框：

    * 如果没有用户则创建用户

    * 如果用户有改动则更新用户

    * 删除没有存在于最新导入源中的用户

      将仅删除在相同导入上次运行中添加的用户。其他用户，例如手动添加的用户，将不会被删除。

    * 替换现有用户关联（筛选器、角色和组）

      如果现有用户关联未存在于导入文件中，则将删除现有用户关联。它们将替换为新文件中的关联。

    * 删除没有存在于最新导入源中的组

      将仅删除在相同导入上次运行中添加的组。其他组，例如手动添加的用户，将不会被删除。

    * 如果不存在过滤器则创建过滤器

    * 如果修改了筛选器则更新筛选器

    * 删除没有存在于最新导入源中的筛选器

      将删除在相同导入上次运行中添加的筛选器。其他筛选器，例如手动添加的筛选器，将不会被删除。

    * 替换现有筛选器字段

      如果现有筛选器字段没有存在于导入文件，则将把它们删除。它们将会被替换为来自导入文件的筛选器字段。

11. 在通知下，您可以选择发送任务通知。一封电子邮件将被发送至在设置 &gt; 任务下指定的地址。请参阅：[任务执行通知](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/AdministeringQVNprinting/Tasks/Task-executions.htm#Sending)。

12. 单击创建。

## 运行导入任务

在表顶部的绿色条确认任务成功创建。有不同的运行任务的方式。

进行以下操作之一：

* 单击立即运行立即导入用户、筛选器和组。

* 单击马上测试来测试任务。此项将运行虚拟导入，生成具有结果的 .txt 文件。由此可在运行导入前检查合并冲突。

* 单击触发器按钮来计划任务的执行。请参阅：[创建分布计划](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/DistributionSchedulesAutomation/Distribute-User-Specific.htm#Creating)。

  ![成功创建 NPrinting 导入任务](https://help.qlik.com/zh-CN/nprinting/May2026/Content/Resources/Images/UI_NPImportTask.png)

## 检查任务状态

在导入筛选器和收件人任务主页面上，可看到导入任务的状态。

* 上次执行：示出上次执行的日期和时间。

* 上次执行状态：如果成功运行任务，则它会显示为已完成。否则，其将显示为失败。

* 上次执行进度：显示有效任务的进展程度。

* 上次导入日志：单击下载链接以查看和任务关联的最新日志。

  如果在导入期间出错，日志文件将以执行导入的计算机当前区域设置显示错误消息。所有用户的导入将在出现首个错误时停止，并且整个导入会回滚。日志文件下载包含每个导入操作的日志行。任务执行日志仅包含主日志，诸如错误和进度信息。

* 已启用：如果未选中该复选框，则您的任务将被 Qlik NPrinting Engine 忽略。

* 操作：单击the 设置 icon 来编辑、删除、运行或测试任务。

在用户页面上检查导入的用户，查看新创建的用户。您可通过打开过滤器选项卡检查已创建的相关过滤器。

## 了解详情

* [创建用户](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/Recipients&Users/Create-users-filters-groups.htm)
* [管理实体](https://help.qlik.com/zh-CN/nprinting/May2026/Content/NPrinting/AdministeringQVNprinting/Manage-entities.htm)