PAYATHON 2026

如何修改 CROpportunity.Resolution 的 StringList 值

数据小陈

结论:CROpportunity.resolution 的下拉值受字段属性和 Workflow 两层影响。静态场景下,用 CacheAttached 覆盖 PXStringList 可以生效;但只要 OpportunityWorkflow 对该字段调用了 ComboBoxValues(...),运行时就会按状态替换下拉值。这时只改 CacheAttached 通常看不到效果,还可能让下拉框显示 “No data available”。

CacheAttached 为什么没生效

  1. 字段原来的 attribute 是 OpportunityReason.ListAttribute,它继承自 PXStringListAttribute。旧 attribute 没清干净时,字段上可能同时存在多个 StringList 定义,UI 就解析不到有效列表。
  2. PXMergeAttributes(Method = MergeMethod.Append) 表示追加合并。即使已经用 PXRemoveBaseAttribute(typeof(OpportunityReason.ListAttribute)) 移除过原 attribute,某些版本或配置下仍要再清掉基类 PXStringListAttribute,或者改用更明确的替换写法。
  3. Workflow 的影响更直接:field.ComboBoxValues(LostReasons) 会在特定状态把下拉值换成 LostReasons,字段级 PXStringList 就不再是唯一来源。

方案一:只改字段静态 StringList

先确认当前状态没有被 Workflow 的 ComboBoxValues 覆盖,再按下面的方式覆盖字段 attribute:

public class OpportunityMaintExt : PXGraphExtension<OpportunityMaint>
{
    [PXMergeAttributes(Method = MergeMethod.Append)]
    [PXRemoveBaseAttribute(typeof(OpportunityReason.ListAttribute))]
    [PXRemoveBaseAttribute(typeof(PXStringListAttribute))]
    [PXStringList(
        new string[] { "NF", "PC" },
        new string[] { "Not Funded", "Project Cancelled" })]
    protected virtual void _(Events.CacheAttached<CROpportunity.resolution> e)
    {
    }
}

注意:CROpportunity.resolution 是 BQL 字段类名,事件签名要和 DAC 字段一致。字段名大小写或 graph extension 挂载不正确,CacheAttached 就不会按预期触发。另外,不同 Acumatica 版本对 PXRemoveBaseAttribute 和 PXMergeAttributes 的合并细节可能略有差异,建议在开发环境验证。

方案二:改 Workflow 的 ComboBoxValues

如果下拉值要随 Opportunity 状态变化,应改 Workflow 里对应的数组,只改 CacheAttached 不够。比如要在 Lost 状态显示 NF、PC,就让 LostReasons 包含这两个值:

private static readonly string[] LostReasons = new string[] { "NF", "PC" };
// 或者与原值合并:
// private static readonly string[] LostReasons = new string[] { "CM", "PR", "RL", "TH", "OT", "NF", "PC" };

同时,字段的 PXStringList 也要包含这些 code 和对应描述。否则下拉可能只显示 code,或者因为找不到描述而出现异常。合并写法如下:

[PXStringList(
    new string[] { "NF", "PC", "CM", "PR", "RL", "TH", "OT" },
    new string[] { "Not Funded", "Project Cancelled", "Company Maturity", "Price", "Relationship", "Technology", "Other" })]

ComboBoxValues 传入的 code 必须和 PXStringList 里的 code 一致。只改一边,常见结果就是下拉为空、直接显示 code,或者出现 “No data available”。

动态值的推荐做法

如果下拉列表依赖运行时条件,优先在 Workflow 的状态配置里生成或选择数组,或者在 graph 的字段选择事件里按条件设置下拉值。不要只依赖 CacheAttached,它描述的是字段的静态 attribute,不负责按状态动态覆盖。可用的 API 会随版本和配置方式变化,实际以当前版本的 Workflow 和字段状态 API 为准。

检查清单

  • 搜索 ComboBoxValues 和 CROpportunity.resolution,确认是否有状态配置覆盖。
  • 确认旧 OpportunityReason.ListAttribute 已被移除,且没有重复 PXStringList。
  • 确认 ComboBoxValues 数组与 PXStringList 的 code 完全一致。
  • 确认字段最终是否处于 IsDisabled() 状态;disabled 字段的显示逻辑也可能影响使用体验。

备注:内容仅供参考。