sf-industry-commoncore-omnistudio-analyze: OmniStudio クロスコンポーネント分析

名前空間検出、依存関係マッピング、OmniStudio コンポーネント全体にわたる影響分析を専門とする OmniStudio エキスパート分析。自動依存グラフ構築と Mermaid 可視化を備えた、組織全体の OmniScripts、FlexCards、Integration Procedures、Data Mappers のインベントリを実行します。

コア責務

1. 名前空間検出: 組織が Core (Industries)、vlocity_cmt (Communications, Media & Energy)、または vlocity_ins (Insurance & Health) 名前空間を使用しているかを識別
2. 依存関係分析: 循環参照検出を使用した BFS トラバーサルでコンポーネント間の依存グラフを構築
3. 影響分析: OmniScript、IP、FlexCard、または Data Mapper が変更された場合に影響を受けるコンポーネントを決定
4. Mermaid 可視化: ドキュメンテーションとレビューのために Mermaid 構文で依存図を生成
5. 組織全体インベントリ: すべての OmniStudio コンポーネントをタイプ、ステータス、言語、バージョン別にカタログ化

---

重大: オーケストレーション順序

複数の OmniStudio スキルが関係する場合は、この依存チェーンに従います:

sf-industry-commoncore-omnistudio-analyze → sf-industry-commoncore-datamapper → sf-industry-commoncore-integration-procedure → sf-industry-commoncore-omniscript → sf-industry-commoncore-flexcard

このスキルが最初に実行され、ダウンストリームスキルが使用する名前空間コンテキストと依存マップを確立します。

---

主要な洞察

洞察	詳細
3 つの名前空間が共存	Core (OmniProcess)、vlocity_cmt (vlocity_cmt__OmniScript__c)、vlocity_ins (vlocity_ins__OmniScript__c)
依存関係は JSON に格納	PropertySetConfig (要素)、Definition (FlexCards)、InputObjectName/OutputObjectName (Data Mappers)
循環参照が可能	OmniScript A → IP B → OmniScript A (埋め込まれた呼び出し経由)
FlexCard データソースは型付け	DataSourceConfig JSON での dataSource.type === 'IntegrationProcedures' (複数形)
アクティブ vs ドラフトが重要	ランタイム依存チェーンに参加するのはアクティブなコンポーネントのみ

---

ワークフロー (4 段階パターン)

フェーズ 1: 名前空間検出

目的: コンポーネントメタデータをクエリする前に、組織が使用する OmniStudio 名前空間を決定します。

検出アルゴリズム — 成功した COUNT() が返されるまでオブジェクトを順番に試行:

1. Core (Industries 名前空間):

   SELECT COUNT() FROM OmniProcess
   

   成功した場合、組織は Core 名前空間を使用します (API 234.0+ / Spring '22+)。

2. vlocity_cmt (Communications, Media & Energy):

   SELECT COUNT() FROM vlocity_cmt__OmniScript__c
   

3. vlocity_ins (Insurance & Health):

   SELECT COUNT() FROM vlocity_ins__OmniScript__c
   

すべて失敗する場合、OmniStudio は組織にインストールされていません。

名前空間検出用の CLI コマンド:

# Core 名前空間プローブ
sf data query --query "SELECT COUNT() FROM OmniProcess" --target-org myorg --json 2>/dev/null

# vlocity_cmt 名前空間プローブ
sf data query --query "SELECT COUNT() FROM vlocity_cmt__OmniScript__c" --target-org myorg --json 2>/dev/null

# vlocity_ins 名前空間プローブ
sf data query --query "SELECT COUNT() FROM vlocity_ins__OmniScript__c" --target-org myorg --json 2>/dev/null

結果の評価: 成功したクエリ (終了コード 0 で JSON に totalSize を含む) は名前空間を確認します。クエリ失敗 (INVALID_TYPE または sObject type not found) は、その名前空間が存在しないことを意味します。

参照: references/namespace-guide.md - 3 つの名前空間すべてにわたるオブジェクト/フィールドマッピング完全ガイド。

---

フェーズ 2: コンポーネント発見

目的: 組織内のすべての OmniStudio コンポーネントのインベントリを構築します。

検出された名前空間を使用して、各コンポーネントタイプをクエリします:

OmniScripts (Core 例):

SELECT Id, Type, SubType, Language, IsActive, VersionNumber,
       PropertySetConfig, LastModifiedDate
FROM OmniProcess
WHERE IsIntegrationProcedure = false
ORDER BY Type, SubType, Language, VersionNumber DESC

Integration Procedures (Core 例):

SELECT Id, Type, SubType, Language, IsActive, VersionNumber,
       PropertySetConfig, LastModifiedDate
FROM OmniProcess
WHERE IsIntegrationProcedure = true
ORDER BY Type, SubType, Language, VersionNumber DESC

FlexCards (Core 例):

SELECT Id, Name, IsActive, DataSourceConfig, PropertySetConfig,
       AuthorName, LastModifiedDate
FROM OmniUiCard
ORDER BY Name

重要: OmniUiCard オブジェクトには Definition フィールドがありません。データソースバインディングに DataSourceConfig、カードレイアウト/ステート構成に PropertySetConfig を使用します。

Data Mappers (Core 例):

SELECT Id, Name, IsActive, Type, LastModifiedDate
FROM OmniDataTransform
ORDER BY Name

Data Mapper Items (オブジェクト依存関係抽出用):

SELECT Id, OmniDataTransformationId, InputObjectName, OutputObjectName,
       InputObjectQuerySequence
FROM OmniDataTransformItem
WHERE OmniDataTransformationId IN ({datamapper_ids})

重要: 外部キーフィールドは OmniDataTransformationId (完全な単語 "Transformation")、NOT OmniDataTransformId です。

CLI コマンドパターン:

sf data query --query "SELECT Id, Type, SubType, Language, IsActive FROM OmniProcess WHERE IsIntegrationProcedure = false" \
  --target-org myorg --json

---

フェーズ 3: 依存関係分析

目的: コンポーネントメタデータをパースして有向依存グラフを構築します。

アルゴリズム: 循環検出を伴う BFS

1. 空のグラフ G とvisited セット V を初期化
2. 各ルートコンポーネント C に対して:
   a. C をワークキュー Q にエンキュー
   b. Q が空になるまで:
      i.   Q から X をデキュー
      ii.  X が V にある場合、循環参照を記録しスキップ
      iii. V に X を追加
      iv.  X のメタデータを依存参照のパース
      v.   見つかった各依存 D に対して:
           - グラフ G に X → D のエッジを追加
           - D が V にない場合、D を Q にエンキュー
3. グラフ G と検出された循環参照を返す

要素型 → 依存関係抽出

OmniScript と IP 要素は参照を PropertySetConfig JSON フィールドに格納します。各要素をパースして依存関係を抽出します:

要素型	PropertySetConfig の JSON パス	依存ターゲット
DataRaptor Transform Action	bundle, bundleName	Data Mapper (名前別)
DataRaptor Turbo Action	bundle, bundleName	Data Mapper (名前別)
Remote Action	remoteClass, remoteMethod	Apex Class.Method
Integration Procedure Action	integrationProcedureKey	IP (Type_SubType)
OmniScript Action	omniScriptKey または Type/SubType	OmniScript (Type_SubType)
HTTP Action	httpUrl, httpMethod	外部エンドポイント (URL)
DocuSign Envelope Action	docuSignTemplateId	DocuSign テンプレート
Apex Remote Action	remoteClass	Apex Class

PropertySetConfig のパース:

各 OmniProcessElement に対して:
  1. PropertySetConfig を読み込み (JSON 文字列)
  2. JSON をパース
  3. element.Type を抽出テーブルに対して確認
  4. 参照コンポーネント名/キーを抽出
  5. 参照を OmniProcess/OmniDataTransform レコードに解決
  6. エッジを追加: 親コンポーネント → 参照コンポーネント

FlexCard データソースパース

FlexCards はデータソース構成を DataSourceConfig JSON フィールドに格納します (NOT Definition — このフィールドは OmniUiCard には存在しません):

DataSourceConfig JSON をパース:
  1. dataSource オブジェクト (配列ではなく単数形) にアクセス
  2. type === 'IntegrationProcedures' (注: 複数形) である各 dataSource に対して:
     - dataSource.value.ipMethod (IP Type_SubType) を抽出
     - エッジを追加: FlexCard → Integration Procedure
  3. type === 'ApexRemote' である各 dataSource に対して:
     - dataSource.value.className を抽出
     - エッジを追加: FlexCard → Apex Class
  4. childCard 参照の場合、PropertySetConfig をパース:
     - エッジを追加: FlexCard → 子 FlexCard

重要: IP のデータソースタイプは IntegrationProcedures (複数形で大文字 P)、NOT IntegrationProcedure です。

Data Mapper オブジェクト依存関係

Data Mappers はそのアイテムを経由して Salesforce オブジェクトを参照します:

各 OmniDataTransformItem に対して:
  1. InputObjectName を読み込み → ソース sObject
  2. OutputObjectName を読み込み → ターゲット sObject
  3. エッジを追加: Data Mapper → sObject (InputObjectName から読み込み)
  4. エッジを追加: Data Mapper → sObject (OutputObjectName に書き込み)

参照: references/dependency-patterns.md - 完全な依存関係抽出ルールと例。

---

フェーズ 4: 可視化とレポート

目的: 依存グラフから人間が読める出力を生成します。

出力形式 1: Mermaid 依存図

graph LR
    subgraph OmniScripts
        OS1["createOrder<br/>English v3"]
        OS2["updateAccount<br/>English v1"]
    end
    subgraph Integration Procedures
        IP1["fetchAccountData<br/>English v2"]
        IP2["submitOrder<br/>English v1"]
    end
    subgraph Data Mappers
        DM1["AccountExtract"]
        DM2["OrderTransform"]
    end
    subgraph FlexCards
        FC1["AccountSummaryCard"]
    end

    OS1 -->|IP Action| IP2
    OS1 -->|DR Action| DM2
    OS2 -->|IP Action| IP1
    IP1 -->|DR Action| DM1
    FC1 -->|Data Source| IP1

    style OS1 fill:#dbeafe,stroke:#1d4ed8,color:#1f2937
    style OS2 fill:#dbeafe,stroke:#1d4ed8,color:#1f2937
    style IP1 fill:#fef3c7,stroke:#b45309,color:#1f2937
    style IP2 fill:#fef3c7,stroke:#b45309,color:#1f2937
    style DM1 fill:#d1fae5,stroke:#047857,color:#1f2937
    style DM2 fill:#d1fae5,stroke:#047857,color:#1f2937
    style FC1 fill:#fce7f3,stroke:#be185d,color:#1f2937

カラースキーム:

コンポーネント型	塗りつぶし	ストローク
OmniScript	#dbeafe (blue-100)	#1d4ed8 (blue-700)
Integration Procedure	#fef3c7 (amber-100)	#b45309 (amber-700)
Data Mapper	#d1fae5 (green-100)	#047857 (green-700)
FlexCard	#fce7f3 (pink-100)	#be185d (pink-700)
Apex Class	#e9d5ff (purple-100)	#7c3aed (purple-700)
外部 (HTTP)	#f1f5f9 (slate-100)	#475569 (slate-600)

出力形式 2: JSON サマリー

{
  "namespace": "Core",
  "components": {
    "omniScripts": 12,
    "integrationProcedures": 8,
    "flexCards": 5,
    "dataMappers": 15
  },
  "dependencies": [
    { "from": "OS:createOrder", "to": "IP:submitOrder", "type": "IPAction" },
    { "from": "IP:fetchAccountData", "to": "DM:AccountExtract", "type": "DataRaptorAction" }
  ],
  "circularReferences": [],
  "impactAnalysis": {
    "DM:AccountExtract": {
      "directDependents": ["IP:fetchAccountData"],
      "transitiveDependents": ["OS:updateAccount", "FC:AccountSummaryCard"]
    }
  }
}

出力形式 3: 人間が読める形式のレポート

OmniStudio 依存関係レポート
===========================
組織名前空間: Core (Industries)
スキャン日時: 2026-03-06

コンポーネントインベントリ:
  OmniScripts:              12 (8 アクティブ、4 ドラフト)
  Integration Procedures:    8 (6 アクティブ、2 ドラフト)
  FlexCards:                  5 (5 アクティブ)
  Data Mappers:             15 (12 アクティブ、3 ドラフト)

依存関係サマリー:
  総エッジ数:              23
  循環参照:                0
  孤立したコンポーネント:   2 (インバウンド/アウトバウンド依存なし)

影響分析 (最も依存されるコンポーネント):
  1. DM:AccountExtract       → 5 個の依存
  2. IP:fetchAccountData     → 3 個の依存
  3. DM:OrderTransform       → 2 個の依存

---

名前空間オブジェクト/フィールドマッピング

3 つの名前空間すべてにわたる OmniStudio オブジェクトとフィールドの完全なマッピング:

プライマリオブジェクト

概念	Core	vlocity_cmt	vlocity_ins
OmniScript / IP コンテナ	OmniProcess	vlocity_cmt__OmniScript__c	vlocity_ins__OmniScript__c
OmniScript / IP 要素	OmniProcessElement	vlocity_cmt__Element__c	vlocity_ins__Element__c
FlexCard	OmniUiCard	vlocity_cmt__VlocityUITemplate__c	vlocity_ins__VlocityUITemplate__c
Data Mapper	OmniDataTransform	vlocity_cmt__DRBundle__c	vlocity_ins__DRBundle__c
Data Mapper Item	OmniDataTransformItem	vlocity_cmt__DRMapItem__c	vlocity_ins__DRMapItem__c

キーフィールド

概念	Core フィールド	vlocity_cmt フィールド	vlocity_ins フィールド
スクリプトタイプ	Type	vlocity_cmt__Type__c	vlocity_ins__Type__c
スクリプトサブタイプ	SubType	vlocity_cmt__SubType__c	vlocity_ins__SubType__c
言語	Language	vlocity_cmt__Language__c	vlocity_ins__Language__c
アクティブか	IsActive	vlocity_cmt__IsActive__c	vlocity_ins__IsActive__c
バージョン	VersionNumber	vlocity_cmt__Version__c	vlocity_ins__Version__c
要素構成	PropertySetConfig	vlocity_cmt__PropertySet__c	vlocity_ins__PropertySet__c
Integration Procedure か	IsIntegrationProcedure	vlocity_cmt__IsIntegrationProcedure__c	vlocity_ins__IsIntegrationProcedure__c
FlexCard データソース	DataSourceConfig	vlocity_cmt__Definition__c	vlocity_ins__Definition__c
FlexCard レイアウト/ステート	PropertySetConfig	(同じフィールド)	(同じフィールド)
DM 入力オブジェクト	InputObjectName (Item上)	vlocity_cmt__InterfaceObject__c	vlocity_ins__InterfaceObject__c
DM 出力オブジェクト	OutputObjectName (Item上)	vlocity_cmt__TargetFieldObjectType__c	vlocity_ins__TargetFieldObjectType__c

参照: references/namespace-guide.md - デプロイメント時のメタデータ型名を含む完全なリファレンス。

---

CLI コマンドリファレンス

名前空間検出

# 3 つの名前空間をすべてプローブ (順番に実行、最初の成功で終了)
sf data query --query "SELECT COUNT() FROM OmniProcess" --target-org myorg --json 2>/dev/null && echo "CORE" || \
sf data query --query "SELECT COUNT() FROM vlocity_cmt__OmniScript__c" --target-org myorg --json 2>/dev/null && echo "VLOCITY_CMT" || \
sf data query --query "SELECT COUNT() FROM vlocity_ins__OmniScript__c" --target-org myorg --json 2>/dev/null && echo "VLOCITY_INS" || \
echo "NOT_INSTALLED"

コンポーネントインベントリ (Core 名前空間)

# OmniScripts をカウント
sf data query --query "SELECT COUNT() FROM OmniProcess WHERE IsIntegrationProcedure = false" \
  --target-org myorg --json

# Integration Procedures をカウント
sf data query --query "SELECT COUNT() FROM OmniProcess WHERE IsIntegrationProcedure = true" \
  --target-org myorg --json

# FlexCards をカウント
sf data query --query "SELECT COUNT() FROM OmniUiCard" --target-org myorg --json

# Data Mappers をカウント
sf data query --query "SELECT COUNT() FROM OmniDataTransform" --target-org myorg --json

依存関係データ抽出 (Core 名前空間)

# OmniScript 要素とその構成を取得
sf data query --query "SELECT Id, OmniProcessId, Name, Type, PropertySetConfig FROM OmniProcessElement WHERE OmniProcessId = '{process_id}'" \
  --target-org myorg --json

# FlexCard データソースを取得 (依存関係パース用)
sf data query --query "SELECT Id, Name, DataSourceConfig FROM OmniUiCard WHERE IsActive = true" \
  --target-org myorg --json

# Data Mapper アイテムを取得 (オブジェクト依存関係用)
sf data query --query "SELECT Id, OmniDataTransformationId, InputObjectName, OutputObjectName FROM OmniDataTransformItem" \
  --target-org myorg --json

---

クロススキル統合

スキル	関係性	このスキルの役割
sf-industry-commoncore-datamapper	名前空間とオブジェクト依存関係データを提供	Data Mapper オーサリングは検出された名前空間を使用して正しい API 名を使う
sf-industry-commoncore-integration-procedure	名前空間と IP 依存マップを提供	IP オーサリングは依存グラフを使用して循環参照を回避
sf-industry-commoncore-omniscript	名前空間と要素依存データを提供	OmniScript オーサリングは名前空間正確なフィールド名を使う
sf-industry-commoncore-flexcard	名前空間とデータソース依存マップを提供	FlexCard オーサリングは検出された IP 参照を使用して検証
sf-diagram-mermaid	可視化用に依存グラフを使用	このスキルは sf-diagram-mermaid スタイリングと互換性のある Mermaid 出力を生成
sf-metadata	Data Mapper 分析用に sObject メタデータを提供	依存関係抽出時のオブジェクトフィールド検証
sf-deploy	デプロイメント時に名前空間正確なメタデータ型を使用	このスキルは名前空間ごとの正しいメタデータ型名を提供

---

エッジケース

シナリオ	処理方法
混在名前空間組織 (移行中)	3 つの名前空間すべてをプローブ; 複数が結果を返す場合は報告。コンポーネントは古い名前空間と移行後の名前空間の両方に存在する可能性あり。
アクティブでないコンポーネントの依存関係	依存グラフに含めますがアクティブでないとマーク。アクティブなコンポーネントがアクティブでないものに依存する場合は警告。
大規模組織 (1000+ コンポーネント)	SOQL ページネーション (LIMIT/OFFSET または queryMore) を使用。200 個単位でバッチ処理。
PropertySetConfig が SOQL フィールド長を超過	Tooling API または REST API を使用して、トランケートされた構成を持つ要素の完全な JSON 本体を取得。
循環依存関係が検出	サイクルパス (A → B → C → A) をログに記録、参加しているすべてのエッジをマーク、残りのブランチの走査を続行。
削除されたアイテムを参照するコンポーネント	出力に「破損した参照」として記録。クリーンアップのためフラグを立てる。
バージョン競合 (複数のアクティブバージョン)	ランタイムに参加するのは最高のアクティブバージョン番号のみ。下位バージョンが一意の依存関係を持つ場合は警告。

---

注釈

• 依存関係: org 認証を備えた sf CLI が必要。オプション: スタイル付き可視化の場合は sf-diagram-mermaid。
• 名前空間を最初に検出: すべてのダウンストリームクエリは正しいオブジェクトとフィールド API 名の知識に依存します。
• PropertySetConfig がキー: ほぼすべての依存関係情報は OmniProcessElement レコード上のこの JSON フィールドに存在します。
• FlexCard 用の DataSourceConfig: データソースは DataSourceConfig にあり、NOT Definition フィールド (OmniUiCard には存在しません)。カードレイアウト/ステートは PropertySetConfig にあります。
• Data Mapper アイテムがオブジェクト参照を含む: OmniDataTransformItem レコード上の InputObjectName と OutputObjectName は、Data Mapper が読み込む/書き込む sObject を明かします。親への外部キーは OmniDataTransformationId (完全な "Transformation")。
• IsIntegrationProcedure は判別子: OmniProcess は (TypeCategory フィールド (存在しません) ではなく) ブール値 IsIntegrationProcedure フィールドを使用します。OmniProcessType ピックリストはこのブール値から計算され、読み込みフィルタリングには便利ですが、作成時に直接設定することはできません。
• sf data create record の制限: --values フラグは textarea フィールド (PropertySetConfig など) の JSON 文字列を処理できません。JSON 構成を持つレコードの場合は代わりに sf api request rest --method POST --body @file.json を使用します。
• 関連スキルをインストール: /plugin install github:Jaganpro/sf-skills/sf-industry-commoncore-datamapper, /plugin install github:Jaganpro/sf-skills/sf-industry-commoncore-integration-procedure, /plugin install github:Jaganpro/sf-skills/sf-industry-commoncore-omniscript, /plugin install github:Jaganpro/sf-skills/sf-industry-commoncore-flexcard

---

ライセンス

MIT ライセンス。 著作権 © 2026 David Ryan (weytani)