SuperAPI AI 工具集

platform-custom-field-generate

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:在用户创建、生成或校验 Salesforce CustomField 元数据时,按 Metadata API 约束产出可直接部署的 XML,并优先规避高失败率的 Roll-Up Summary 与 Master-Detail 类型。

主要能力:

  1. 通用属性:每个字段需含 fullName、label、description、inlineHelpText;fullName 由 label 推导(各词首字母大写、空格换下划线、追加 __c,且以字母开头),但选项值 fullName 保留用户原始拼写,不加 __c。若用户提到集成、导入数据、外部系统 ID 或唯一键,且类型为 Text/Number/Email,则设置 externalId。
  2. 类型与数学约束:precision ≤ 18 且 scale ≤ precision;Text 最大长度 255;TextArea 不得写 length(API 固定 255);LongTextArea 与多选选项列表需 visibleLines;Currency 默认 precision 18、scale 2,Percent 默认 precision 5、scale 2;Checkbox 默认 false;AutoNumber 需含 {0} 的 displayFormat 与 startingNumber。
  3. 文件路径(SFDX):force-app/main/default/objects/<Object>/fields/<FieldName>__c.field-meta.xml。
  4. 主从关系:禁止 required、deleteConstraint、lookupFilter;relationshipOrder 首个为 0、第二个为 1;relationshipName 用复数 PascalCase;每对象最多 2 个主从关系。对比 Lookup 需 deleteConstraint,可选 lookupFilter。
  5. 汇总字段:type 固定 Summary,summaryOperation 为 count/sum/min/max;summaryForeignKey 与 summarizedField 均须用 ChildObject__c.Field__c 全限定格式;sum/min/max 必须有 summarizedField,count 不需要;禁止 precision、scale、required、length;仅能建在主从关系父对象上。
  6. 公式字段:Formula 不是类型,type 取结果类型(Checkbox/Currency/Date/DateTime/Number/Percent/Text);公式内容须用 CDATA 包裹,含 ]]> 时需拆分 CDATA;不得使用 returnType;Number/Currency/Percent 用 BlankAsZero,Text/Date/DateTime 用 BlankAsBlank;公式字段不得带 length;选项比较用 ISPICKVAL();被引用字段需先部署。
  7. 选项列表:除非用户明确要求可自定义值,否则设 restricted 为 true;valueSet 中 valueSetName 与 valueSetDefinition 二选一,引用时用裸开发者名(不加 __gvs 或 __c);依赖选项列表使用 API 38.0+ 的 controllingField 加 valueSettings 形式,且控制字段与依赖字段都必须 restricted;按记录类型限定选项值需写在 RecordType 上,仅 Opportunity/Lead/Case/Solution 需要额外 BusinessProcess 文件。

适用场景:需要生成或校验 Salesforce 字段元数据的开发与部署流程。

限制:不负责一般记录类型(紧凑布局、页面布局、品牌)的创作;创建 value set 属另一技能;更完整的公式函数参考交由平台校验规则生成技能;资料未提供收费、价格或平台支持范围等其他信息。