在suitescript中，使用`record.getvalue()`仅能获取字段的内部id（如员工id），若需显示可读的名称（如销售代表姓名），应改用`record.gettext()`方法，并确保在已加载的记录上下文中调用。
在NetSuite中，salesrep等关系型字段（如员工、客户、部门）默认存储的是内部ID（integer），而非显示名称。直接调用 currentRecord.getValue({ fieldId: 'salesrep' }) 会返回类似 12345 的数字，这在邮件通知中显然不可读。正确做法是使用 getText() 方法——它会自动查询关联记录并返回该字段在UI中显示的文本值（例如“张三”或“Jane Doe”）。
但需注意：getText() 不能在新建记录（create context）的currentRecord上直接使用，因为新建记录尚未提交，其关联主数据的文本映射可能未完全解析。因此，必须先通过 record.load() 重新加载该记录（推荐使用 isDynamic: true 以支持字段级API），再调用 getText()：
// ✅ 正确示例：在用户事件脚本（如afterSubmit）中获取销售代表姓名
var recordId = currentRecord.id;
var objRecord = record.load({
type: currentRecord.type,
id: recordId,
isDynamic: true
});
var repName = objRecord.getText({
fieldId: 'salesrep'
});
var emailBody = "Details Below:
" + documentNum + "
Sales Rep: " + repName;⚠️ 关键注意事项：
- getText() 仅适用于标准关系字段（如 salesrep, entity, department）及启用了“显示文本”选项的自定义列表字段；
- 若字段为空（null 或 undefined），getText() 返回空字符串，建议添加空值校验；
- 在 beforeSubmit 中加载记录需谨慎（可能引发性能问题），推荐在 afterSubmit 中执行；
- 对于大量记录批量处理，请考虑使用 search.create() 配合 search.lookupFields() 提升效率，避免逐条load。
总结：从ID到名称的转换不是类型转换，而是元数据解析——getValue() 获取存储值，getText() 获取展示值。牢记“加载后取文”，即可让邮件中的销售代表名真正“说得清、看得懂”。
