本文介绍如何在 NetSuite 视图模式（VIEW）下，通过 User Event 脚本的 beforeLoad 触发器，基于销售订单是否关联已发货的货品履行单（Item Fulfillment），动态控制自定义超链接字段的可见性。
本文介绍如何在 netsuite 视图模式（view）下，通过 user event 脚本的 `beforeload` 触发器，基于销售订单是否关联已发货的货品履行单（item fulfillment），动态控制自定义超链接字段的可见性。
在 NetSuite 中，若需在仅查看（View）记录时根据业务状态动态控制字段显示（如：仅当销售订单已有已发货的货品履行单时才显示某个自定义链接字段），必须使用 User Event 脚本的 beforeLoad 触发器，而非 Client Script —— 因为 Client Script 在 View 模式下不会执行（仅在 Create/Edit 模式触发），而 beforeLoad 在所有加载场景（包括 View、Edit、Create）均生效，且此时记录数据已完全可用。
关键要点在于：
✅ beforeLoad 中的 scriptContext.newRecord 在 View 模式下即为已存在的完整记录，可安全调用 getValue() 获取字段值（如 tranid）；
✅ 字段显示属性（displayType）属于表单（Form）层级，而非记录本身，因此必须通过 scriptContext.form 获取表单对象，再调用 form.getField().updateDisplayType()；
✅ 必须显式判断 scriptContext.type === scriptContext.UserEventType.VIEW，避免在 Create/Edit 场景误操作；
✅ 部署脚本时，建议在部署记录的 Event Type 字段中勾选 View，实现双重保障。
以下是经过验证的完整 User Event 脚本（NetSuite 2.1）：
/**
* @NApiVersion 2.1
* @NScriptType UserEventScript
*/
define(['N/log', 'N/record', 'N/ui/serverWidget', 'N/search'],
(log, record, serverWidget, search) => {
const beforeLoad = (scriptContext) => {
// 仅在 View 模式下执行逻辑
if (scriptContext.type !== scriptContext.UserEventType.VIEW) return;
try {
const currRecord = scriptContext.newRecord;
const tranId = currRecord.getValue({ fieldId: 'tranid' });
// 查询是否存在关联的 Item Fulfillment（createdfrom = 当前订单号）
const shipmentSearch = search.create({
type: search.Type.ITEM_FULFILLMENT,
filters: [['createdfrom', search.Operator.IS, tranId]],
columns: ['internalid']
});
const results = shipmentSearch.run().getRange({ start: 0, end: 1 });
// 若存在至少一条履行单，则显示自定义字段
if (results.length > 0) {
const form = scriptContext.form;
const field = form.getField({ id: 'custbody_my_dynamic_link' });
if (field) {
field.updateDisplayType({
displayType: serverWidget.FieldDisplayType.NORMAL
});
}
}
} catch (e) {
log.error('Dynamic Field Display Error', e.message);
}
};
return { beforeLoad };
});
⚠️ 注意事项：
- 确保自定义字段
custbody_my_dynamic_link已添加至销售订单表单（Form）中，否则form.getField()将返回undefined； -
search.create()在beforeLoad中是安全的（非高开销操作），但若需校验“已发货”（而非仅存在履行单），应将过滤条件升级为：["status", search.Operator.CONTAINS, "Shipped"]或更精确的状态内部 ID（如"ItemFulfillment:B","ItemFulfillment:C"）； - 生产环境建议添加错误日志与空值防护（如示例中的
if (field)判断）； - 部署时务必设置 Deployment → Event Type = View，并启用 Execute in Context of User（以确保权限与搜索范围正确）。
该方案兼顾性能、可靠性与可维护性，是 NetSuite 中实现视图态动态 UI 控制的标准实践。
