sap-btp-master-data-integration

SAP BTP 主数据集成

相关技能

• sap-btp-cloud-platform：用于子账户、权利和服务实例设置
• sap-btp-connectivity：用于配置已连接系统的目标和身份验证
• sap-btp-integration-suite：用于 MDI Adapter 和更广泛的集成编排场景
• 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 还是 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（clientid:clientsecret，带 tenantId 参数）或 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）
• 单个系统无法连接到多个 MDI 租户

SAP S/4HANA On-Premise

• 支持 14 种对象
• 使用 drfimg 事务进行配置
• 出站实现：通过 Services 的 986_3，用于 BP/REL
• 需要 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 服务隔离

故障排除

Delta 令牌已过期（28 天）

如果客户端无法在 28 天内同步，必须执行初始加载。

更改请求被拒绝（大小）

将有效负载大小缩减至 256 KB 以下（业务伙伴为 512 KB）。

缺少必需的伙伴功能

在 MDI 中为 C4C → S/4HANA 场景配置伙伴确定逻辑。 模板见 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 行）- MDI 的所有功能，包括 REST/SOAP 事件、本地 ID API 和数据隐私

集成资源

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 行）- 业务数据编排监控与故障排查

文档来源

主要文档：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