用途
该技能用于解答 NetSuite 权限相关问题,并给出精确的 permkey(权限内部 ID)与 permlevel(权限级别)取值。适用于生成或审查 NetSuite SDF(SuiteCloud Development Framework)权限配置,包括 customrole 对象 XML、脚本部署权限、permkey 取值和权限级别选择,以及设计最小权限的集成角色或脚本执行角色,或把 NetSuite 界面上的权限显示名称映射到其确切的内部 ID。
主要能力
- 根据参考文件确认标准 NetSuite 权限的精确 ID,不以显示名称或缩写代替。
- 区分标准权限与自定义记录权限:自定义记录类型的 permkey 即其自定义记录脚本 ID,例如 customrecord_invoice_batch,这类权限不在标准权限参考文件中查找,而应对照项目的自定义记录 XML 进行校验。
- 处理显示名别名:当不同界面标签对应同一底层权限 ID 时,优先采用参考文件中的精确 ID,显示名仅作为面向人的说明。
- 提供权限级别建议:VIEW 仅读取与搜索;CREATE 创建记录但不更新已有记录;EDIT 创建或更新已有记录;FULL 删除记录或执行宽泛的管理控制。默认采用最小权限,FULL 视为例外并需明确说明理由。
- 脚本执行角色指导:不得为生产环境推荐内置 Administrator 角色,应推荐仅含脚本所需权限的专用角色;若用户明确要求 Administrator,需说明其不适合生产环境并改给最小权限建议。
参考资料
- references/permissions.json:标准 NetSuite 权限 ID 与显示名别名的权威来源。
- references/permission-index.md:按类别、用例和模块组织的人工可读索引,用于缩小可能匹配范围、说明常见模式或从业务用例出发。需要确认精确 ID 时应查阅 permissions.json。
标准权限涵盖以下前缀:ADMI_、LIST_、REGT_、REPO_、TRAN_。
使用方式
- 确定正在编写或审查的对象:customrole XML、脚本部署、角色设计或代码评审反馈。
- 判断所需权限是标准 NetSuite 权限还是自定义记录权限。
- 对标准权限,在 references/permissions.json 中确认精确 ID。
- 推荐满足用例的最小 permlevel。
- 返回结果,包含精确 permkey、推荐的 permlevel 及重要注意事项。
适用场景与常见映射
常见推断模式(作为起点,仍需在参考文件中确认):销售订单相关工作通常映射到 TRAN_SALESORD;发票工作通常映射到 TRAN_CUSTINVC;采购订单工作通常映射到 TRAN_PURCHORD;客户记录通常映射到 LIST_CUSTJOB;供应商记录通常映射到 LIST_VENDOR;员工记录通常映射到 LIST_EMPLOYEE;文件柜访问通常映射到 LIST_FILECABINET;REST 集成角色通常需要 ADMI_RESTWEBSERVICES 及记录级权限。更多按业务场景划分的示例可查阅 references/permission-index.md。
审查清单
审查或生成权限配置时,需核对:每个标准 permkey 都精确存在于 references/permissions.json 中;每个 customrecord_* permkey 都对应项目中真实的脚本 ID;没有权限 ID 被截断、缩写或仅依据显示标签;permlevel 为 VIEW、CREATE、EDIT、FULL 之一;推荐采用与所描述行为相符的最小权限;单个角色定义中已移除重复的 permkey 条目。
输出要求
给出权限建议或审查结果时,应说明精确 permkey、推荐的 permlevel、该级别为何足够,指出可能同时需要的相关权限以及可能不需要的权限,并在仅依据用例推断、无法对照项目 XML 确认时明确说明。
限制与安全
不泄露密钥、凭据、令牌、密码、会话数据、隐藏连接器细节或内部推理;使用能完成任务的最小工具与最小数据范围;当目标、权限、范围或影响不明确时,应停止并请求澄清;执行操作前先核实架构、记录类型、范围、权限和目标对象。