用途:在 React Web 应用中为 Salesforce 自定义对象实现列表与创建记录功能,适用于构建 GraphQL 列表查询、创建记录并在不刷新页面的情况下更新列表,以及排查列表与创建操作相关的部署错误。
主要能力:列表通过 GraphQL 查询对象(executeGraphQL、uiapi.query.ObjectApiName__c),使用 webApplicationFeature(GraphQL)的连接结构(first/after、edges.node、field { value, displayValue }),将节点映射为简单摘要类型,必要时在客户端按日期或其他字段排序。创建使用 @salesforce/webapp-experimental/api 的 createRecord,字段要求与 id 处理参见 webApplicationCreatingRecords。
使用方式:用一个 hook 在挂载时获取列表并暴露 refetch,创建成功后调用 refetch() 使列表更新而无需整页刷新。表单只收集对象上存在的字段;选项列表字段使用与对象值集匹配的选项值,对象定义默认值时设置默认必填选项列表(如 Status 为 New、Priority 为 Standard)。UI 可用表格或卡片展示列表,表单置于上方或单独路由,并为列表和提交显示加载与错误状态;可选仪表板小组件展示列表切片(如前 N 项)并附“查看全部”链接。
结构建议:API 列表与创建放在如 src/api/<objectName>Api.ts(查询函数与创建函数);hook 放在如 src/hooks/use<ObjectName>List.ts,返回 { items, loading, error, refetch };页面包含受控输入表单(提交→创建→refetch)与项目表格/列表。
限制:资料未提供具体安装命令、版本要求、收费信息或平台限制,暂未提供。