Acumatica更新Contact实体用户自定义字段报"view Document not found"的解决方案

报错说明 #

当按照官方文档通用指引将自定义字段视图名设置为Document发送更新请求时，即使实体普通字段可以正常读写，接口也会抛出System.InvalidOperationException，返回提示view Document is not found。

错误配置核心问题 #

对照实际运行验证结果，原请求体存在3处不符合Contact实体v2 API适配规则的问题：

• 自定义域根节点不匹配：文档中“自定义字段视图名固定为Document”是跨实体的通用说明，针对Contact实体的用户自定义字段，自定义字段块的根容器必须使用实体名Contact，而非通用文档视图名Document
• 字段类型定义错误：原配置中将布尔型自定义字段的类型标注为Checkbox，v2 API对应用户自定义布尔字段的标准类型枚举值为CustomBooleanField
• 字段值格式错误：原配置传入字符串类型的布尔值"True"，自定义字段要求传入对应原生数据类型的值，布尔类型直接传true即可
• 前置条件缺失：需要提前在Acumatica系统内完成目标用户自定义字段（示例中为AttributeEXPORTEDMC）的创建和Contact实体绑定，否则会出现字段匹配失败。

标准可运行请求结构 #

{
  "ContactID": {
    "value": "{{record.ContactID.value}}"
  },
  "custom": {
    "Contact": {
      "AttributeEXPORTEDMC": {
        "type": "CustomBooleanField",
        "value": true
      }
    }
  }
}

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