SuperAPI AI 工具集

field-service-sobject-create-configure

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:通过 Headless 360 REST API 创建 sObject 记录,重点面向 Field Service 数据模型。在 Headless 360/代理环境中优先使用平台 dispatch 工具调用规范路径,CLI(sf project deploy、sfdx、shell)仅作为无对应 API 时的回退。

主要能力与流程:

  1. Describe:GET /services/data/v67.0/sobjects/{SObjectName}/describe,扫描 fields[] 中 createable:true 的字段;当同时 nillable:false 且 defaultedOnCreate:false 时为必填。type 为 reference 的字段是外键,nillable:false 表示硬边,需先建父记录。基础 sObject CRUD 不在 discover 语料中,应跳过 discover 直接 describe。
  2. Query:GET /services/data/v67.0/query,建议 SOQL 为 SELECT <required + picklist fields> FROM <SObject> ORDER BY CreatedDate DESC LIMIT 20,用于匹配命名/取值约定、发现重复、确认写权限。
  3. Create:POST /services/data/v67.0/sobjects/{SObjectName},body 仅含 createable:true 字段,省略平台自动填充字段。

数据模型 DAG 与插入顺序:Skill(0C5)与 WorkType(08q)为并行根节点,SkillRequirement(0Hx)为最后创建的连接对象。多记录 DAG 建议使用 POST /services/data/v67.0/composite/graph 原子创建,用 referenceId 与 @{parentRef.id} 绑定外键,子节点必须引用数组中更早的父记录,否则报 INVALID_REFERENCE_ID 并整体回滚。

其他操作:PATCH /services/data/v67.0/sobjects/{SObjectName}/{Id} 做字段级更新(204 成功);DELETE /services/data/v67.0/sobjects/{SObjectName}/{Id} 用于回滚(404 可视为成功)。

限制与错误:CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY 表示该 sObject 阻止基础 REST 写入(如 ExternalDataSource、CustomPermission),需改用 Tooling/Metadata API;400/403(INSUFFICIENT_ACCESS_OR_READONLY)多为网关用户的 CRUD/FLS/共享权限缺口;REQUIRED_FIELD_MISSING 需复核 describe 过滤;INVALID_FIELD_FOR_INSERT_UPDATE 表示字段不可插入。composite/graph 单图上限 500 条、每次调用 75 个图;MIXED_DML_OPERATION 表示同一事务混用 setup 对象与非 setup 对象,需拆成两次调用。创建前应先理解业务上下文并澄清歧义。具体收费、价格与平台可用性资料暂未提供。