导入用户
您可使用相关的过滤器和组从 Excel 文件、LDAP 源或二者的组合导入用户。
我们建议您每个用户、组和过滤器集合有一个导入任务。对于相同的实体可具有不同的源。例如：一个用于经理的 Excel 文件以及一个用于供应商的 Excel 文件，其中两个文件都有共用的组或过滤器。这两个源都应当附接至相同导入任务。在需要时，您可更改您 Excel 和 LDAP 源的路径。
您应该一次运行一个导入任务。如果同时运行多个导入任务，则可能会出现冲突，并且任务可能会失败。
限制
在导入时存在一些限制：
- 您不能使用 LDAP 导入过滤器。您必须使用 Excel 文件。
- 您无法使用 LDAP 导入备选电子邮件。您必须使用 Excel 文件。
- 如果您需要创建或删除安全角色，则必须在 Qlik NPrinting web 控制台 中手动执行该操作。请参阅： 管理角色 （仅提供英文版本）
- 您可从 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 文件来进行测试：请访问 示例文件 （仅提供英文版本），下载 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*'} |
| 变量 | 可选 |
用于创建基于变量的过滤器。用逗号分割多个条目。 [VariableName]={FixedValue} 用于将变量设置为固定值。 [VariableName]={"=Formula()"}<evaluate> 用于使用公式来计算变量的值。 |
vSales= Sum(Sales) |
导入用户语法
第二个工作表包含用户定义。
在备用电子邮件 字段，您可以添加多个电子邮件地址，以分号分隔。您的电子邮件提供商确定每个字段可以添加多少个地址。
| 属性 | 必填？ | 说明 | 示例 |
|---|---|---|---|
| 电子邮件 | 所需 | 用户的唯一电子邮件地址。它将用于登录。 | john_brown@qlik.com |
| 用户名 | 所需 | 显示在界面上的标识用户的唯一用户名。 如果您将具有相同名称的用户作为现有用户导入，导入将会覆盖现有用户。如果您以并非用户的现有实体的形式（组、角色）导入具有相同名称的用户，则会出错。如果您以现有用户的形式导入具有相同名称的组，会出现相同错误。 |
John Brown |
| 密码 | 所需 | 用户用于登录 Qlik NPrinting 的密码。 | testpass |
| 域帐户 | 可选 | 分配给用户的唯一域名帐户。 用户必须具备关联的域帐户方可使用以下功能：
|
JohnBrown33 |
| 启用 | 所需 | 如果您希望创建活动的用户，则设置为 TRUE。设置为 false 可创建不活动的用户，该过滤器将在报表生成期间被忽略。 | TRUE |
| 时区： | 所需 | 根据用户的时区来计划报表发布。您必须键入和其在 Qlik NPrinting 界面中所显示名称一样的名称。 | Europe/Rome |
| 区域设置 | 所需 | Qlik NPrinting 的显示语言。有八个选项：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 可创建不活动的组，该过滤器将在报表生成期间被忽略。 | TRUE |
导入 LDAP 源中的语法
连接语法
| 属性 | 必填？ | 说明 | 默认值 |
|---|---|---|---|
| 连接路径 | 所需 | 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 |
| 搜索页面大小 | 可选 |
在读取来自数据源的数据时确定所检索文章的数目。当指定的文章数已经找到时，搜索会停止并返回结果。在搜索重新启动之后，会在离开之处继续。 提示注释 如果用户同步不成功，可尝试将值设置为 '0'（零），这等同于不进行分页搜索。
|
2000 |
| 备选组路径 | 可选 | 将不同的目录条码用作组搜索的起点的可分辨的名称。 | - |
| 备选角色路径 | 可选 | 将不同的目录条码用作角色搜索的起点的可分辨的名称。 | - |
| 其他用户筛选器 | 可选 | LDAP 查询用于检索目录中的用户。 | - |
| 其他组筛选器 | 可选 | LDAP 查询用于检索目录中的组。 | - |
| 其他角色筛选器 | 可选 | LDAP 查询用于检索目录中的角色。 | - |
Active Directory
Active Directory 用户应当将用户标识值从 inetOrgPerson 更改为 user 或 person。默认行为是导入所有组。如果您希望导入特定组，可使用备选组路径或其他组筛选器字段。
合并导入源数据
合并策略是指当合并来自导入步骤的数据和之前步骤的结果时应用的规则。导入源数据合并结果的 Qlik NPrinting 储存库中的同步不使用合并策略。它们基于您的导入任务设置。请参阅：创建导入任务。
用户合并密钥
此项指定用于标识何时从导入源检索的用户涉及现有用户的用户字段。用于合并用户数据的算法基于实体和关联合并策略。为了对比 Qlik NPrinting 储存库匹配导入的实体，则始终会使用用户名，因此不会考虑该合并密钥。
实体合并策略
此项指定用于将检索自不同导入源的数据合并的算法，这些导入源涉及相同的实体（用户、组或过滤器）。它不适用于将关联映射至另一实体（用户过滤器、角色和组以及过滤器字段）的字段。
支持的值为 Overwrite、Update missing 和 Ignore。检索自之前导入源的数据为：
- Overwrite：通过最近的导入删除和替换。存在于之前步骤中但不存在于最新步骤中的列不会更改。
- Update missing：被忽略，但不存在于之前导入任务中的值除外，这些值会被添加。这适用于缺失的列，而非空单元格。
- Ignore：被忽略。
关联合并策略
此项指定用于将检索自不同导入源的数据合并的算法，这些导入源涉及相同的实体（用户、组或过滤器）。它适用于将关联映射至另一实体（用户过滤器、角色和组以及过滤器字段）的字段。
支持的值为 Overwrite、Merge 和 Ignore。检索自之前导入步骤的实体的列表为：
- Overwrite：通过最近的导入删除和替换。存在于之前步骤中但不存在于最新步骤中的列不会更改。
- Merge：被合并。
- Ignore：被忽略。
将导入权限分配至安全角色
要导入用户，必须以拥有至少一个安全角色的导入任务权限的用户身份登录到 Qlik NPrinting web 控制台。具有管理员角色的用户拥有导入任务权限。如果对用户应用管理员角色，则他们也将拥有所有其他管理权限。
您还可将导入权限分配至安全角色，而不用对其提供其他管理权限。
进行以下操作：
- 以具有管理员安全角色的用户身份登录到 Qlik NPrinting web 控制台。
- 在 Qlik NPrinting 主菜单中，单击管理员下拉菜单。
- 单击安全角色。
- 单击要给予导入任务权限的角色。
- 单击应用程序选项卡。
- 滚动到导入任务权限复选框。
- 选中导入任务左侧的复选框，向角色分配所有导入任务权限。
您也可以通过选中相应的复选框来仅选择特定权限。
- 单击保存。
创建导入任务
进行以下操作：
- 在 Qlik NPrinting 主菜单选择任务，然后选择导入任务。
- 单击创建导入任务。
-
插入任务的名称。例如：Import Users。
- 确保选中启用复选框。否则，您的任务将被 Qlik NPrinting Engine 忽略。
- 在源下，单击添加源。在下拉菜单中，选择从 Excel 导入或从 LDAP 导入。
- 后续步骤将取决于源类型：
Excel：添加其中保存 Excel 文件的 Qlik NPrinting Server 的导入文件路径（在服务器上）。
例如：C:\ProgramData\NPrinting\Imports\NP_Web_Imports.xlsx。这并非您本地计算机上的文件路径。
您也可使用远程计算机网络路径。运行 Qlik NPrinting 调度服务 的 Windows 用户必须具有来自 Qlik NPrinting Server 的远程文件夹的访问权限。请参阅：导入 Excel 文档中的语法。
LDAP：添加 LDAP 源的连接路径 。
您可根据需要填写其他字段。请参阅：导入 LDAP 源中的语法。
- 确保选中启用复选框。否则您的源将被 Qlik NPrinting Engine 忽略。
- 单击添加源以添加另一个源。
- 单击右侧的
以删除源单击 
以复制它。 - 在设置下，选择指定您所需的处理合并冲突的方式的复选框：
- 如果没有用户则创建用户
- 如果用户有改动则更新用户
删除没有存在于最新导入源中的用户
将仅删除在相同导入上次运行中添加的用户。其他用户，例如手动添加的用户，将不会被删除。
替换现有用户关联（筛选器、角色和组）
如果现有用户关联未存在于导入文件中，则将删除现有用户关联。它们将替换为新文件中的关联。
删除没有存在于最新导入源中的组
将仅删除在相同导入上次运行中添加的组。其他组，例如手动添加的用户，将不会被删除。
- 如果不存在过滤器则创建过滤器
- 如果修改了过滤器则更新过滤器
删除没有存在于最新导入源中的筛选器
将删除在相同导入上次运行中添加的过滤器。其他过滤器，例如手动添加的过滤器，将不会被删除。
替换现有筛选器字段
如果现有过滤器字段没有存在于导入文件，则将把它们删除。它们将会被替换为来自导入文件的过滤器字段。
- 在通知下，您可选择发送任务通知。一封电子邮件将被发送至在设置 > 任务下指定的地址。请参阅：任务执行通知 （仅提供英文版本）。
- 单击创建。
运行导入任务
在表顶部的绿色条确认任务成功创建。有不同的运行任务的方式。
进行以下操作之一：
- 单击立即运行立即导入用户、过滤器和组。
- 单击马上测试来测试任务。此项将运行虚拟导入，生成具有结果的 .txt 文件。由此可在运行导入前检查合并冲突。
-
单击触发器按钮来计划任务的执行。请参阅：创建分布计划 （仅提供英文版本）。
检查任务状态
在导入过滤器和收件人任务主页面上，可看到导入任务的状态。
- 上次执行：示出上次执行的日期和时间。
- 上次执行状态：如果成功运行任务，则它会显示为已完成。否则，其将显示为失败。
- 上次执行进度：显示有效任务的进展程度。
-
上次导入日志：单击下载链接以查看和任务关联的最新日志。
如果在导入期间出错，日志文件将以执行导入的计算机当前区域设置显示错误消息。所有用户的导入将在出现首个错误时停止，并且整个导入会回滚。日志文件下载包含每个导入操作的日志行。任务执行日志仅包含主日志，诸如错误和进度信息。
- 已启用：如果未选中该复选框，则您的任务将被 Qlik NPrinting Engine 忽略。
- 操作单击
来编辑、删除、运行或测试任务。
在用户页面上检查导入的用户，查看新创建的用户。您可通过打开过滤器选项卡检查已创建的相关过滤器。