8.2 Web 客户端

在 Web 客户端中,您可以自定义对象属性、工作流程自动化表单和用户界面品牌化。正确实现后,属性和工作流程自定义将有助于在对象管理和自动化工作流程提交期间自动执行助理管理员任务。

8.2.1 自定义属性页

您可以按对象类型自定义助理管理员在其 Active Directory 管理角色中使用的对象属性表单。这包括创建和自定义基于 DRA 中内置的对象类型的新对象页面。您还可以修改内置对象类型的属性。

对象在 Web 控制台的“属性页”列表中明确定义,以便可以轻松识别内置的对象页面、自定义的内置页面以及不是内置并由管理员创建的页面。

自定义对象属性页

通过添加或去除页面、修改现有页面和字段以及为属性特性创建自定义处理程序,即可自定义对象属性表单。创建自定义处理程序后,它们便会在属性字段更改时或管理员响应运行查询的提示时自动执行,具体取决于自定义处理程序的配置方式。

“属性页”中的对象列表可为每种对象类型提供两种操作类型:创建对象和编辑属性。这些操作是助理管理员在 Web 客户端中执行的主要操作,您的自定义可以改善管理员在 DRA 中管理 Active Directory 对象时的效率和体验。

要在 Web 控制台中自定义对象属性页:

  1. 以 DRA 管理员身份登录到 Web 控制台。

  2. 导航到自定义 > 属性页。

  3. 在“属性页”列表中选择一个对象和操作类型(创建或编辑)。

  4. 单击编辑按钮 。

  5. 通过执行以下一项或多项操作来自定义对象属性表单,然后应用更改:

    • 添加新的属性页:添加页面

    • 选择一个属性页并自定义该页面:

      • 对页面中的配置字段进行重新排序:

      • 编辑字段或子字段:

      • 添加一个或多个字段: 或添加字段

      • 去除一个或多个字段:

    • 使用脚本、讯息框或查询(LDAP、DRA 或 REST)为属性创建自定义处理程序

      有关使用自定义处理程序的更多信息,请参见添加自定义处理程序。

创建新对象属性页

要创建新对象属性页:

  1. 以 DRA 管理员身份登录到 Web 控制台。

  2. 导航到自定义 > 属性页。

  3. 在“任务”下,单击创建新行为。

  4. 通过定义名称、图标、对象类型和操作配置来创建初始对象属性表单。

  5. 根据需要自定义新表单。请参见自定义对象属性页。

8.2.2 自定义工作流程表单

工作流程表单在创建或修改时将保存到 Web 服务器,并可在自定义 > 工作流程页的 Web 控制台中进行访问。这些表单用于提交在 Workflow Automation(工作流程自动化)服务器中创建的自动化工作流程。您可以自定义表单,以便在助理管理员使用表单执行对象管理任务时进一步自动化并提高表单可用性。

您可以添加和修改现有表单属性和自定义处理程序。在工作流程自动化表单中,添加和自定义属性的界面行为与自定义对象属性时相同。有关添加和修改属性、添加自定义处理程序以及了解工作流程自动化的更多信息,请参阅以下主题。

添加自定义处理程序

自定义处理程序在 DRA 中用于属性特性相互交互以完成工作流程任务,以及用于在工作流程、属性或创建表单中装载和提交自定义。

属性自定义处理程序的一些示例包括查询其他字段的值、更新值、切换字段的只读状态,以及根据配置的变量显示或隐藏字段。

使用表单装载处理程序,用户通常执行一些控件初始化即可自定义表单。表单提交处理程序允许用户进行一些验证,如果出现问题,则可能会取消提交。

DRA 还通过几个可选的 JavaScript (JS) 宏简化了自定义处理程序的创建,您可以在自定义处理程序创建和验证过程中选择这些宏。

创建自定义处理程序的基本步骤:

以下步骤从预先选择的自定义处理程序页面开始。为此,您可以通过属性字段上的编辑按钮 访问对象属性自定义处理程序。您可以从工作流程表单或创建对象页上的“表单属性”访问表单装载处理程序和表单提交处理程序。

  1. 单击相应的自定义处理程序选项卡并启用页面 。

    • 自定义处理程序

    • 表单装载处理程序

    • 表单提交处理程序

  2. 从下拉菜单中选择自定义处理程序,然后选择执行时间。一般情况下,您会使用“执行时间”的第二个或第三个选项。

    注:通常,您可能只需要一个自定义处理程序,但可以使用多个处理程序,方法是在脚本中配置流程控制以将处理程序链接在一起。

  3. 您需要配置 () 添加到页面的每个自定义处理程序。配置选项因处理程序类型而异,但所有处理程序均从 JavaScript 执行。

    您可以创建自己的 Vanilla JavaScript 条目或使用内置宏。

    • LDAP 或 REST 查询处理程序:

      1. 如果希望查询基于静态值,请定义连接信息和查询参数。

        如果希望查询是动态的,请在必填字段中输入占位符文本。这是脚本执行所必需的。脚本将覆盖伪值。

        注:您还可以为 REST 查询配置标题和 Cookie。

      2. 在“查询前行为”中,选择宏类型:全局、查询或表单字段。

      3. 从下拉列表中选择一个宏,然后插入宏(</> 插入宏)。

      4. 根据需要插入其他宏,然后提供所需的值以完成脚本。

        例如,在“查询前行为”中,我们将使用脚本来验证提交表单时,用户输入的组名称并未存在于 Active Directory 中。

        我们需要使用用户输入的名称创建 LDAP 查询。我们使用 Field() 宏来访问“名称”字段的值,并构建查询字符串,然后使用 Filter() 宏将其设置为查询过滤器。

        Filter() = '(&(objectCategory=group)(objectClass=group)(name=' + Field(name) + '))';
      5. 按照上面的示例,在“查询后行为”中,我们将检查查询返回的结果。结果作为与查询匹配的对象数组返回,因此我们只需要检查数组的长度是否大于 0。

        当找到匹配的组时,我们使用 Cancel() 宏来取消表单提交,向宏传递一条可选讯息以显示给用户。

        if (QueryResults().length > 0) { Cancel('A group with that name already exists, please enter a unique name.');}

    • 脚本: 插入自定义 JavaScript 代码或使用宏来构建脚本。

    • DRA 查询: 对于查询参数,以 JSON 格式定义有效负载。然后以与上述 LDAP 和 REST 查询类似的方式使用宏。

    • 讯息框处理程序: 在定义讯息框本身的属性后,以与上述 LDAP 和 REST 查询类似的方式使用宏,但不是使用查询前行为和查询后行为,而是撰写用于显示前行为和关闭后行为的宏脚本。

  4. 单击测试处理程序以在保存表单之前验证脚本。

    此操作将生成一个测试结果摘要,您可以在其中查看执行结果。

注:如果处理程序依赖于表单的当前状态(例如,该字段具有值),则它将无法成功执行,因为在编辑表单时不会加载任何数据。在这些情况下,需要在表单编辑器外部通过保存自定义、导航到相应的表单以及填写所需数据来测试处理程序。

8.2.3 自定义用户界面品牌化

您可以使用自己的标题和徽标图像自定义 DRA Web 控制台的标题栏。展示位置位于 DRA 产品名称的右侧。由于此位置也用于顶级导航,因此登录后会由顶级 DRA 导航链接隐藏。但是,浏览器选项卡将继续显示自定义标题。

要在 DRA 中自定义标题品牌化:

  1. 以 DRA 管理员身份登录到 Web 控制台。

  2. 导航到自定义 > 品牌化。

  3. 如果要添加公司徽标,请将徽标图像保存到 Web 服务器上的 components\lib\img 目录下。

  4. 为品牌化自定义页上的三个字段添加所需的信息(如果适用),然后保存更改。