Integration Advisor: アーキテクチャと使用方法

- Integration Advisor(IA)はSAPのB2B戦略における設計時の中核を担う要素であり、クラウドソーシング型のB2B/A2A標準ライブラリと、タイプシステムをMIG(メッセージ仕様)、MAG(マッピング)、およびCloud Integrationにデプロイ可能なランタイムXSLT成果物に変換するML提案エンジンを提供します。
- 正直な成熟度評価:主流のEDIFACT/X12メッセージでは提案品質は高いものの、ニッチな標準や独自フォーマットでは弱いです。カスタムファンクションがほとんどのプロジェクトを停滞させ、タイプシステムはその原因ではありません。
- 考え方の転換:IAはTrading Partner Managementの代替ではありません。IAは仕様を担当し、TPMは契約とランタイムルーティングを担当します。実際のB2Bプロジェクトには両方が必要です。
本記事の位置づけ
| ID | カテゴリ | コンポーネント | 範囲 |
|---|---|---|---|
| BTP-A01 | 概要 | SAP Integration Suite | コンポーネントマップ |
| BTP-A02 | iPaaS | Cloud Integration (CPI) | アーキテクチャと使用方法 |
| BTP-A03 | APIライフサイクル | API Management | アーキテクチャと使用方法 |
| BTP-A04 | イベント処理 | Event Mesh | アーキテクチャと使用方法 |
| BTP-A05 | コネクタ | Open Connectors | アーキテクチャと使用方法 |
| BTP-A06 | B2B | Trading Partner Management | アーキテクチャと使用方法 |
| BTP-A07 | B2B | Integration Advisor | アーキテクチャと使用方法(本記事) |
| BTP-A08 | 意思決定 | Integration Suite | ユースケースと意思決定パターン |
参考資料
| リソース | URL |
|---|---|
| SAP Integration Advisor(ヘルプポータル) | help.sap.com → |
| 型システムの操作 | help.sap.com → |
| メッセージ実装ガイドライン(MIG)の作成 | help.sap.com → |
| マッピングガイドライン(MAG)の作成 | help.sap.com → |
| SAP Integration Suite — 料金 | sap.com → |
1) Integration Advisor のランドスケープ

Integration Advisorは単一のツールではなく、順次導入する5つの階層化された機能のスタックです。各階層にはそれぞれの所有者、成果物、および要件段階での障害モードが存在します。
| 機能 | 説明 | 主な利用者 | |
|---|---|---|---|
| タイプシステム | SAPが一元管理するB2B標準規格(EDIFACT、X12、RosettaNet、IDoc、HL7、SWIFTなど)のプリロード済みライブラリ | ライブラリ管理者 | |
| メッセージ実装ガイドライン(MIG) | 基本標準メッセージのカスタマイズ版サブセット — 顧客やパートナーが使用するセグメント、基数、コードリストを正確に指定 | 統合デザイナー / ビジネスアナリスト | |
| マッピングガイドライン(MAG) | 2つのMIG間(ソース→ターゲット)のフィールドレベルマッピング。デザイナーが承認または上書き可能なML提案マッピングを含む | 統合デザイナー | |
| カスタム関数 | 提案エンジンが推論できない変換(単位変換、条件ロジックなど)のためのGroovyまたはJavaScriptスニペット | 統合開発者 | |
| ランタイムアーティファクト生成 | 確定したMAGをXSLTマッピング+スキーマにコンパイルし、Cloud Integrationに統合パッケージとしてデプロイ可能にする | 統合開発者 / オペレーター |
これらは代替品ではありません。
2) S/4HANA への接続方法

Integration Advisorはデザインタイムに位置づけられます。同ツールが生成するアーティファクトは、S/4HANAが実際に通信するiPaaSであるCloud Integrationによってランタイム時に消費されます。これら2つのレイヤー間の境界を理解することが、最も有用なコンテキストです。
+--------------------------------+
Trading Partner | SAP Integration Suite tenant | SAP S/4HANA
(EDI VAN) | | (on-prem or
| | +--------------------------+ | Private)
| | | Integration Advisor | | |
| | | (design-time) | | |
v | | Type Sys → MIG → MAG | | |
============> | | | | | |
EDIFACT ORDERS | | v generates | | |
| | XSLT + XSD artifacts | | |
| +-------------+------------+ | |
| | | |
| v deployed to | |
| +--------------------------+ | |
| | Cloud Integration |<-+----------+
| | (runtime iflow) | | IDoc / OData
| | reads XSLT, transforms | |
| +--------------------------+ |
+--------------------------------+重要ポイント:Integration Advisorは本番環境のランタイムメッセージに一切関与しません。コード生成ツールであり、ランタイムエンジンではありません。 パートナーが午前3時に不正なEDIFACTメッセージを送信した場合、それを処理するのはCloud Integrationです。Integration Advisorは呼び出しパスには含まれません。
3) 成熟度マップ

| 機能 | 成熟度 | 備考 | |
|---|---|---|---|
| プリロード済みタイプシステム(EDIFACT、X12、IDoc) | ✅ 本番利用可能 | ライブラリは成熟しており、SAPによる一元的な更新が行われ、広く展開されています | |
| プロポーザルエンジンによるMIG設計 | ✅ 本番利用可能 | 一般的なORDERS/INVOIC/DESADVではプロポーザルの品質が最も高く、ニッチな業界では弱い | |
| プロポーザルエンジンによるMAG設計 | ⚠️ 前提条件ありで利用可能 | プロポーザルの品質は、特定のメッセージペアに対するクラウドライブラリのカバレッジに依存します。一般的でないマッピングでは手動での修正が必要になる場合があります | |
| カスタム関数(Groovy/JS) | ⚠️ 前提条件ありで利用可能 | 開発者レベルのスキルが必要です。導入調査で最も多く指摘される停滞要因です | |
| ランタイムアーティファクト生成 + Cloud Integrationへのデプロイ | ✅ 本番利用可能 | Cloud Integrationパッケージとの安定した統合パスを提供します | |
| PI/PO B2Bアドオンからの移行 | 🔶 アーリーアダプター向け | 統合されたSAP移行プレイブックはなく、コミュニティブログのみが存在します |
正直な話:提案エンジンは目に見える機能ですが、プロジェクトにおける実質的な制約は、表向きのMLではなく、ほとんどの場合カスタム関数とエッジケースのカスタム型システムです。
4) 要件チェックリスト
テナントとライセンスの前提条件

| チェックリスト項目 | 重要性 |
|---|---|
| Integration Suite Premium Editionの権限がIntegration Advisorをカバーしていることを確認する | Standard EditionおよびFree TierではIAは含まれません。権限がない場合、BTPコックピットに機能タイルが表示されません。 |
| CPEA / BTPEAのクレジット予算が想定される設計時および実行時の使用量をカバーしていることを確認する | IAはCloud Integrationとは異なるメトリクスでクレジットを消費します。予算化されていないMAG生成により予期せぬ請求が発生します。 |
| IAをホストするIntegration Suiteテナントを決定する(通常はCloud Integrationと同じテナント) | テナント間のアーティファクト転送は運用ステップが増えるため、単一テナント設計の方がシンプルです。 |
| Integration Advisor UserおよびLibrary Administratorロールを指名された個人に割り当てる | 明示的なロール割り当てがない場合、ライセンスがあってもユーザーはMIG/MAGを作成できません。 |
| 本番MAGの前に、オンボーディング用のサンドボックステナントをスケジュールする | 本番テナントでチームが提案エンジンを学習する場を設けるべきではありません。 |
型システムとライブラリの決定

| チェックリスト項目 | 重要性 |
|---|---|
| 対象となるすべてのB2B規格(EDIFACTバージョン、X12リリース、IDocバージョン)を棚卸する | パートナー間で規格を棚卸せずに混在させると、MIGが乱立する原因となる |
| 各規格が、取引先が使用するバージョンでプリロードされたライブラリに存在することを確認する | 不足しているバージョンのインポートは可能だが、プロジェクトが大幅に遅延する |
| 独自仕様/非標準のパートナースキーマの処理方法を決定する(カスタムタイプシステム vs フラットファイルの前処理) | カスタムタイプシステムは、Cloud IntegrationでスキーマをプレーンXMLとして扱うよりも高いコミットメントを要する |
| SAPがタイプシステムのバージョンを廃止した場合のライブラリ更新の責任者を文書化する | ライブラリは一元管理されるが、バージョンのサポート終了によりMIGの再作業が発生する |
MIG 設計
| チェックリスト項目 | 重要性 |
|---|---|
| 取引先のうち、どちらのMIGを正本とするか(自社か相手先か)を特定する | 多くのB2Bトラブルは、2つのMIGに乖離が生じたことが原因。取引先ごとに、方向ごとに1つのMIGが原則 |
| パートナー承認用のMIGエクスポート形式(PDFまたはHTML)を決定する | エクスポートされたMIGは契約仕様書となる。法務・購買部門が受け入れる形式を選択する |
| MIGのバージョン管理方法を計画する:軽微な変更を既存の取引先にどのように反映させるか | バージョン管理のルールがないと、小さなMIG修正が下流のMAGに気付かれずに影響を及ぼす |
| コードリストの値は、自由記述ではなく、権威あるマスタデータから導出されていることを確認する | コードリストの不一致は、構造の不一致よりも多くのパートナーリジェクションを引き起こす |
MAG 設計とカスタム関数

| チェックリスト項目 | 重要性の理由 |
|---|---|
| カスタム関数が必要となるフィールドの割合を見積もる(標準的なメッセージでは通常5~15%) | カスタム関数の工数は、初期スコープ設定で常に過小評価される |
| GroovyまたはJavaScriptスキルを持つ開発者をアサインすることを確認し、ビジネスアナリストのみとしない | 提案の承認はBAでも可能だが、カスタム関数はBAでは対応不可 |
| MAG設計の上流で単位、通貨、日付形式の変換ルールを定義する | MAG設計時に変換ロジックを考案すると、マッピング間で一貫性が失われやすい |
| MLが提案した各マッピングを人間が確認したことを示す明示的な承認ステップを文書化する | 監査証跡では、マッピングが自動適用されなかった証拠が頻繁に要求される |
ランタイムアーティファクトの生成とデプロイ
| チェックリスト項目 | 重要性 |
|---|---|
| 生成されたXSLTを消費するCloud IntegrationパッケージとiFlowを特定する | IAはiFlowを実行しません。ターゲットiFlowがなければ、生成されたアーティファクトは未使用のままです |
| MAGが再生成された際の再デプロイを計画する(既存のiFlowは再デプロイ後にのみ新しいマッピングを取得します) | サイレントな陳腐化は、よくある本番インシデントの原因です |
| Cloud Integrationメッセージシミュレーション用のテストデータセット(実際のパートナーサンプル vs 匿名化データ)を決定する | 設計時にはMAGが正しく見えても、実際のデータ形状でランタイムが失敗することがあります |
| ランタイムマッピングエラーに関するモニタリングダッシュボードの所有者を確認する | 午前3時のマッピングエラーは、Integration Advisorの設計者ではなく、Cloud Integration運用担当者に通知されます |
5) 意思決定基準
最初に問うべき3つの質問

Q1. 現在、測定可能なB2Bマッピングの課題は存在しますか?
顧客が、特定のマッピングが時間がかかりすぎる、PI/POメンテナンスにコストがかかりすぎる、またはパートナー監査に不合格となる、といった具体的な問題を指摘できない場合、Integration Advisorは着手すべきプロジェクトとして適切ではありません。提案エンジンは既知のマッピングを加速するものであり、その必要性を新たに生み出すものではありません。
Q2. データとパートナー関係は当社が所有しますか?
Integration Advisor は、MIG および MAG メタデータを顧客の BTP テナントに保存します。サードパーティの MSP が取引先関係(および仕様を定義する権限)を所有している場合、顧客は行使できない機能を購入していることになります。この場合、Integration Advisor は死蔵品(シェルフウェア)となります。
Q3. デザインタイムとランタイムの両方に予算を持つ社内スポンサーはいますか?
Integration AdvisorはPremium Editionのエンタイトルメントを消費し、ランタイムはCloud Integrationのメッセージ容量を消費します。これらのうち一方のみを資金提供するスポンサーは、プロジェクト途中で壁にぶつかります。B2Bセンター・オブ・エクセレンス(単なる統合アーキテクトではなく)が適切なスポンサーのプロファイルです。
プロジェクトコンテキストによるドメイン選択

| プロジェクトの状況 | 推奨される開始ドメイン/機能 |
|---|---|
| グリーンフィールド S/4HANA Cloud + EDIFACT/X12を使用するB2Bパートナー | タイプシステム + MIG + MAG(フルIAスタック) |
| 既存のPI/PO B2Bアドオンを移行する場合 | PI/POからMIGをエクスポート → IAに再インポート、MAGを再設計 |
| 単一パートナー向けの単発マッピングで、複雑性が低い場合 | IAをスキップ。Cloud Integration iフロー内でXSLTを直接構築 |
| 多数のパートナー、類似したメッセージ形状、同一標準を使用する場合 | IAが効果的 — MIGの再利用が価値の源泉 |
| ライブラリにないニッチな業界標準の場合 | まずサンプルで提案品質を検証。カスタムタイプシステムのコストを考慮 |
| 明確な課題が特定されていない場合 | 停止。Q1に戻る。 |
ライセンスとコスト

| 機能 | ライセンスモデル | 確認すべき重要事項 | |
|---|---|---|---|
| Integration Advisor(設計時) | Integration Suite Premium Editionに含まれる。CPEA / BTPEAによる従量課金制 | 現在の契約にPremium Editionが含まれているか、アップセルが必要か? | |
| Cloud Integration(実行時) | メッセージ量に基づく従量課金制(Integration Suiteのティアごと) | 各方向の月間予想メッセージ数はいくらか? | |
| カスタム関数の開発 | 内部人件費 — SAPライセンスコンポーネントなし | プロジェクト計画にGroovy/JS対応の開発者が指名されているか? | |
| MIG/MAGストレージとライブラリアクセス | 設計時の権利に含まれる | 注文書を確認して確認すること(推測しない) |
6) よくある障害

障害 1: Integration Advisor を Trading Partner Management の代替として扱うこと
最も頻繁に発生するスコーピングエラー。チームはIAを購入し、美しいMAGを設計し、ランタイムアーティファクトを生成します。そして、Go-Live時に、パートナー契約がなく、チャネルルーティングルールがなく、iflowsをコピーペーストせずに2番目のパートナーをオンボーディングする方法がないことを発見します。IAは仕様を所有し、TPMは契約を所有します。要件段階から両方を計画してください。
障害 2: MLが提案したマッピングをレビューせずにすべて受け入れる
提案エンジンは優れていますが、完璧ではありません。一般的でないセグメントの提案を自動承認すると、設計時には正しく見えるマッピングが、ソースフィールドが空の場合やコードリスト値が予期しない場合にランタイムで失敗します。すべての提案には人間による承認が必要です。これは設計上の意図であり、オプションではありません。
障害 3: カスタム関数の工数を過小評価している
主流のEDIFACTメッセージでは、依然として5~15%のフィールドをカスタム関数で処理する必要があります。日付形式の正規化、通貨の丸め処理、条件付きフラグなどです。「提案エンジンが95%を処理する」という範囲設定のプロジェクトでは、残りの5%にはBA(ビジネスアナリスト)のスキルではなく、開発者のスキルが必要であることを見落としがちです。
障害4: コードリストガバナンスの欠如
コードリスト(通貨コード、国コード、取引先分類)は、メッセージ構造よりも速くシステム間で乖離します。コードリストの値をソースからターゲットへ1:1でマッピングするMAGは、どちらかのシステムが新しいコードを追加した時点で機能しなくなります。フィールド間で直接マッピングするのではなく、管理されたマスタデータリストを介してマッピングしてください。
障害 5: MAG 再生成後の再デプロイ忘れ
MAGが変更されるとIAはランタイムアーティファクトを再生成しますが、そのアーティファクトが本番環境で有効になるのは、それを利用するiフローが再デプロイされた後です。サイレントな陳腐化(新しいXSLTがIntegration Suiteパッケージ内にあるにもかかわらず、古いXSLTが本番環境で実行され続ける状態)は、よくあるインシデントパターンです。変更プロセスに再デプロイを明示的に組み込んでください。
障害 6: 独自フォーマットに対してカスタム型システムを早期に選択すること
カスタム型システムは、独自のパートナースキーマを第一級の市民として扱えるため魅力的です。しかし、それを維持できる能力を持つチームはごくわずかであり、長期的なコミットメントが必要です。単発の独自フォーマットについては、Cloud Integration内でフラットなXMLとして扱い、多くのパートナーが使用するフォーマットにのみカスタム型システムを予約してください。
障害7:オンボーディング用のサンドボックステナントがない
提案エンジンを本番テナントで学習するチームは、MIGとMAGをライブ編集することになり、ロールバックができません。サンドボックステナントは贅沢品ではなく、標準的なオンボーディングパターンです。これをスキップすることは、3か月後に「この半分をやり直さなければならない」という事態の最初の原因となります。
FAQ
Q: Integration Advisor はオンプレミスの SAP PI/PO で使用できますか?
いいえ。Integration AdvisorはSAP Integration Suite(クラウド)のみの機能です。PI/POには、別のツールを備えた独自のB2Bアドオンがあります。PI/PO B2BアドオンからIntegration Advisorへの移行は可能ですが、リフト&シフトではなく再設計として扱われます。
Q: Integration Advisor のライセンスはどのようになっていますか?
SAP Integration Suite Premium Editionに含まれており、CPEAまたはBTPEAクレジットを通じて消費量が測定されます。Standard EditionおよびFree Tierには含まれません。価格帯は歴史的に変更されているため、利用可能性を前提とする前に、現在の注文書に基づいて権利を確認してください。
Q: プロジェクトからIntegration Advisorを除外すべきタイミングはいつですか?
3つのシグナル:(1) 対象パートナーが1社または2社のみで、追加の見込みがない、(2) すべてのマッピングが単一の標準メッセージを使用しており、Cloud Integration内でXSLTを使って1~2日で手動作成できる、(3) プレミアムエディションが契約に含まれておらず、アップグレード購入が承認されていない。これらのいずれかのケースでは、通常のCloud Integrationマッピングの方が迅速かつ低コストです。
Q: 要件はどのように文書化すべきですか?
要件は「Integration Advisorを使用する」レベルではなく、MIGおよびMAGのレベルで記述してください。具体的には、どのタイプシステムとバージョンか、どのメッセージタイプか、どの取引先か、どのフィールドにカスタム関数が必要か、各ML提案マッピングの受入証拠がどのようなものかを明示してください。「IAでEDIFACT ORDERSを実装する」とだけ書かれた要件は、見積もりにはあまりにも曖昧です。
Q: Integration Advisor、Cloud Integration、Trading Partner Managementの関係は何ですか?
IAは仕様書(MIG、MAG、生成されたXSLT)を作成します。Cloud Integrationは、生成されたXSLTを消費するiフローを実行します。TPMはパートナー契約を定義します。つまり、パートナーが誰か、どのチャネルが使用されるか、どのiフローが呼び出されるかを定義します。これら3つはすべて必要であり、それぞれが異なる関心事を担当します。
Q: Integration Advisorは、EDI以外の統合シナリオ(例:REST API)でも機能しますか?
原則的には可能です。A2Aマッピング(アプリケーション間)は、IDocやプロプライエタリXMLを含めてサポートされています。実際には、クラウドライブラリが成熟しているB2B EDIシナリオから主流の価値がもたらされます。REST API統合の場合は、通常、API Managementと直接のCloud Integrationマッピングの方が適しています。
Q: 本番環境で生成されたランタイム成果物の所有者は誰ですか?
Cloud Integration チーム。XSLT がランタイム iFlow にデプロイされると、すべての監視、エラーハンドリング、インシデント対応は Cloud Integration の責任となります。IA 側の設計者はランタイムの問題で呼び出されることはありません。
概要

Integration Advisorは現実的な課題を解決します。従来、B2Bマッピングプロジェクトでは、同じEDIFACTメッセージ構造がプロジェクトごとに顧客ごとに再構築されていたため、完了までに数か月を要していました。クラウドソースのライブラリとML提案エンジンにより、この作業が圧縮され、主流のメッセージでは劇的に短縮されます。正直なスコープ設定の問いは「IAにこれができるか」ではなく、「IAが提案できない部分を完了できるスポンサー、パートナー、開発者がいるか」です。完全なB2Bカバレッジを実現するにはTrading Partner Managementと組み合わせ、パートナー数やメッセージの多様性がPremium Editionを正当化しない場合はスコープから除外します。
次に読むべきもの
| ID | トピック |
|---|---|
| BTP-A01: SAP Integration Suite 概要 | コンポーネントマップと各要素の連携方法 |
| BTP-A02: Cloud Integration (CPI): アーキテクチャと用途 | XSLT IAが生成するiPaaS |
| BTP-A03: API Management: アーキテクチャと用途 | Cloud Integrationの上位層としてのAPIライフサイクル管理 |
| BTP-A04: Event Mesh: アーキテクチャと用途 | ポイントツーポイント統合を補完するイベント駆動型 |
| BTP-A05: Open Connectors: アーキテクチャと用途 | B2B以外の統合向けSaaSコネクタライブラリ |
| BTP-A06: B2B統合 (1): 取引先管理 | IAと連携するランタイムパートナー契約レイヤー |
| BTP-A07: B2B統合 (2): Integration Advisor(本記事) | クラウドソース標準を活用した設計時マッピング |
| BTP-A08: Integration Suite: ユースケースと判断パターン | 各Integration Suite機能の選択基準 |