导入用户

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

导入 Excel 文档中的语法

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

如果您需要具有示例用户的 Excel 文件来进行测试:请访问 示例文件,下载 Examples.zip,并打开 Recipients.xls

导入过滤器语法

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

过滤器
属性 描述 示例
名称 过滤器的名称。 季度销售额
描述 过滤器的用途。(可选) 当前季度的销售额。
应用程序 和过滤器关联的应用程序名称。应用程序必须存在于服务器上。 SalesDemoApp
启用 如果您希望创建活动的过滤器,则设置为 TRUE。设置为 false 可创建不活动的过滤器,该过滤器将在报表生成期间被忽略。
连接
  • 连接的名称。通过指定该项,您可根据具有来自同一应用程序上不同连接的相同名称的字段创建不同的过滤器。连接必须存在于服务器上。
  • SalesDemoConnection
    用于筛选字符串值。以 [field name]={value1,value2,...} 的形式列出它们。要为多个字段添加值,可用逗号分隔它们。 [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}

    导入用户语法

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

    用户
    属性 描述 示例
    电子邮件 用户的唯一电子邮件地址。它将用于登录。 john_brown@qlik.com
    用户名 显示在界面上的标识用户的唯一用户名。

    如果您将具有相同名称的用户作为现有用户导入,导入将会覆盖现有用户。如果您以并非用户的现有实体的形式(组、角色)导入具有相同名称的用户,则会出错。如果您以现有用户的形式导入具有相同名称的组,会出现相同错误。

    John Brown
    密码 用户用于登录 Qlik NPrinting 的密码。 testpass
    域帐户 分配给用户的唯一域名帐户。(可选)

    用户必须具备关联的域帐户方可使用以下功能:

    • Qlik Sense 应用中心中接收报表。
    • QlikView 中创建 On-Demand 报表。

      用户的 Windows Active Directory 用户帐户必须作为域帐户关联。

    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
    读取密码 打开报表所需的密码。如果没有指定密码,将对该用户禁用凭据验证。(可选) password33
    写入密码 编辑报表所需的密码。如果没有指定密码,将对该用户禁用凭据验证。(可选) password44
    过滤器 用户可访问的过滤器列表,以逗号分隔。(可选) 季度销售额
    群组 用户属于其成员的组列表,以逗号分隔。(可选) 营销团队、销售团队
    角色 用户安全角色列表,以逗号分隔。(可选) 开发人员、管理员

    限制

    在导入用户时存在一些限制:

    • 如果在行中添加的组、角色或过滤器不存在,将会忽略它们。
    • 如果过滤器、用户或角色名称包含逗号,可使用双引号作为分隔符。示例:“Jeremy Martinson, Jr.”

    • 如果过滤器、用户或角色的名称包含双引号或前置/后置空格,则必须以双引号开始和结束字符串。必须将双引号字符插入两次以将它们与转义引号区分开。

      示例:

      • [Country]={" Italy, France ", "Germany",Spain} => " Italy, France ","Germany","Spain"
      • [Country]={"""Italy"""} => ""Italy""
    • 为了导入具有前置/后置空格的字段,您必须以方括号开始和结束字符串。

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

    • 您无法插入 "[", "]" 和 "=" 作为字段名称或插入 "{", "}" 作为字段值。

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

      示例:

      • [Country] => 忽略输入
      • [Country]={} => 筛选移除了国家名称的字段

    导入组语法

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

    群组
    属性 描述 示例
    名称 组的名称。 营销团队
    描述 组的用途。(可选) 全球营销团队
    启用 如果您希望创建活动的组,则设置为 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 组件。 -

    空属性语法

    条目属性
    属性 描述 默认值

    类型

    可导入的类型为:用户、组和角色。 objectClass
    用户标识

    标识用户的目录实体的属性值。可假设属性按类型指定的值。

    inetOrgPerson
    组标识 标识组的目录的属性值。可假设属性按类型指定的值。 群组
    角色标识 标识角色的目录实体的属性值。可假设属性按类型指定的值。 群组
    帐户名称 指定用户用于登录的唯一名称的属性。 sAMAccountName
    电子邮件 保留目录实体(用户)的电子邮件的属性名称。 邮件
    显示名称 保留目录实体(用户、组、角色)的全名的属性。 名称
    组成员关系

    指示目录实体属于其成员的直接组的属性。在用户同步期间会解析间接组成员。

    memberOf
    目录实体成员

    保留对于该目录实体的直接成员的引用的属性名称。

    成员
    角色成员 指示目录实体保留的直接安全角色的属性。在用户同步期间会解析间接安全角色。 memberOf

    高级语法

    高级
    属性 描述 默认值
    超时(秒) 读取来自数据源的数据的超时时间。 240
    搜索页面大小

    在读取来自数据源的数据时确定所检索文章的数目。

    提示: 如果用户同步不成功,可尝试将值设置为 '0'(零)。

    2000

    备选组路径 将不同的目录条码用作组搜索的起点的可分辨的名称。 -
    备选角色路径 将不同的目录条码用作角色搜索的起点的可分辨的名称。 -
    其他用户筛选器 LDAP 查询用于检索目录中的用户。 -
    其他组筛选器 LDAP 查询用于检索目录中的组。 -
    其他角色筛选器 LDAP 查询用于检索目录中的角色。 -

    合并导入源数据

    合并策略是指当合并来自导入步骤的数据和之前步骤的结果时应用的规则。导入源数据合并结果的 Qlik NPrinting 储存库中的同步不使用合并策略。它们基于您的导入任务设置。请参阅:创建导入任务

    用户合并密钥

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

    实体合并策略

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

    支持的值为 OverwriteUpdate missingIgnore。检索自之前导入源的数据为:

    • Overwrite:通过最近的导入删除和替换。存在于之前步骤中但不存在于最新步骤中的列不会更改。
    • Update missing:被忽略,但不存在于之前导入任务中的值除外,这些值会被添加。
    • Ignore:被忽略。

    关联合并策略

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

    支持的值为 OverwriteMergeIgnore。检索自之前导入步骤的实体的列表为:

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

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

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

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

    进行以下操作:

    1. 以具有管理员安全角色的用户身份登录到 Qlik NPrinting web console
    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:添加其中保存 Excel 文件的 Qlik NPrinting Server导入文件路径(在服务器上)。例如:C:\ProgramData\NPrinting\Imports\NP_Web_Imports.xlsx。这并非您本地计算机上的文件路径。请参阅:导入 Excel 文档中的语法
      2. LDAP:添加 LDAP 源的连接路径

        您可根据需要填写其他字段。请参阅:导入 LDAP 源中的语法

    7. 确保选中启用复选框。否则您的源将被 Qlik NPrinting Engine 忽略。
    8. 单击添加源以添加另一个源。
    9. 单击右侧的 Ö 来删除源。单击 以复制它。
    10. 设置下,选择指定您所需的处理合并冲突的方式的复选框:
      • 如果没有用户则创建用户
      • 如果用户有改动则更新用户
      • 删除没有存在于最新导入源中的用户

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

      • 替换现有用户关联(筛选器、角色和组)

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

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

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

      • 如果不存在过滤器则创建过滤器
      • 如果修改了过滤器则更新过滤器
      • 删除没有存在于最新导入源中的筛选器

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

      • 替换现有筛选器字段

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

    11. 单击创建

    运行导入任务

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

    进行以下操作之一:

    • 单击立即运行立即导入用户、过滤器和组。
    • 单击马上测试来测试任务。此项将运行虚拟导入,生成具有结果的 .txt 文件。由此可在运行导入前检查合并冲突。
    • 单击触发器按钮来计划任务的执行。请参阅:创建分布计划

      NPrinting import task successfully created

    检查任务状态

    导入过滤器和收件人任务主页面上,可看到导入任务的状态。

    • 上次执行:示出上次执行的日期和时间。
    • 上次执行状态:如果成功运行任务,则它会显示为已完成。否则,其将显示为失败
    • 上次执行进度:显示有效任务的进展程度。
    • 上次导入日志:单击下载链接以查看和任务关联的最新日志。

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

    • 已启用:如果未选中该复选框,则您的任务将被 Qlik NPrinting Engine 忽略。
    • 操作单击 V 来编辑、删除、运行或测试任务。

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

    See also: