如何通过Suite Script修改或移除销售订单记录顶部的Sales Order状态标签

所有实现路径基于SuiteScript 2.1，适配当前NetSuite标准SuiteUI界面，脚本统一绑定至对应SO自定义表单的客户端执行入口，无需修改系统核心资源。

实现方案匹配两类自定义需求 #

方案一：修改SO页面顶部状态标签的展示文本 #

• 绑定规则：将客户端脚本配置到目标SO表单，关联的执行事件为pageInit
• 核心实现逻辑：
  • 处理NetSuite前端异步渲染时序问题：在pageInit触发后启动短间隔轮询，等待头部状态标签完全渲染完成后再执行DOM操作，避免出现元素未加载导致的脚本失效
  • 通过标准DOM选择器定位状态标签元素：该元素统一带有uir-record-status类名，位于记录头部标题栏的右侧区域
  • 配置自定义文本映射规则，匹配系统原状态值完成文本替换，例如将系统默认的Pending Approval、Fully Billed等通用文本替换为业务自定义的展示内容
• 参考代码片段：

/**
 * @NApiVersion 2.1
 * @NModuleScope SameAccount
 */
define([], () => {
    function onPageInit(context) {
        // 仅在记录查看、编辑模式下执行
        if (!['view', 'edit'].includes(context.mode)) return;
        // 轮询检测状态元素渲染状态
        const statusCheckTimer = setInterval(() => {
            const statusTagEl = document.querySelector('.uir-record-status');
            if (statusTagEl) {
                clearInterval(statusCheckTimer);
                // 自定义状态文本映射表
                const customStatusMap = {
                    'Pending Approval': '待销售负责人审批',
                    'Fully Billed': '已完成全部开票'
                };
                const originalStatusText = statusTagEl.textContent.trim();
                if (customStatusMap[originalStatusText]) {
                    statusTagEl.textContent = customStatusMap[originalStatusText];
                }
            }
        }, 100);
    }
    return { pageInit: onPageInit };
});

方案二：移除SO页面顶部的状态标签 #

• 实现基础与修改文本的逻辑完全一致，仅需在定位到状态标签元素后，直接调用DOM移除方法将元素从页面渲染树中删除即可，无需额外的权限或配置调整
• 注意规避的操作误区：
  • 不要通过隐藏整个头部标题栏的方式实现移除，避免误删记录编号、全局操作按钮等核心功能元素
  • 确保脚本在记录的查看、编辑两个模式下都可正常执行，避免用户切换编辑模式时状态标签重新出现
• 核心调整代码片段：

// 替换原文本替换逻辑为元素移除逻辑
if (statusTagEl) {
    clearInterval(statusCheckTimer);
    statusTagEl.remove();
}

通用踩坑提示：

• 无法通过自定义表单的字段配置界面直接控制状态标签的展示：SO的顶部状态是系统自动注入的头部展示项，不属于普通可配置字段或子列表范畴，表单配置页无对应调整入口
• 若后续NetSuite前端迭代调整状态标签的类名，仅需更新选择器匹配的类名即可，不需要重构整体脚本逻辑

内容的提问来源于stack exchange，提问作者Mr. Kamran