NetSuite查看模式下基于记录属性动态显示字段的实现方案

我在销售订单（Sales Orders）上有一个自定义超链接字段，希望该字段仅在订单存在已发货的Item Fulfillment记录时才显示，且仅在查看记录时展示。我无法同时实现以下两点：检查订单是否存在Item Fulfillment，以及设置字段的显示状态。

我原本认为ClientScript是合适的方案，因为这纯粹是UI层面的操作，但根据官方文档，ClientScript仅在创建或编辑记录时运行，查看模式下不会触发，因此该方案不可行。

随后我尝试了UserEvent脚本，它仅有三个触发点：beforeLoad、beforeSubmit和afterSubmit。我尝试使用beforeLoad，虽然看起来可以在此处切换字段显示状态，但此时记录尚未加载，无法判断是否存在Item Fulfillment。

解决方案：使用UserEvent脚本的beforeLoad触发点 #

你之前的误区是认为beforeLoad中无法获取订单信息，实际上beforeLoad的scriptContext.newRecord已经包含当前订单的完整数据，可以通过它获取订单内部ID，进而查询关联的Item Fulfillment记录。同时，beforeLoad支持查看模式（view）的触发，完全符合需求。

修正后的代码 #

/**
 * @NApiVersion 2.x
 * @NScriptType UserEventScript
 */
define(['N/log', 'N/search', 'N/ui/serverWidget'], function(log, search, serverWidget) {

    function beforeLoad(scriptContext) {
        // 仅在查看模式下执行逻辑
        if (scriptContext.mode !== 'view') return;

        const salesOrder = scriptContext.newRecord;
        const orderId = salesOrder.id; // 获取销售订单的内部ID

        // 查询是否存在关联的已发货Item Fulfillment
        const fulfillmentSearch = search.create({
            type: search.Type.ITEM_FULFILLMENT,
            filters: [
                ['createdfrom', search.Operator.IS, orderId],
                ['mainline', search.Operator.IS, true] // 只查主记录，避免重复计数
            ],
            columns: ['internalid']
        });

        const hasFulfillment = fulfillmentSearch.run().getRange(0, 1).length > 0;

        const form = scriptContext.form;
        const customLinkField = form.getField({
            fieldId: 'custbody_my_dynamic_link'
        });

        // 根据是否有发货记录设置字段显示状态
        if (hasFulfillment) {
            customLinkField.updateDisplayType({
                displayType: serverWidget.FieldDisplayType.NORMAL
            });
        } else {
            customLinkField.updateDisplayType({
                displayType: serverWidget.FieldDisplayType.HIDDEN
            });
        }
    }

    return {
        beforeLoad: beforeLoad
    };
});

关键说明 #

• 脚本类型改为UserEventScript，并绑定beforeLoad函数
• 通过scriptContext.mode判断是否为查看模式，避免在创建/编辑时执行逻辑
• 使用订单的内部ID（salesOrder.id）查询关联的Item Fulfillment，比用tranid更可靠
• 通过scriptContext.form获取表单对象，修改字段的显示类型（NORMAL显示，HIDDEN隐藏）
• 增加mainline: true过滤器，确保只查询Item Fulfillment的主记录，避免因多行item导致的重复结果

内容的提问来源于stack exchange，提问作者Bee S.