JinJin48
JinJin48
SAP Consultant | BTP · S/4HANA · US Global Rollout
· 18 min read

カバー: SAP Integration Advisor — B2B統合のための設計時マッピング

TL;DR
  • 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-A02iPaaSCloud Integration (CPI)アーキテクチャと使用方法
BTP-A03APIライフサイクルAPI Managementアーキテクチャと使用方法
BTP-A04イベント処理Event Meshアーキテクチャと使用方法
BTP-A05コネクタOpen Connectorsアーキテクチャと使用方法
BTP-A06B2BTrading Partner Managementアーキテクチャと使用方法
BTP-A07B2BIntegration 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層の機能:タイプシステム、MIG、MAG、カスタム関数、ランタイムアーティファクト生成

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)と実行時(Cloud Integration)の分割。右側に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) 成熟度マップ

IA機能の成熟度評価:タイプシステムとランタイム生成は本番対応、MAGとカスタム関数は前提条件付きで対応可能、PI/PO移行はアーリーアダプター段階

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

正直な話:提案エンジンは目に見える機能ですが、プロジェクトにおける実質的な制約は、表向きのMLではなく、ほとんどの場合カスタム関数とエッジケースのカスタム型システムです。

4) 要件チェックリスト

テナントとライセンスの前提条件

Integration Advisorを開始する前のテナントおよびライセンスの前提条件に関する5項目のチェックリスト

チェックリスト項目重要性
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の前に、オンボーディング用のサンドボックステナントをスケジュールする本番テナントでチームが提案エンジンを学習する場を設けるべきではありません。

型システムとライブラリの決定

型システムの決定木:標準ライブラリ版 vs カスタム型システム vs フラットファイル前処理

チェックリスト項目重要性
対象となるすべての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%を占め、開発者のスキルを必要とします

チェックリスト項目重要性の理由
カスタム関数が必要となるフィールドの割合を見積もる(標準的なメッセージでは通常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つの質問

Integration Advisorを導入する前に確認すべき3つの質問:課題、データとパートナーの所有権、社内スポンサー

Q1. 現在、測定可能なB2Bマッピングの課題は存在しますか?

顧客が、特定のマッピングが時間がかかりすぎる、PI/POメンテナンスにコストがかかりすぎる、またはパートナー監査に不合格となる、といった具体的な問題を指摘できない場合、Integration Advisorは着手すべきプロジェクトとして適切ではありません。提案エンジンは既知のマッピングを加速するものであり、その必要性を新たに生み出すものではありません。

Q2. データとパートナー関係は当社が所有しますか?

Integration Advisor は、MIG および MAG メタデータを顧客の BTP テナントに保存します。サードパーティの MSP が取引先関係(および仕様を定義する権限)を所有している場合、顧客は行使できない機能を購入していることになります。この場合、Integration Advisor は死蔵品(シェルフウェア)となります。

Q3. デザインタイムとランタイムの両方に予算を持つ社内スポンサーはいますか?

Integration AdvisorはPremium Editionのエンタイトルメントを消費し、ランタイムはCloud Integrationのメッセージ容量を消費します。これらのうち一方のみを資金提供するスポンサーは、プロジェクト途中で壁にぶつかります。B2Bセンター・オブ・エクセレンス(単なる統合アーキテクトではなく)が適切なスポンサーのプロファイルです。

プロジェクトコンテキストによるドメイン選択

プロジェクトコンテキストから推奨IA機能へ:グリーンフィールド、移行、単発、マルチパートナー、ニッチ、ペインポイントなし

プロジェクトの状況推奨される開始ドメイン/機能
グリーンフィールド 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に戻る。

ライセンスとコスト

3つのコスト層:Integration Advisorの設計時、Cloud Integrationのランタイム、カスタム関数の開発工数

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

6) よくある障害

Integration Advisorプロジェクトの要件段階における7つの一般的な失敗パターン

障害 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 側の設計者はランタイムの問題で呼び出されることはありません。

概要

完全なB2B統合の三本柱:仕様のためのIntegration Advisor、契約のためのTrading Partner Management、ランタイムのためのCloud Integration

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機能の選択基準