使用表单设计器 › 如何在字段中使用 JavaScript 表达式 › 如何基于 JavaScript 表达式预填充字段

如何基于 JavaScript 表达式预填充字段

当您将包括值属性的元素用作表单的窗口项时，可以通过 JavaScript 表达式使用 CA Service Catalog 数据库中某个对象和属性的运行时值来预填充元素的“值”属性。

例如，在表单上的“名”文本窗口项中，您可以指定 JavaScript 表达式 $(_.user.firstName)，以便使用创建请求并完成表单的已登录用户 ID 的名字来预填充该窗口项。 同样，在“姓”文本窗口项中，您可以指定 JavaScript 表达式 $(_.user.lastName)，以便使用用户的姓氏来预填充该窗口项。

要使用 JavaScript 表达式预填充表单中的字段，请遵循以下步骤：

1. 设计并创建表单。
2. 确认在该字段或感兴趣的字段中执行自动化任务的最好方法是使用 JavaScript 表达式。
3. 查看在字段中使用 JavaScript 表达式的指南，并确认是否想预填充该字段中元素的 value 属性。
4. 确认想要预填充的数据是可在 JavaScript 表达式中指定的对象和属性之一。 这些对象和属性与已登录用户的个人数据、一个或多个业务单位，或服务、服务选项、状态或包含表单请求的其他相关数据有关。
5. 在字段元素的 value 属性中指定 JavaScript 表达式。 指定表达式时，请遵循可在 JavaScript 表达式中指定的对象和属性的所有语法规则，特别是与使用运算符链接属性相关的规则。 下面是一些有效的表达式，您可以按照原样使用这些表达式或者将其用作模型：
   • 用户的名字：$(_.user.firstName)
   • 用户的姓氏：$(_.user.lastName)
   • 用户的姓名（串联在一个字段中）：$(_.user.firstName + ' ' + _.user.lastName)

     您可以使用此示例预填充表单结尾的文本窗口项，如感谢消息。

   • 用户的城市：$(_.user.location.city)
   • 用户的省/自治区/直辖市：$(_.user.location.state)
   • 用户的实际地址（串联在一个字段中）：$(_.user.location.address[0] + ‘ ‘ + _.user.location.address[1] + ' ' + _.user.location.city + ' ' + _.user.location.state)

     此示例针对一个美国的地址返回了用户所在的州、城市和街道地址。

   • 用户的角色：$(_.user.roles[domainId])
   • 用户的业务单位及其上级单位：$(_.bu.id)
   • 用户的业务单位，无上级单位：$(_.bu.id.parent)
   • 为之提出请求的用户 ID：$(_.request.requestedFor)
   • 提出请求的用户 ID：$(_.request.requestedBy)
   • 与表单相关联的服务名称：$(_.service.name)
   • 与表单相关联的服务状态：$(_.service.status)
   • 与表单相关联的服务中的服务选项组名称：$(_.sog.name)
   • 与表单相关联的服务中的服务选项组说明：$(_.sog.name.description)
   • 与表单相关联的服务中的服务选项组状态：$(_.sog.name.status)
6. 测试 JavaScript 表达式以确认其是否会完成您预填充表单上字段的目标。
7. 作为一项最佳实践，在生产环境中使用表单和服务之前，请首先在测试环境中测试用于该服务的表单中的表达式。