Acumatica UI与REST API下销售订单描述字段更新差异问题

需求与问题 #

需求：自动将销售订单的OrderDesc字段填充为订单编号、客户订单号、客户名称的组合文本，字符数限制在250以内。
问题：在Acumatica UI中操作时该字段能正常更新，但通过REST API调用SalesOrder端点创建/更新订单时，OrderDesc始终为空。

已尝试的方案 #

• 实现SOOrder_RowPersisted事件处理逻辑：API调用后OrderDesc字段仍为空
• 改用SOOrder_RowPersisting事件：由于订单尚未保存，无法获取正确的OrderNbr，且最终保存后字段仍未更新

解决思路与代码示例 #

1. 修正RowPersisting事件逻辑，适配API场景 #

API操作时，订单的OrderNbr在RowPersisting阶段已可用（新增订单时系统会提前生成编号），需确保缓存中的字段被正确更新并同步给API。以下是修正后的事件代码：

public class SOOrderEntryExtension : PXGraphExtension<SOOrderEntry>
{
    protected void _(Events.RowPersisting<SOOrder> e)
    {
        SOOrder order = e.Row;
        if (order == null) return;

        // 获取关联的客户信息
        BAccount customer = PXSelect<BAccount, 
            Where<BAccount.bAccountID, Equal<Required<SOOrder.customerID>>>>.Select(Base, order.CustomerID);
        if (customer == null) return;

        // 拼接描述文本并限制长度
        string fullDesc = $"订单编号: {order.OrderNbr}, 客户订单号: {order.CustomerOrderNbr}, 客户名称: {customer.AcctName}";
        order.OrderDesc = fullDesc.Length > 250 ? fullDesc.Substring(0, 250) : fullDesc;

        // 强制更新缓存，确保API能读取到更新后的值
        Base.Caches[typeof(SOOrder)].Update(order);
    }
}

2. 验证SalesOrder端点的字段配置 #

• 确认在Acumatica的Endpoint配置中，SalesOrder实体的OrderDesc字段设置为可读写
• 检查是否有字段级权限限制，导致API无法读取或写入该字段

3. 确保API请求不覆盖字段值 #

如果API请求中显式传递了OrderDesc: null或空字符串，事件逻辑需要强制覆盖该值，而非依赖字段初始状态。

内容的提问来源于stack exchange，提问作者Xavier LARTEM