SuperAPI AI 工具集

platform-metadata-retrieve

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:将 Salesforce 组织中的元数据检索到本地项目,命令为 sf project retrieve start。仅应使用 Bash 工具执行,不要使用 MCP 工具。

主要能力与检索模式:支持按全部更改、按源码目录、按元数据类型(含通配符)、按 manifest、按包名检索;可检索为源格式(默认)或元数据格式(ZIP),并支持忽略冲突、指定输出目录、等待时间、API 版本等选项。

使用方式:从含 sfdx-project.json 的 Salesforce 项目根目录运行,始终加 --json。常用命令:sf project retrieve start --json;sf project retrieve start --source-dir <path> --target-org <alias> --json;sf project retrieve start --metadata MetadataType:Name --target-org <alias> --json;sf project retrieve start --metadata 'MetadataType:Pattern*' --target-org <alias> --json;sf project retrieve start --manifest <path/to/package.xml> --target-org <alias> --json;sf project retrieve start --package-name <PackageName> --target-org <alias> --json;sf project retrieve start --source-dir <path> --target-metadata-dir <output> --unzip --target-org <alias> --json。

限制:通配符须加引号;--manifest 不能与 --metadata 或 --source-dir 混用;全部更改模式依赖源跟踪,生产组织不支持,需改用其他模式;--ignore-conflicts 仅对可跟踪组织(scratch/sandbox)有效;--output-dir 必须在项目内且不能等于包目录;默认等待 33 分钟,大批量可用 --wait 覆盖;检索包仅作参考,不应纳入源码控制用于开发。常见问题包括未在 SFDX 项目目录运行、组织未认证、源跟踪不支持、输出路径冲突、检索超时或本地改动被覆盖,可按资料给出的方式处理。