SuperAPI AI 工具集

implementing-ui-bundle-file-upload

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:当项目包含 uiBundles/*/src/ 目录且任务涉及上传、附加或拖放文件时,使用该技能在 React UI bundle 中实现文件上传功能。该包仅提供编程 API,不导出 React 组件或 hooks,UI 需自行构建。

主要能力:upload() 处理文件上传并支持进度回调;提供三种模式——基础上传(仅返回 contentBodyId)、上传并立即关联已有记录(传 recordId,创建 ContentVersion)、延迟关联(先上传,记录创建后用 createContentVersion 关联);getCurrentUserId() 可获取当前用户 ID 以关联到个人库;支持 AbortController 取消上传。

使用方式:安装 npm install @salesforce/ui-bundle-template-feature-react-file-upload,自动安装 @salesforce/ui-bundle 与 @salesforce/sdk-data。调用 upload({ files, recordId?, onProgress?, signal? }),返回 FileUploadResult[],含 fileName、size、contentBodyId,传 recordId 时含 contentVersionId。onProgress 状态包括 pending、uploading、processing、success、error。

适用场景:Salesforce React UI bundle 中的文件上传、附件关联、创建记录后补传附件、上传到当前用户个人库。

限制:不导出 <FileUpload />、useFileUpload 或 dropzone 组件,源码中的参考实现仅供查看;需自行处理 CORS、权限与错误提示;必须提供进度反馈。具体收费与平台支持暂未提供。