SuperAPI AI 工具集

using-ui-bundle-salesforce-data

营销与增长

查看项目

更新于 10-16 08:47

技能介绍

用途:当项目含 uiBundles/*/src/ 目录且任务涉及任意 Salesforce 记录操作(读取、创建、更新、删除)时启用。所有数据访问必须使用 Data SDK(@salesforce/sdk-data),由 SDK 处理认证、CSRF 与 base URL。

主要能力:通过 sdk.graphql 执行记录查询与变更(uiapi 命名空间,首选);通过 sdk.fetch 调用受支持的 REST 端点,包括 UI API 记录元数据、Apex REST、Connect REST 文件上传配置、Einstein LLM 文本生成。不支持企业 REST SOQL 查询端点、@AuraEnabled Apex、Chatter API 及其他未列出的端点。

使用方式:先验证前置条件——已安装 @salesforce/sdk-data、项目根存在 schema.graphql、自定义对象/字段已部署(用 graphql-search.sh <Entity> 检查)。未满足时可先搭建组件、路由与 UI 逻辑,数据用空数组或 null,并标注 // TODO: add query after schema verification,在 schema 流程完成前不要编写 GraphQL 查询字符串。查询前用 bash scripts/graphql-search.sh Account 等确认实体与字段,最多运行 2 次、最多 3 轮内省。写查询后运行 npm run graphql:codegen 生成 src/api/graphql-operations-types.ts,并用 npx eslint <file> 校验。

关键规则:Salesforce GraphQL 返回 HTTP 200 也可能失败,必须解析 errors 数组;字段名区分大小写,自定义对象用 __c/__e,v60+ 对象可能带 _Record 后缀;读取查询所有记录字段加 @optional,消费代码用 ?. 与 ??;变更须包裹 uiapi(input: { allOrNone: true/false });查询必须显式写 first:,否则默认 10 条,分页仅支持 first/after;只生成用户明确要求的字段;过滤排序复合字段用组成字段。

限制:子查询最多 10 个、子到父最多 5 层、父到子最多 1 层、每子查询最多 2000 条;排序不支持多选选项列表、富文本、长文本区、加密字段;变更输出不能含子关系或导航引用字段;嵌套子创建不支持,需用 @{alias} 链式创建。资料未提供收费、价格与平台信息。