mcpField
S
service-omni-attribute-routing-configure

service-omni-attribute-routing-configure

github.com/forcedotcom其他1.1k57 次安装1 天前更新
代码仓库

关于 service-omni-attribute-routing-configure

通过 Tooling API 管理 Salesforce WorkSkillRouting 规则及 WorkSkillRoutingAttribute 映射生命周期的技能，支持多映射、受控激活和删除，并拒绝在生产客户 org 中写入。

主要功能

  1. 01列出并读取路由规则
  2. 02以非激活状态创建规则
  3. 03添加并复用技能映射
  4. 04存在映射后激活规则
  5. 05经确认后删除属性和规则

适用场景

  1. 01配置包含多个技能映射的路由规则
  2. 02添加映射期间保持规则未激活
  3. 03激活含映射的规则并验证
  4. 04移除属性或路由规则

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/forcedotcom/sf-skills --skill service-omni-attribute-routing-configure

安装后在 Claude Code 中输入/service-omni-attribute-routing-configure确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api-notes.md
scripts/
configure-and-report.sh
scripts/tests/
test_attribute_routing_contracts.py

详细介绍

service-omni-attribute-routing-configure

使用经批准的 Tooling API 合约，管理完整的 WorkSkillRouting 和 WorkSkillRoutingAttribute 生命周期。创建规则时保持非活动状态，添加所有映射，并且仅在至少存在一个映射后才激活。

用法

bash scripts/configure-and-report.sh <org> list
bash scripts/configure-and-report.sh <org> get <rule-id>
bash scripts/configure-and-report.sh <org> create <developer-name> <label> <related-entity>
bash scripts/configure-and-report.sh <org> add-attribute <rule-id> <Entity.Field> <value> <skill-id> <level> <related-entity> [additional] [priority]
bash scripts/configure-and-report.sh <org> set-active <rule-id> true|false
CONFIRM_DELETE=1 bash scripts/configure-and-report.sh <org> delete-attribute <attribute-id>
CONFIRM_DELETE=1 bash scripts/configure-and-report.sh <org> delete-rule <rule-id>

安全性与行为

  • 读取需要 View Setup 权限。写入需要 Customize Application 权限，并且在生产客户组织中会被拒绝。
  • 必须启用 Omni-Channel 和 Skills-Based Routing，且引用的 Skill 记录必须已存在。
  • 创建时始终从非活动状态开始。激活时会读取完整的 Metadata 复合数据，保留所有映射，移除只读的 urls 成员，仅更改 isActive，并通过冷读取进行验证。
  • 如果没有映射、技能等级无效、附加技能优先级无效，或删除时未设置 CONFIRM_DELETE=1，脚本会拒绝操作。
  • 已有的相同映射会被复用。

适用范围

对于更简单的单映射 Metadata API 工作流，请使用 service-omni-work-skill-routing-configure。如果用户明确需要 Tooling CRUD、多条映射、激活控制或删除，请使用此技能。

参考

更改负载或复合 Metadata 处理方式前，请阅读 references/api-notes.md。

评论

支持 Markdown