sap-btp-master-data-integration

SAP BTP Master Data Integration

関連するスキル

• sap-btp-cloud-platform：サブアカウント、エンタイトルメント、サービスインスタンスの設定に使用します
• sap-btp-connectivity：接続システムに関する宛先と認証の設定に使用します
• sap-btp-integration-suite：MDI アダプターおよび幅広い統合オーケストレーションのシナリオに使用します
• sap-api-style：MDI SOAP/API コントラクトおよび統合の動作を文書化する際に使用します

このスキルを使用する場面

MDI テナントの設定、SAP アプリケーションの接続、配信モデルの設定、MDI サービスプランの選択、ビジネスパートナー SOAP API の統合、One Domain Model のバージョンの処理、またはマスターデータレプリケーションのトラブルシューティングを行う場合に、このスキルを使用します。

目次

• クイックリファレンス
• 主要な概念
• 判断ツリー
• セットアップのワークフロー
• システムの制限事項
• クライアント設定
• SOAP エンドポイント
• 一般的な統合シナリオ
• セキュリティのベストプラクティス
• トラブルシューティング
• 同梱リソース

SAP Master Data Integration（MDI）は、SAP BTP 上の中央マスターデータハブです。アプリケーションがローカルのマスターデータデータベースを中央リポジトリと同期できるようにします。

クイックリファレンス

MDI が行うこと

• 接続されたアプリケーション間でマスターデータをレプリケートします
• SAP One Domain Model を介して34種類のマスターデータタイプをサポートします
• データ配信範囲を制御するフィルタリングを提供します
• カスタムフィールドによる拡張を可能にします

MDI が行わないこと

• 統合（SAP Master Data Governance を使用してください）
• データ品質管理
• 中央ガバナンスのワークフロー
• 参照整合性の検証

主要な概念

主な用語

用語	定義
テナント	各サブアカウントに設けられる、独自のデータベースと設定を持つ分離された MDI 環境
クライアント	MDI と統合するアプリケーション（データの生成元または消費先）
生成元クライアント	MDI に変更リクエストを送信するクライアント（上流／書き込みクライアント）
消費先クライアント	MDI から変更イベントを受信するクライアント（下流／読み取りクライアント）
配信モデル	どのデータをどこにレプリケートするかを制御する設定
変更トークン	各変更リクエストに付与される一意の識別子（最大36文字）

統合モデル（SAP One Domain Model）

ビジネスパートナー - v2.1.1、v3.3.0（住所データのマルチバージョンサポートには制限があります） 財務 - コストセンター v3.1.0、為替レート v4.0.0、銀行 v3.0.0 ワークフォース - 担当者 v5.0.0、職務分類 v4.0.0、組織単位 v4.0.0 調達 - 購買組織 v4.0.0、購買グループ v6.0.0 資産 - 設備 v5.1.0、機能場所 v5.0.0 製品 - 製品 v5.0.0、製品グループ v5.0.0

完全な一覧については、references/integration-models.md を参照してください。

判断ツリー

どのサービスプランを選ぶか？

Is application SAP-branded cloud?
├─ Yes → sap-integration plan (FREE)
└─ No → Is it SAP S/4HANA On-Premise?
         ├─ Yes → s4hana-onpremise plan (PAID - storage + bandwidth)
         └─ No → Use SAP Integration Suite with MDI Adapter

どの認証方法を選ぶか？

Mutual-TLS with X.509 certificates available?
├─ Yes → Use mTLS (RECOMMENDED)
│        credential-type: x509
│        Configure validity: DAYS/MONTHS/YEARS
└─ No → Use Client Credentials Grant (DEFAULT)
         Uses client_id/client_secret pairs

REST API と SOAP API のどちらを使うか？

Master data type is Business Partner?
├─ Yes → SOAP API available for:
│        - Business Partner replication
│        - BP Relationship replication
│        - Key Mapping replication
│        - Confirmations
└─ No → REST API (Events API, Requests API, KeyMapping API)

セットアップのワークフロー

1. 前提条件

• SAP BTP のグローバルエンタープライズアカウント（トライアル／無料プランは不可）
• サポート対象リージョン（EU10、US10、AP10、AP11）のサブアカウント
• サブアカウント内の Cloud Foundry スペース
• BusinessConfigurationAdmin ロールを持つユーザー

2. テナントの作成

1. Create subaccount in available region
2. Subscribe to SAP Master Data Integration Tenant application
3. One tenant maximum per subaccount
4. Separate tenants for dev/test/prod recommended

3. アプリケーションの接続

1. Create service instance (one per application - MANDATORY)
2. Choose service plan (sap-integration or s4hana-onpremise)
3. Set 'application' attribute (e.g., "s4" for S/4HANA Cloud)
4. Create service binding for credentials
5. Configure writePermissions for entity types

4. 配信モデルの設定

1. Access Business Data Orchestration UI
2. Create distribution model (provider → consumer)
3. Set filters (object selection + data scope)
4. Activate model

システムの制限事項

上限	値
変更リクエストのサイズ	256 KB（ビジネスパートナーの場合は512 KB）
マスターデータレコードのサイズ	512 KB
変更トークンの長さ	最大36文字
差分トークンの有効期間	28日
SOAP ペイロードのサイズ	10 MB
変更トークンに使用できる文字	a-z、A-Z、0-9、-、_

クライアント設定属性

businessSystemId

• SOAP API 統合で必須です
• 最大60文字で、テナント内で一意である必要があります
• SOAP メッセージ内の SenderBusinessSystemID と一致する必要があります

writePermissions

"writePermissions": [
  { "entityType": "sap.odm.finance.costobject.CostCenter" },
  { "entityType": "sap.odm.businesspartner.BusinessPartner" }
]

globalTenantId

• Events API における最後の重要な書き込み元を識別します
• 1～40 文字：英数字、-、.、_、~
• アプリケーションのドキュメントで必要とされている場合にのみ設定してください

logSys

• 最後の重要な書き込み元の論理システムです
• 最大 10 文字
• アプリケーションのドキュメントで必要とされている場合にのみ設定してください

SOAP エンドポイント

ベース URL：https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/

目的	エンドポイント
BP 受信	BusinessPartnerBulkReplicateRequestIn
BP 確認	BusinessPartnerBulkReplicateRequestConfIn
BP 関係受信	BusinessPartnerRelationshipBulkReplicateRequestIn
BP 関係確認	BusinessPartnerRelationshipBulkReplicateRequestConfirmIn
キーマッピング受信	KeyMappingBulkReplicateRequestIn
キーマッピング確認	KeyMappingBulkReplicateRequestConfirmIn

認証：Basic（tenantId パラメーターを指定した clientid:clientsecret）または OAuth

宛先の命名規則（SOAP）

ビジネスシステム ID が SYSTEMID の場合：

• SYSTEMID_BPOUTBOUND - ビジネスパートナーのレプリケーション
• SYSTEMID_BPCONFIRM - ビジネスパートナーの確認
• SYSTEMID_BPRELOUTBOUND - 関係のレプリケーション
• SYSTEMID_BPRELCONFIRM - 関係の確認
• SYSTEMID_KMOUTBOUND - キーマッピングのレプリケーション
• SYSTEMID_KEYMAPCONFIRM - キーマッピングの確認

一般的な統合シナリオ

SAP S/4HANA Cloud

• ビジネスパートナー、コストセンター、製品など、20 のオブジェクトをサポートしています
• 通信アレンジメント：SAP_COM_0659（MDI）、SAP_COM_0594（BDO）
• 1 つのシステムを複数の MDI テナントに接続することはできません

SAP S/4HANA On-Premise

• 14 のオブジェクトをサポートしています
• 設定には drfimg トランザクションを使用します
• 送信実装：サービス経由の BP/REL 用に 986_3
• SAP Note 3065614 が必要です

SAP SuccessFactors

• Employee Central：銀行、会社コード、コストセンター、ワークフォース
• Employee Central Payroll：コストセンター、公共部門管理

SAP Ariba

• ビジネスパートナー（サプライヤー）、会社コード、コストセンターなど、9 つのカテゴリーがあります

詳細な統合ガイドについては、references/integration-guides.md を参照してください。

セキュリティのベストプラクティス

1. 常に HTTPS を使用する - MDI と XSUAA のすべての通信に使用します
2. 証明書を検証する - 証明書の検証を無効にしないでください
3. 侵害された認証情報をローテーションする - サービスキーを削除して、新しいキーを作成します
4. 権限を最小限にする - 必要な writePermissions のみを付与します
5. サブアカウントを分離する - MDI を関連性のない BTP サービスから隔離します

トラブルシューティング

差分トークンの期限切れ（28 日）

28 日以内に同期できない場合、クライアントは初期ロードを実行する必要があります。

変更リクエストの拒否（サイズ）

ペイロードサイズを 256 KB 未満（ビジネスパートナーの場合は 512 KB 未満）に減らしてください。

必須パートナー機能の不足

C4C → S/4HANA のシナリオでは、MDI でパートナー決定ロジックを設定してください。 テンプレートは SAP Note 2987243 で入手できます。

プラットフォームのステータス

SAP Trust Center を確認してください：https://www.sap.com/about/cloud-trust-center/

サポートコンポーネント

BC-CP-CF-ONEMDS

バンドルリソース

コアドキュメント

1. references/setup-guide-complete.md（12.2K 行）- 前提条件、テナント管理、クライアント設定、バージョン履歴を含む完全なセットアップガイド
2. references/glossary-and-pricing.md（7.3K 行）- 詳細な用語集、料金プラン、対象アプリケーション、メンテナンス時間
3. references/features-complete.md（11.6K 行）- REST/SOAP イベント、Local ID API、データプライバシーを含む、MDI の全機能

統合リソース

4. references/integration-models.md（3.4K 行）- サポート対象のすべてのマスターデータに関する完全な ODM タイプとバージョン
5. references/integration-guides.md（6.8K 行）- S/4HANA、SuccessFactors、Ariba などのシステム別セットアップガイド
6. references/soap-api-reference.md（17.7K 行）- フィールドマッピングを含む SOAP Web サービスの完全なリファレンス

高度なトピック

7. references/security-and-privacy.md（7.7K 行）- セキュリティガイドライン、データ保護、フィルタリング設定
8. references/extensibility.md（4.5K 行）- カスタム拡張、フィールド定義、WSDL 生成
9. references/monitoring.md（7.3K 行）- Business Data Orchestration の監視とトラブルシューティング

ドキュメントの参照先

主なドキュメント：https://help.sap.com/docs/master-data-integration GitHub ソース：https://github.com/SAP-docs/sap-btp-master-data-integration API カタログ：https://api.sap.com（フィルター：SAP Master Data Integration） SAP Discovery Center：https://discovery-center.cloud.sap/serviceCatalog/master-data-integration