基于关联表和引用字段筛选引用字段值的教程

在ServiceNow中，有时我们需要根据已选的引用字段值，动态地限制另一个引用字段的可用选项。例如，在关联用户和商品时，我们可能希望只显示尚未与该用户关联的商品。本文将介绍如何使用高级引用限定符和Script include来实现这一功能。

实现步骤

1. 配置引用字段的引用限定符

   首先，在需要筛选的引用字段（例如 goodsRef）的字典配置中，将“使用引用限定符”设置为“高级”。这允许我们使用JavaScript代码动态地生成引用限定符。

   • 在Studio中打开表单。
   • 选中需要配置的字段。
   • 在“参考规范”部分，将“使用参考限定符”设置为“高级”。
   • 在“参考限定”字段中，输入以下JavaScript代码：

   javascript: (new ScriptIncludeJS()).getNotLinkedGoods(current.user_name);

   这段代码调用名为 ScriptIncludeJS 的 Script Include 中的 getNotLinkedGoods 函数，并将当前表单中的 user_name 字段的值作为参数传递给该函数。

2. 创建Script Include

   接下来，创建一个Client Callable的Script Include，用于生成动态的引用限定符。

   • 导航到“系统定义”>“脚本包含”。

   • 点击“新建”按钮。

   • 填写以下信息：

     • 名称：ScriptIncludeJS
     • 客户端可调用：true
     • 可从以下位置访问：所有应用程序作用域
     • 脚本：

   var ScriptIncludeJS = Class.create(); ScriptIncludeJS.prototype = Object.extend(global.AbstractAjaxProcessor, {     getNotLinkedGoods: function(userID) {         // 创建用于存储要显示的商品的数组         var goods = [];          // 选择 LinkedTbl 表         var grObj = new GlideRecord('x_1234_pro_0_linkedtbl'); // 替换为你的关联表名          // 从表单中获取用户详细信息，该字段显示为 'userID'         // 对于上面选择的表，使用链接表         grObj.addQuery('user_name', userID); // 替换为你的用户引用字段名         grObj.query();          while (grObj.next()) {             // 准备商品名称数组，作为带有表对象的 PUSH             goods.push(grObj.goods_name.toString()); // 替换为你的商品引用字段名         }         // 构建并返回 sys_id NOT IN 查询         return 'sys_idNOT IN' + goods.toString();     },     type: 'ScriptIncludeJS' });
   • 保存 Script Include。

   代码解释：

   • getNotLinkedGoods 函数接收 userID 作为参数，该参数是从表单传递过来的当前用户ID。
   • 函数查询名为 x_1234_pro_0_linkedtbl 的关联表（需要替换为你的实际表名），查找与给定用户ID关联的所有商品。
   • 遍历查询结果，将已关联的商品ID添加到 goods 数组中。
   • 最后，函数返回一个 sys_idNOT IN 格式的字符串，该字符串将被用作引用限定符，以排除已关联的商品。

示例代码

以下是一个完整的示例，展示了如何在 ServiceNow 中实现基于关联表筛选引用字段值的功能。

表结构：

• u_user_table (用户表):
  • sys_id
  • name
• u_goods_table (商品表):
  • sys_id
  • name
• u_link_table (关联表):
  • sys_id
  • user (引用 u_user_table)
  • goods (引用 u_goods_table)
• u_new_link_table (新关联表):
  • sys_id
  • user (引用 u_user_table)
  • goods (引用 u_goods_table)

Script Include (Client Callable):

var ScriptIncludeJS = Class.create(); ScriptIncludeJS.prototype = Object.extend(global.AbstractAjaxProcessor, {     getNotLinkedGoods: function(userID) {         var goods = [];         var grObj = new GlideRecord('u_link_table');         grObj.addQuery('user', userID);         grObj.query();          while (grObj.next()) {             goods.push(grObj.goods.toString());         }         return 'sys_idNOT IN' + goods.toString();     },     type: 'ScriptIncludeJS' });

u_new_link_table 表中 goods 字段的引用限定符：

javascript: (new ScriptIncludeJS()).getNotLinkedGoods(current.user);

注意事项

• 确保替换示例代码中的表名和字段名为你实际使用的名称。
• Script Include必须设置为 Client Callable，以便客户端脚本可以调用它。
• userID 参数必须与表单中用户引用字段的名称匹配。
• 如果关联表中的字段不是 sys_id，则需要相应地修改 Script Include 中的代码。
• 如果性能是一个问题，可以考虑使用缓存来存储引用限定符的结果。

总结

通过使用高级引用限定符和 Script Include，我们可以轻松地在 ServiceNow 中实现基于关联表筛选引用字段值的功能。这可以帮助我们确保数据的完整性，并提高用户的效率。这种方法可以应用于各种场景，例如限制可选的配置项、筛选可用的服务等等。只需要根据实际需求修改表名、字段名和查询条件即可。