用途:为 React Web 应用添加文件上传能力,并将文件与 Salesforce ContentVersion 集成。该包仅提供 API,不导出 React 组件或 hooks,需自行构建文件输入、拖拽区与进度条等 UI。
主要能力:upload() 处理上传并支持 onProgress 回调跟踪进度;提供三种模式——基础上传(不关联记录,返回 contentBodyId)、上传并立即关联已有记录(传 recordId,返回 contentVersionId)、延迟关联(先上传,记录创建后用 createContentVersion 关联);getCurrentUserId() 可获取当前用户 ID 以关联到个人资料;支持 AbortController 取消上传。
使用方式:安装 npm install @salesforce/webapp-template-feature-react-file-upload-experimental,依赖自动安装。调用 upload({ files, recordId?, onProgress?, signal? }),进度状态含 pending、uploading、processing、success、error。
适用场景:多步表单、记录创建后附加文件、直接上传并附加到 Account/Opportunity/Case 等记录。
限制:不提供预构建组件与 hooks;需自行处理 UI 与错误展示;CORS、权限与记录 ID 有效性需自行确认。