Back to Details

sap-btp-master-data-integration

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SAP BTP Master Data Integration

SAP BTP Master Data Integration（主数据集成）

Table of Contents

目录

SAP Master Data Integration (MDI) is a central master data hub on SAP BTP that enables applications to synchronize local master data databases with a centralized repository.
SAP Master Data Integration（MDI）是SAP BTP上的中央主数据枢纽，可让各应用系统将本地主数据数据库与中央存储库进行同步。

Quick Reference

快速参考

What MDI Does

MDI的功能

  • Replicates master data between connected applications
  • Supports 34 master data types via SAP One Domain Model
  • Provides filtering to control data distribution scope
  • Enables extensibility with custom fields
  • 在对接的应用系统之间复制主数据
  • 通过SAP One Domain Model支持34种主数据类型
  • 提供过滤功能以控制数据分发范围
  • 支持通过自定义字段实现功能扩展

What MDI Does NOT Do

MDI不具备的功能

  • Consolidation (use SAP Master Data Governance)
  • Data quality control
  • Central governance workflows
  • Referential integrity validation
  • 数据合并（需使用SAP Master Data Governance）
  • 数据质量管控
  • 中央治理工作流
  • 参照完整性验证

Core Concepts

核心概念

Key Terms

关键术语

TermDefinition
TenantIsolated MDI environment per subaccount with own database and configs
ClientApplication that integrates with MDI (producing or consuming)
Producing ClientSends change requests to MDI (upstream/writing client)
Consuming ClientReceives change events from MDI (downstream/reading client)
Distribution ModelConfiguration controlling which data replicates where
Change TokenUnique identifier per change request (max 36 chars)
术语定义
Tenant每个子账户对应的独立MDI环境，拥有专属数据库和配置
Client与MDI集成的应用系统（可作为数据生产者或消费者）
Producing Client向MDI发送变更请求的上游/写入端应用
Consuming Client从MDI接收变更事件的下游/读取端应用
Distribution Model控制数据复制目标的配置规则
Change Token每个变更请求对应的唯一标识符（最大36字符）

Integration Models (SAP One Domain Model)

集成模型（SAP One Domain Model）

Business Partner - v2.1.1, v3.3.0 (multiversion support restricted for address data) Finance - Cost Center v3.1.0, Exchange Rate v4.0.0, Bank v3.0.0 Workforce - Person v5.0.0, Job Classification v4.0.0, Organizational Unit v4.0.0 Procurement - Purchasing Organization v4.0.0, Purchasing Group v6.0.0 Assets - Equipment v5.1.0, Functional Location v5.0.0 Products - Product v5.0.0, Product Group v5.0.0
For complete list see 
references/integration-models.md
业务伙伴 - 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

Decision Trees

决策树

Which Service Plan?

如何选择服务方案？

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
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

Which Authentication Method?

如何选择认证方式？

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
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 vs SOAP API?

REST与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)
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)

Setup Workflow

搭建流程

1. Prerequisites

1. 前置条件

  • SAP BTP global enterprise account (no trial/free tier)
  • Subaccount in supported region: EU10, US10, AP10, AP11
  • Cloud Foundry space within subaccount
  • User with BusinessConfigurationAdmin role
  • SAP BTP全球企业账户（不支持试用/免费层级）
  • 子账户位于支持的区域：EU10、US10、AP10、AP11
  • 子账户内已创建Cloud Foundry空间
  • 用户拥有BusinessConfigurationAdmin角色

2. Create Tenant

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
1. 在可用区域创建子账户
2. 订阅SAP Master Data Integration Tenant应用
3. 每个子账户最多可创建1个租户
4. 建议为开发/测试/生产环境分别创建独立租户

3. Connect Application

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
1. 创建服务实例（每个应用系统必须创建1个）
2. 选择服务方案（sap-integration或s4hana-onpremise）
3. 设置'application'属性（例如，S/4HANA Cloud对应"s4"）
4. 创建服务绑定以获取凭证
5. 配置实体类型的writePermissions权限

4. Configure Distribution Model

4. 配置分发模型

1. Access Business Data Orchestration UI
2. Create distribution model (provider → consumer)
3. Set filters (object selection + data scope)
4. Activate model
1. 访问Business Data Orchestration UI
2. 创建分发模型（提供者→消费者）
3. 设置过滤规则（对象选择+数据范围）
4. 激活模型

System Limitations

系统限制

LimitValue
Change Request Size256 KB (512 KB for Business Partner)
Master Data Record Size512 KB
Change Token Length36 characters max
Delta Token Validity28 days
SOAP Payload Size10 MB
Change Token Charactersa-z, A-Z, 0-9, -, _
限制项数值
变更请求大小256 KB（业务伙伴为512 KB）
主数据记录大小512 KB
Change Token长度最大36字符
Delta Token有效期28天
SOAP负载大小10 MB
Change Token允许字符a-z、A-Z、0-9、-、_

Client Configuration Attributes

客户端配置属性

businessSystemId

businessSystemId

  • Required for SOAP API integration
  • Max 60 characters, unique per tenant
  • Must match SenderBusinessSystemID in SOAP messages
  • SOAP API集成必填
  • 最大60字符，每个租户内唯一
  • 必须与SOAP消息中的SenderBusinessSystemID匹配

writePermissions

writePermissions

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

globalTenantId

globalTenantId

  • Identifies last significant writer on Events API
  • 1-40 characters: alphanumeric, -, ., _, ~
  • Configure only if application documentation requires it
  • 标识Events API的最后写入方
  • 1-40字符：支持字母数字、-、.、_、~
  • 仅当应用系统文档要求时才需配置

logSys

logSys

  • Logical system of last significant writer
  • Max 10 characters
  • Configure only if application documentation requires it
  • 最后写入方的逻辑系统标识
  • 最大10字符
  • 仅当应用系统文档要求时才需配置

SOAP Endpoints

SOAP端点

Base URL: 
[https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/
](https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/`)
PurposeEndpoint
BP InboundBusinessPartnerBulkReplicateRequestIn
BP ConfirmationBusinessPartnerBulkReplicateRequestConfIn
BP Relationship InboundBusinessPartnerRelationshipBulkReplicateRequestIn
BP Relationship ConfirmationBusinessPartnerRelationshipBulkReplicateRequestConfirmIn
Key Mapping InboundKeyMappingBulkReplicateRequestIn
Key Mapping ConfirmationKeyMappingBulkReplicateRequestConfirmIn
Authentication: Basic (clientid:clientsecret with tenantId param) or OAuth
基础URL：
[https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/
](https://one-mds.cfapps.{region}.hana.ondemand.com/businesspartner/v0/soap/`)
用途端点
业务伙伴入站BusinessPartnerBulkReplicateRequestIn
业务伙伴确认BusinessPartnerBulkReplicateRequestConfIn
业务伙伴关系入站BusinessPartnerRelationshipBulkReplicateRequestIn
业务伙伴关系确认BusinessPartnerRelationshipBulkReplicateRequestConfirmIn
键映射入站KeyMappingBulkReplicateRequestIn
键映射确认KeyMappingBulkReplicateRequestConfirmIn
认证方式：Basic认证（携带tenantId参数的clientid:clientsecret）或OAuth

Destination Naming Convention (SOAP)

SOAP目标命名规范

For business system ID 
SYSTEMID
:
  • SYSTEMID_BPOUTBOUND
    - Business Partner replication
  • SYSTEMID_BPCONFIRM
    - Business Partner confirmation
  • SYSTEMID_BPRELOUTBOUND
    - Relationship replication
  • SYSTEMID_BPRELCONFIRM
    - Relationship confirmation
  • SYSTEMID_KMOUTBOUND
    - Key Mapping replication
  • SYSTEMID_KEYMAPCONFIRM
    - Key Mapping confirmation
对于业务系统ID 
SYSTEMID
：
  • SYSTEMID_BPOUTBOUND
    - 业务伙伴复制
  • SYSTEMID_BPCONFIRM
    - 业务伙伴确认
  • SYSTEMID_BPRELOUTBOUND
    - 关系复制
  • SYSTEMID_BPRELCONFIRM
    - 关系确认
  • SYSTEMID_KMOUTBOUND
    - 键映射复制
  • SYSTEMID_KEYMAPCONFIRM
    - 键映射确认

Common Integration Scenarios

常见集成场景

SAP S/4HANA Cloud

SAP S/4HANA Cloud

  • 20 supported objects including Business Partner, Cost Center, Product
  • Communication Arrangement: SAP_COM_0659 (MDI), SAP_COM_0594 (BDO)
  • Single system cannot connect to multiple MDI tenants
  • 支持20种对象，包括业务伙伴、成本中心、产品
  • 通信安排：SAP_COM_0659（MDI）、SAP_COM_0594（BDO）
  • 单个系统无法对接多个MDI租户

SAP S/4HANA On-Premise

SAP S/4HANA On-Premise

  • 14 supported objects
  • Uses drfimg transaction for configuration
  • Outbound implementation: 986_3 for BP/REL via Services
  • Requires SAP Note 3065614
  • 支持14种对象
  • 使用drfimg事务码进行配置
  • 出站实现：通过服务对接业务伙伴/关系的986_3
  • 需要应用SAP Note 3065614

SAP SuccessFactors

SAP SuccessFactors

  • Employee Central: Bank, Company Code, Cost Center, Workforce
  • Employee Central Payroll: Cost Center, Public Sector Management
  • 员工中心：银行、公司代码、成本中心、人力数据
  • 员工中心薪资：成本中心、公共部门管理

SAP Ariba

SAP Ariba

  • 9 categories: Business Partner-Supplier, Company Code, Cost Center, etc.
For detailed integration guides see 
references/integration-guides.md
  • 9类对象：业务伙伴-供应商、公司代码、成本中心等
详细集成指南请查看 
references/integration-guides.md

Security Best Practices

安全最佳实践

  1. Always use HTTPS - All MDI and XSUAA communications
  2. Validate certificates - Never disable certificate validation
  3. Rotate compromised credentials - Delete service key, create new one
  4. Minimal permissions - Grant only necessary writePermissions
  5. Separate subaccounts - Isolate MDI from unrelated BTP services
  1. 始终使用HTTPS - 所有MDI与XSUAA通信均需使用HTTPS
  2. 验证证书 - 绝不能禁用证书验证
  3. 轮换泄露的凭证 - 删除服务密钥并创建新密钥
  4. 最小权限原则 - 仅授予必要的writePermissions权限
  5. 隔离子账户 - 将MDI与无关的BTP服务隔离开

Troubleshooting

问题排查

Delta Token Expired (28 days)

Delta Token过期（28天）

Clients must perform initial load if unable to sync within 28 days.
如果客户端无法在28天内完成同步，必须执行初始数据加载。

Change Request Rejected (Size)

变更请求因大小被拒绝

Reduce payload size below 256 KB (512 KB for Business Partner).
将负载大小降低至256 KB以下（业务伙伴为512 KB以下）。

Missing Mandatory Partner Function

缺少必填伙伴功能

Configure partner determination logic in MDI for C4C → S/4HANA scenarios. Template available in SAP Note 2987243.
在MDI中为C4C→S/4HANA场景配置伙伴确定逻辑。 模板可在SAP Note 2987243中获取。

Platform Status

平台状态

Check SAP Trust Center: https://www.sap.com/about/cloud-trust-center/
查看SAP信任中心：https://www.sap.com/about/cloud-trust-center/

Support Component

支持组件

BC-CP-CF-ONEMDS
BC-CP-CF-ONEMDS

Bundled Resources

配套资源

Core Documentation

核心文档

  1. references/setup-guide-complete.md
    (12.2K lines) - Complete setup guide with prerequisites, tenant management, client configuration, and version history
  2. references/glossary-and-pricing.md
    (7.3K lines) - Comprehensive glossary, pricing tiers, qualifying applications, and maintenance windows
  3. references/features-complete.md
    (11.6K lines) - All MDI features including REST/SOAP events, Local ID APIs, and data privacy
  1. references/setup-guide-complete.md
    （12.2K行）- 包含前置条件、租户管理、客户端配置和版本历史的完整搭建指南
  2. references/glossary-and-pricing.md
    （7.3K行）- 综合术语表、定价层级、合格应用系统和维护窗口说明
  3. references/features-complete.md
    （11.6K行）- MDI所有功能介绍，包括REST/SOAP事件、本地ID API和数据隐私

Integration Resources

集成资源

  1. references/integration-models.md
    (3.4K lines) - Complete ODM types and versions for all supported master data
  2. references/integration-guides.md
    (6.8K lines) - System-specific setup guides for S/4HANA, SuccessFactors, Ariba, and more
  3. references/soap-api-reference.md
    (17.7K lines) - Complete SOAP web services reference with field mappings
  1. references/integration-models.md
    （3.4K行）- 所有支持的主数据类型对应的完整ODM类型及版本
  2. references/integration-guides.md
    （6.8K行）- S/4HANA、SuccessFactors、Ariba等系统的专属搭建指南
  3. references/soap-api-reference.md
    （17.7K行）- 包含字段映射的完整SOAP Web服务参考

Advanced Topics

进阶主题

  1. references/security-and-privacy.md
    (7.7K lines) - Security guidelines, data protection, and filtering configurations
  2. references/extensibility.md
    (4.5K lines) - Custom extensions, field definitions, and WSDL generation
  3. references/monitoring.md
    (7.3K lines) - Business Data Orchestration monitoring and troubleshooting
  1. references/security-and-privacy.md
    （7.7K行）- 安全指南、数据保护和过滤配置
  2. references/extensibility.md
    （4.5K行）- 自定义扩展、字段定义和WSDL生成
  3. references/monitoring.md
    （7.3K行）- Business Data Orchestration监控与问题排查

Documentation Sources

文档来源

Primary Documentation: https://help.sap.com/docs/master-data-integration GitHub Source: https://github.com/SAP-docs/sap-btp-master-data-integration API Catalog: https://api.sap.com (filter: SAP Master Data Integration) SAP Discovery Center: https://discovery-center.cloud.sap/serviceCatalog/master-data-integration
主文档：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发现中心：https://discovery-center.cloud.sap/serviceCatalog/master-data-integration