用途:在 React UI bundle 中实现文件上传功能。该包仅提供编程 API,不导出 React 组件或 hooks,需自行构建文件输入、拖放区、进度条等界面。
主要能力:upload() 处理上传并支持 onProgress 回调跟踪进度;createContentVersion() 将已上传文件手动关联到记录;getCurrentUserId() 获取当前用户 ID。支持三种模式:基础上传(仅返回 contentBodyId)、上传并立即关联已有记录(提供 recordId,返回 contentVersionId)、延迟关联(先上传,记录创建后再调用 createContentVersion 关联)。
使用方式:安装 npm install @salesforce/ui-bundle-template-feature-react-file-upload,依赖自动安装 @salesforce/ui-bundle 与 @salesforce/platform-sdk。调用 upload({ files, recordId?, onProgress?, signal? }),返回 FileUploadResult[],含 fileName、size、contentBodyId 及可选 contentVersionId。进度状态包括 pending、uploading、processing、success、error。可用 AbortController 取消上传。
适用场景:Salesforce 记录附件上传、多步表单延迟关联、上传至当前用户个人库等。
限制:不提供预构建组件或 hooks;源码中参考实现(FileUpload.tsx 等)仅供示例,不可导入;需处理 CORS、权限与错误提示;具体收费与平台支持范围暂未提供。