如何在NetSuite中通过自定义记录类型创建指定对象的自定义按钮？

核心逻辑 #

通过自定义记录存储按钮配置（名称、目标对象类型），再利用目标对象的**用户事件脚本（Before Load）**动态读取配置并添加按钮，搭配客户端脚本处理按钮点击事件。

1. 自定义记录的用户事件脚本（After Submit） #

此脚本主要确保配置数据正确存储，如需标记配置状态（如启用/禁用）可在此处理：

/**
 * @NApiVersion 2.x
 * @NScriptType UserEventScript
 * @NModuleScope SameAccount
 */
define(['N/record'], function(record) {

    function afterSubmit(context) {
        var configRecord = context.newRecord;
        // 可选：标记配置为已生效，或同步到其他存储（如自定义列表）
        var isEnabled = configRecord.getValue('custrecord_button_enabled'); // 若有启用字段
        if (isEnabled) {
            // 可添加状态同步逻辑
        }
    }

    return {
        afterSubmit: afterSubmit
    };
});

2. 目标对象的通用用户事件脚本（Before Load） #

将此脚本部署到所有需要添加自定义按钮的对象（客户、销售订单等），加载记录时自动读取配置并生成按钮：

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

    function beforeLoad(context) {
        // 仅在查看/编辑模式下添加按钮
        if (![context.UserEventType.VIEW, context.UserEventType.EDIT].includes(context.type)) {
            return;
        }

        var currentRecordType = context.newRecord.type;
        var form = context.form;

        // 搜索匹配当前对象类型的按钮配置
        var configSearch = search.create({
            type: 'customrecord_your_button_config', // 替换为你的自定义记录ID
            filters: [
                ['custrecord_target_record_type', 'is', currentRecordType], // 替换为你的对象选择字段ID
                ['custrecord_button_enabled', 'is', true] // 若有启用字段，添加过滤
            ],
            columns: ['custrecord_button_name', 'custrecord_client_script_path']
        });

        configSearch.run().each(function(result) {
            var btnName = result.getValue('custrecord_button_name');
            var scriptPath = result.getValue('custrecord_client_script_path');
            var btnId = 'custpage_btn_' + btnName.replace(/\W/g, '_'); // 生成唯一ID

            form.addButton({
                id: btnId,
                label: btnName,
                functionName: 'onCustomButtonClick', // 客户端脚本中的处理函数
                clientScriptModulePath: scriptPath || './custom_btn_handler.js' // 优先用配置中的脚本路径，否则用通用脚本
            });
            return true;
        });
    }

    return {
        beforeLoad: beforeLoad
    };
});

3. 按钮点击处理的客户端脚本 #

负责处理按钮触发后的业务逻辑，可根据需求自定义：

/**
 * @NApiVersion 2.x
 * @NScriptType ClientScript
 * @NModuleScope SameAccount
 */
define(['N/ui/dialog', 'N/record'], function(dialog, record) {

    function onCustomButtonClick() {
        var currentRec = record.currentRecord;
        var recId = currentRec.id;
        var recType = currentRec.type;

        // 示例：弹出提示
        dialog.alert({
            title: '自定义按钮触发',
            message: `当前记录：${recType} ID: ${recId}`
        });

        // 可添加业务逻辑：创建关联记录、调用API、跳转到其他页面等
    }

    return {
        onCustomButtonClick: onCustomButtonClick
    };
});

4. 部署与测试步骤 #

1. 部署用户事件脚本：将目标对象的用户事件脚本部署到所有需要的记录类型（客户、销售订单等），配置好角色权限。
2. 创建测试配置：在自定义记录中新增一条记录，选择目标对象（如客户），输入按钮名称，指定客户端脚本路径（可选）。
3. 验证效果：打开对应对象的记录（如某客户），检查是否显示自定义按钮，点击测试是否触发客户端脚本逻辑。

关键注意事项 #

• 按钮ID必须唯一，建议用custpage_btn_前缀避免冲突。
• 若支持配置删除/编辑，无需额外处理：目标对象脚本会自动读取最新的配置，删除的配置不会再生成按钮。
• 确保脚本部署权限覆盖所有需要访问目标记录的角色，避免按钮不显示。

内容的提问来源于stack exchange，提问作者Ashish Patil