如何应用表单字段规则在工单中获取请求人附加字段值

此功能用于获取保存在“用户-附加字段”中的请求人的附加信息，并将该字段的值赋给工单模板中的某个字段。可以在故障单或服务单模板的表单字段规则中使用附件中的脚本来达到这个效果。适用于ServiceDesk 10及以前版本；

通过工单选中的请求人的显示名和Email地址来发起一个CMDB的API调用。用户的附加字段的名称及UDF名称作为输入在java脚本提供。

使用实例

某些员工详细信息是从Active Directory导入到用户附加字段中。业务需求是将员工的这些附加信息发送给需要处理某些特定工单的技术人员。

 首先需要在故障单或服务单模板上添加一个附加字段（在管理—帮助台—请求的附加字段/服务目录—服务目录-附加字段处添加）。然后设置表单字段规则获取请求人的附加字段并赋值给工单附加字段。

 

如何在表单中找到字段的UDF名称？

打开待处理的工单模板，并确保工单已添加了自定义字段。要获取字段的UDF名称，请单击“字段与表单规则” 页签，并点击“创建新规则”。 在动作那里选择“执行脚本” - “编写自定义脚本” 。在出现页面的 “参照模板字段“ 处搜索工单附加字段的名称，一旦搜索到，点击字段名称，会在右侧面板显示 Field Label，Field name以及类型。“字段名称” 值即为字段的UDF名称，在java脚本中将会用到。

执行步骤：

1. 下载附件脚本文件，在脚本中更新工单附加字段ID和请求人附加字段显示名。如下所示：

2. 打开模板，点开 “表单字段的规则”， 针对代替用户提交工单的技术员， 需要“在字段变更时” 执行脚本， 下图为配置示意图：

 

针对请求人在自助服务门户里自助提单的情况，表单字段的规则脚本需要添加在“在加载表单时“ ，下图为配置示意图：

针对这两种提单方式兼具的情形，表单字段的规则脚本需要添加在“在提交表单时点击 ”编写自定义脚本“ 打开编辑器并将附件中的脚本黏贴进脚本代码区域即可。下图为配置示意图：

 

3. 保存表单字段规则及模板设置。

现在可以测试使用该工单模板新建工单了。工单一旦被创建，工单自定义字段Grade的值被赋值为请求人自定义字段Grade的值，如下图所示：

• Related Articles

• 利用表单字段规则验证ip地址合规性

  可以利用自定义字段和表单字段规则来验证用户提单时输入的IP地址合规性进行验证 比方说验证IPV4地址范围在 IP的有效值是1.0.0.1~255.255.255.255 1. 请在工单模板上添加一个字段比方说叫 "IP Address“. 2. 然后在”表单字段规则” 中添加如图2的规则， 在动作里选择"执行脚本“ 脚本内容，红色部分请用您环境中创建的”IP Address“的字段名称（一般为API名称，非显示名）替换即可 3. 使用该模板创建工单，如果IP地址不合规无法提交表单，如图3   ...

• 在属性项中自动填写工单id（便于表单字段规则及业务规则脚本中调用工单id）

  1 首先，在模板中创建一个附加字段用于接收工单ID，例如例子中的：备注信息 2 在请求模板中添加字段表单规则 选择 在加载表单时 添加规则 ，条件可以不用选，直接添加动作 执行脚本。 3 脚本内容输入： function createXHR(){  var xhr = null;  if(window.XMLHttpRequest){//判断当前浏览器是否支持XMLHttpRequest   xhr = new XMLHttpRequest();  }else ...

• 我怎么从活动目录中导入请求人的附加字段信息？

  如果您还没有配置任何请求人附加字段，那么可以在管理 -> 用户 - 附加字段下，设置用户的附加字段，字段的类型有文本、数字、日期等，按需创建。 完成后，在管理 -> 活动目录 -> 导入请求人 -> 在导入请求人窗口中，附加字段部分，设置附加字段对应的AD属性名称（LDAP属性名），保存并导入即可。 对于不需要导入的字段，可以取消字段前的复选框。

• 添加请求的一个python脚本例子

  附件是添加使用python2添加请求的例子。 提交数据requester可以使用获取请求人的api，获取正确的请求人名称和id

• 提取一个请求

  API调用URL地址 http://<serverName>:<portNumber>/api/v3/requests/{request_id}/pickup 其中{request_id}为提取的请求ID 示例：http://192.168.1.8:8080/api/v3/requests/14/pickup 请求参数 方法：PUT 请求参数： 参数名 值 位置 authtoken <API Key> header 响应示例  {     "response_status": { ...