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 のライフサイクル全体を管理します。ルールを非アクティブな状態で作成し、すべてのマッピングを追加してから、少なくとも1つのマッピングが存在する場合にのみ有効化します。

使用方法

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 を指定しない削除はスクリプトで拒否されます。
  • 既存の同一マッピングは再利用されます。

範囲

よりシンプルな1つのマッピングを使う Metadata API ワークフローには、service-omni-work-skill-routing-configure を使用してください。Tooling CRUD、複数のマッピング、有効化の制御、または削除を明示的に求められた場合は、このスキルを使用してください。

参考資料

ペイロードまたは複合 Metadata の処理を変更する前に、references/api-notes.md をお読みください。

コメント

Markdown 対応