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

本文档旨在提供一种解决方案，用于在ServiceNow平台中，基于已存在的关联关系，动态筛选引用字段的值。通过使用高级引用限定符和Script include，可以实现在选择用户后，只显示尚未与该用户关联的商品，从而避免重复关联，提高数据录入的准确性。

在ServiceNow平台中，经常会遇到需要根据一个引用字段的值，动态筛选另一个引用字段的值的情况。例如，在一个“用户-商品关联”的场景中，我们希望在选择用户后，只显示尚未与该用户关联的商品，以避免重复关联。本文将介绍如何使用高级引用限定符和Script Include来实现这一功能。

场景描述

假设我们有以下四个表：

• UsersTbl (用户表):
  • UserID (自动编号)
  • UserName (字符串)
  • UserEmail (字符串)
  • UserAddress (字符串)
• goodsTbl (商品表):
  • GoodsID (自动编号)
  • GoodsName (字符串)
• LinkTbl (关联表): 记录用户和商品之间的关联关系，一个用户可以关联多个商品。
  • LinkID (自动编号)
  • GoodsRef (引用 – GoodsName)
  • UserRef (引用 – UserName)
  • DateCreated (日期/时间)
• NewLinkTbl (新关联表): 用于创建新的用户-商品关联关系。
  • NewLinkID (自动编号)
  • UserRef (引用 – UserName)
  • GoodsRef (引用 – GoodsName)
  • LinkID (数字)
  • DateCreated (日期/时间)

我们的目标是在 NewLinkTbl 表单中，当用户选择 UserRef 字段后，GoodsRef 字段只显示尚未与该用户在 LinkTbl 表中关联的商品。

实现步骤

1. 配置引用限定符

   首先，在 NewLinkTbl 表的 GoodsRef 字段上，配置高级引用限定符。在 Studio 中打开该表，选择 GoodsRef 字段，然后在“引用规范”部分，将“使用引用限定符”设置为“高级”。在“引用限定符”字段中，输入以下 JavaScript 代码：

   JavaScript: (new ScriptIncludeJS()).getNotLinkedGoods(current.user_ref);

   这里，current.user_ref 获取当前表单中 UserRef 字段的值，并将其作为参数传递给 ScriptIncludeJS 中的 getNotLinkedGoods 函数。

2. 创建 Script Include

   创建一个 Client Callable 的 Script Include，命名为 ScriptIncludeJS，代码如下：

   var ScriptIncludeJS = Class.create(); ScriptIncludeJS.prototype = Object.extend(global.AbstractAjaxProcessor, {     getNotLinkedGoods: function(userID) {         // 创建用于存储商品 sys_id 的数组         var goods = [];          // 选择 LinkTbl 表         var grObj = new GlideRecord('x_your_scope_linkedtbl'); // 将 x_your_scope_linkedtbl 替换为你的关联表的 sys_id          // 根据 UserRef 字段查询 LinkTbl 表         grObj.addQuery('user_ref', userID);         grObj.query();          while (grObj.next()) {             // 将已关联的商品的 sys_id 添加到数组中             goods.push(grObj.goods_ref.toString());         }          // 返回一个 sys_id NOT IN 的查询字符串         if (goods.length > 0) {             return 'sys_idNOT IN' + goods.join(',');         } else {             // 如果没有关联的商品，则返回空字符串，显示所有商品             return '';         }     },     type: 'ScriptIncludeJS' });

   代码解释:

   • getNotLinkedGoods(userID) 函数接收 UserRef 字段的值作为参数。
   • GlideRecord(‘x_your_scope_linkedtbl’) 创建一个 GlideRecord 对象，用于查询 LinkTbl 表（请替换为实际的表名）。
   • grObj.addQuery(‘user_ref’, userID) 添加查询条件，筛选出与指定用户关联的记录。
   • goods.push(grObj.goods_ref.toString()) 将已关联的商品的 sys_id 添加到 goods 数组中。
   • return ‘sys_idNOT IN’ + goods.join(‘,’) 构建一个 sys_idNOT IN 的查询字符串，用于排除已关联的商品。goods.join(‘,’) 将数组转换为逗号分隔的字符串。
   • 如果 goods 数组为空，表示该用户没有关联任何商品，则返回空字符串，此时引用字段将显示所有商品。

注意事项

• 确保将 x_your_scope_linkedtbl 替换为你的 LinkTbl 表的实际 sys_id。
• 确保 Script Include 的 “accessible from” 设置为 “All application scopes”，或者你的应用程序作用域。
• current.user_ref 中的字段名称必须与表单中 UserRef 字段的实际名称一致。
• grObj.goods_ref.toString() 必须与关联表中商品引用字段的实际名称一致。
• 本方案使用了 sys_id 进行筛选，因此要求 GoodsRef 字段存储的是商品的 sys_id。

总结

通过以上步骤，我们成功地实现了基于关联表和引用字段动态筛选引用字段的值的功能。这种方法可以有效地避免重复关联，提高数据录入的效率和准确性。在实际应用中，可以根据具体的需求进行调整和优化。例如，可以添加缓存机制，以提高性能；或者根据不同的业务规则，修改查询条件。