Protocol Launcher

简体中文

English

简体中文

English

Appearance

Salesforce Mobile ​

Salesforce Mobile 是 Salesforce 的移动端 CRM 应用。Protocol Launcher 允许你生成 Salesforce Mobile URL scheme 链接。

使用 ​

有两种方式使用这个库：

  • 按需从子路径导入，支持 tree-shaking 并保持 bundle 更小。
  • 从根包完整导入，适合快速脚本或 demo，但会包含所有 app 模块。

生产构建建议使用按需导入；完整导入适合快速脚本或演示。

选择安装方式

按需加载
推荐使用。生产环境优化。
全量导入
使用便捷。适合快速脚本。

说明 ​

本模块只封装 Salesforce Help 官方文档记录的 Salesforce Mobile app URL scheme 格式：用于记录、文件和用户操作的 salesforce1://sObject/<id>/<action>，以及用于对象首页的 salesforce1://sObject/<ObjectName>/home。

本模块不会生成通用 Salesforce HTTPS 记录 URL，也不会生成旧的 com.salesforce.salesforce1://entity/... 变体。Salesforce 文档记录了 15 或 18 位记录 ID、用于 ContentDocument 和 ContentDocumentVersion 对象的 download、用于 User 记录的 follow，以及名为 s1oid、s1nid、s1uid 和 iosoru 的可选查询参数。

URL 方法 ​

查看记录 ​

在 Salesforce mobile app 中打开 Salesforce 记录详情页。

On-Demand
ts
import { viewRecord } from 'protocol-launcher/salesforce-mobile'

const url = viewRecord({
  id: '001D000000Jwj9v',
})
打开 Salesforce 记录

编辑记录 ​

在 Salesforce mobile app 中打开 Salesforce 记录编辑页。

On-Demand
ts
import { editRecord } from 'protocol-launcher/salesforce-mobile'

const url = editRecord({
  id: '006R0000001r7Rq',
})

对象首页 ​

在 Salesforce mobile app 中打开 Salesforce 对象首页。

On-Demand
ts
import { objectHome } from 'protocol-launcher/salesforce-mobile'

const url = objectHome({
  objectName: 'Account',
})
打开 Salesforce 对象首页

下载文件 ​

生成官方记录的文件下载 URL scheme。Salesforce 文档将此动作限定在 ContentDocument 和 ContentDocumentVersion 对象上，并说明 Android 只会打开文件，不会离线保存。

On-Demand
ts
import { downloadFile } from 'protocol-launcher/salesforce-mobile'

const url = downloadFile({
  id: '069R00000000mr3',
})

关注用户 ​

关注用户并导航到该用户的个人资料页。userid 字段会序列化为 Salesforce 官方记录的 userid 查询参数。

On-Demand
ts
import { followUser } from 'protocol-launcher/salesforce-mobile'

const url = followUser({
  id: '005R0000000Df5W',
  userid: '005R0000000HfcF',
})

附加查询参数 ​

当用户可能属于多个组织或 Experience Cloud 站点时，可以添加 Salesforce 官方记录的可选跳转上下文。

On-Demand
ts
import { viewRecord } from 'protocol-launcher/salesforce-mobile'

const url = viewRecord({
  id: '001D000000Jwj9v',
  s1oid: '00DT00000000ABC',
})

生成的 URL ​

ts
viewRecord(recordParams)
// => 'salesforce1://sObject/001D000000Jwj9v/view'

editRecord(editRecordParams)
// => 'salesforce1://sObject/006R0000001r7Rq/edit'

objectHome(objectHomeParams)
// => 'salesforce1://sObject/Account/home'

downloadFile(fileParams)
// => 'salesforce1://sObject/069R00000000mr3/download'

followUser(followUserParams)
// => 'salesforce1://sObject/005R0000000Df5W/follow?userid=005R0000000HfcF'

viewRecord(recordWithContextParams)
// => 'salesforce1://sObject/001D000000Jwj9v/view?s1oid=00DT00000000ABC'

官方文档 ​