用途:通过 Tooling API 管理 Omni-Channel 基于属性的路由规则,覆盖 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 与基于技能的路由,且引用的 Skill 记录必须已存在。激活时会读取完整 Metadata 复合结构,保留所有映射,移除只读的 urls 成员,仅修改 isActive,并通过冷读取验证。脚本会拒绝无映射的激活、无效技能级别、无效附加技能优先级,以及未设置 CONFIRM_DELETE=1 的删除。已存在的相同映射会被复用。
边界:若只需更简单的单映射 Metadata API 工作流,应使用 service-omni-work-skill-routing-configure;当明确需要 Tooling CRUD、多映射、激活控制或删除时使用本技能。修改载荷或复合 Metadata 处理前,请先阅读 references/api-notes.md。