Salesforce数据管理

技能简介

本技能通过Salesforce CLI（ sf ）连接并操作Salesforce组织数据，支持SOQL/SOSL查询、记录增删改查、批量导入导出、Apex代码执行、元数据部署及REST API调用。

业务背景

帮助业务分析师和开发人员直接通过命令行访问 Salesforce 核心数据，无需登录网页端即可完成查询分析、记录维护和批量操作。显著提升数据排查效率，支持自动化脚本集成，减少重复性手工操作的时间消耗。

落地案例：销售运营需要核对本季度大额订单的客户信息。分析师通过 sf 命令行连接生产组织，执行带关联查询的 SOQL 语句一次性拉取订单金额、客户名称及负责人字段，输出 CSV 后直接透视分析。发现数据异常时，在沙盒环境验证更新脚本，确认无误后再申请权限修复生产记录。

能做什么

• 执行SOQL查询获取业务数据，支持关联查询与条件过滤
• 运行SOSL跨对象文本搜索
• 创建、读取、更新、删除单条或批量记录
• 执行Apex代码进行复杂业务逻辑处理
• 部署和检索元数据配置
• 发起原始REST API请求访问自定义端点

使用说明

安装步骤

1. 安装Salesforce CLI：npm install -g @salesforce/cli
2. 验证安装：sf --version
3. 浏览器登录认证：sf org login web --alias my-org

常用操作示例

基础SOQL查询：

sf data query --query "SELECT Id, Name, Email FROM Contact LIMIT 10" --json

按条件筛选机会记录：

sf data query --query "SELECT Id, Name, Amount FROM Opportunity WHERE StageName = 'Closed Won'" --json

创建新记录（需用户确认）：

sf data create record --sobject Account --values "Name=NewCustomer Industry=Technology" --json

批量导出数据：

sf data export bulk --query "SELECT Id, Name, Email FROM Contact" --output-file contacts.csv --result-format csv --wait 10

执行Apex代码：

sf apex run --file myScript.apex --json

输入与输出

见下方输入与输出表格。

风险提示

• 所有写操作（创建/更新/删除）执行前必须获得用户明确确认
• --json标志确保输出结构化，便于下游解析
• 包含刷新令牌的详细组织信息属于敏感数据，勿随意分享
• 生产环境操作前建议在沙盒环境测试
• JWT登录方式适用于CI/CD自动化场景，需妥善保管密钥文件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/arvorco/salesforce/SKILL.md
来源类型：GitHub仓库