sap-btp-integration-suite

SAP BTP 集成套件开发

相关技能

• sap-btp-cloud-platform：用于 BTP 子账户、订阅、权利和角色设置
• sap-btp-connectivity：用于目标、Cloud Connector 和混合连接依赖项
• sap-api-style：用于 API 代理文档、OpenAPI 质量和 API 生命周期标准
• sap-btp-cloud-transport-management：用于在不同环境间传输集成构件

何时使用此技能

在构建或排查 Cloud Integration iFlow、API Management 代理、Event Mesh 主题/队列、Edge Integration Cell 部署、Integration Advisor 映射、Trading Partner Management 流，或评估从 Process Orchestration 迁移时，请使用此技能。

目录

• 快速参考
• 功能概览
• Cloud Integration 开发
• API Management 开发
• Event Mesh
• Edge Integration Cell
• Integration Advisor
• Trading Partner Management
• 迁移评估
• 捆绑资源

快速参考

功能	用途	关键构件
Cloud Integration	A2A/B2B/B2G 集成	集成流（iFlow）
API Management	API 生命周期与治理	API 代理
Event Mesh	事件驱动架构	主题与队列
Edge Integration Cell	混合部署	Kubernetes 运行时
Integration Advisor	B2B 映射自动化	MIG/MAG
Trading Partner Management	合作伙伴入驻	协议
Graph	统一数据 API	业务数据图
集成评估	技术选型	ISA-M
迁移评估	PO 迁移规划	提取与分析

---

功能概览

Cloud Integration

构建并运行跨云端、本地和混合环境的集成流，以支持 A2A、B2B 和 B2G 场景。支持 80 多种适配器和实时消息处理。

核心组件：

• 集成流（iFlow）——可视化消息处理流水线
• 适配器——协议/应用连接器（SFTP、HTTP、OData、RFC、AMQP、Kafka 等）
• 消息映射——图形化/XSLT/Groovy 转换
• 数据存储与变量——用于有状态处理的持久化
• 安全材料——密钥库、凭据、PGP 密钥

API Management

提供完整的 API 生命周期管理，包括安全、流量控制和开发者互动。

核心组件：

• API 代理——后端服务的门面层
• 策略（34 种类型）——安全、流量和中介规则
• 开发者中心——面向开发者的 API 门户
• 产品——带有访问控制的 API 套件
• 分析——使用指标和洞察

Event Mesh

在企业生态系统中发布和使用业务事件，以支持事件驱动架构。

Edge Integration Cell

混合运行时，可在云端设计的同时，在私有环境中处理数据。部署于 Kubernetes（EKS、AKS、GKE、OpenShift、RKE2）。

Integration Advisor

由 AI 驱动的 B2B 内容开发，支持 UN/EDIFACT、SAP IDoc、ASC X12。创建消息实施指南（MIG）和映射指南（MAG）。

Trading Partner Management

借助合作伙伴配置文件、协议模板和自动化运行时构件生成，简化 B2B 关系管理。支持 AS2、SFTP、FTP 协议。

---

Cloud Integration 开发

可导入的 iFlow 生成

当用户要求生成 iFlow 包、ZIP、可导入归档、.iflw 或完整的 Cloud Integration 工件时，请先查阅 references/iflow-package-authoring.md，再编写文件。不要自行构造仅包含 XML 的扁平包。

对于 HTTPS 到 SFTP 的场景，请从 templates/https-to-sftp-iflow-package/ 开始，并保留其目录结构：

.project
META-INF/MANIFEST.MF
metainfo.prop
src/main/resources/parameters.prop
src/main/resources/parameters.propdef
src/main/resources/scenarioflows/integrationflow/HTTPS_to_SFTP_Template.iflw

除非用户要求采用不同的设计，否则只自定义外部化占位符：

• {{HTTPS_ENDPOINT_PATH}}
• {{SFTP_HOST}}
• {{SFTP_PORT}}
• {{SFTP_DIRECTORY}}
• {{SFTP_FILENAME}}
• {{SFTP_CREDENTIAL_ALIAS}}

请勿将凭据、租户 URL、私有主机名、证书和已部署的运行时状态包含在生成的工件中。如果没有可用于导入测试的 SAP Cloud Integration 租户，请说明本地包结构和 XML 验证已通过，但租户导入仍待完成。

集成流结构

Sender → [Adapter] → Integration Process → [Adapter] → Receiver
                           ↓
              ┌────────────┴────────────┐
              │  Message Processing     │
              │  - Content Modifier     │
              │  - Router/Filter        │
              │  - Mapping              │
              │  - Splitter/Aggregator  │
              │  - Script               │
              │  - External Call        │
              └─────────────────────────┘

常见流步骤

类别	步骤
路由	Router、Filter、Multicast、Recipient List
转换	Content Modifier、Mapping、Converter、Script
拆分	General Splitter、Iterating Splitter、EDI Splitter
持久化	Data Store、Write Variable、JMS Send
外部	Request Reply、Send、Poll Enrich、Content Enricher
安全	Encryptor、Decryptor、Signer、Verifier
错误处理	Exception Subprocess、Escalation Event

适配器类别

协议适配器：HTTP、HTTPS、SFTP、FTP、AMQP、JMS、Kafka、AS2、AS4、SOAP、OData 应用适配器：SuccessFactors、Ariba、Salesforce、ServiceNow、Workday 数据库适配器：JDBC（Oracle、SQL Server、PostgreSQL、HANA、DB2） 云适配器：AWS（S3、SQS、SNS）、Azure（Service Bus、Storage）、Google Cloud

脚本编写指南

优先使用标准步骤，而非脚本。必须编写脚本时：

// Access message body
def body = message.getBody(String.class)

// Access headers
def header = message.getHeader("HeaderName", String.class)

// Access properties
def prop = message.getProperty("PropertyName")

// Modify body
message.setBody(newBody)

// Add header
message.setHeader("NewHeader", "value")

// Logging (use SLF4J)
def log = org.slf4j.LoggerFactory.getLogger("script")
log.info("Processing message")

最佳实践：

• 对于大型负载，使用 XmlSlurper.parse(Object)，而不是 parseText(String)
• 使用 StringBuilder 拼接字符串
• 切勿使用 TimeZone.setDefault()（会影响整个 VM）
• 切勿将凭据写入标头（跟踪会暴露凭据）

---

API 管理开发

API 代理结构

Client → Proxy Endpoint → [Policies] → Target Endpoint → Backend
              ↓                              ↓
         PreFlow                        PreFlow
         Conditional Flows              Conditional Flows
         PostFlow                       PostFlow
              ↓                              ↓
         Fault Rules                    Fault Rules

策略类别

类别	策略
安全	OAuth 2.0、Verify API Key、Basic Auth、SAML、Access Control
流量	Quota、Spike Arrest、Concurrent Rate Limit、Response Cache
中介	Assign Message、Extract Variables、JSON/XML Transform、XSL Transform
扩展	JavaScript、Python Script、Service Callout
威胁防护	JSON/XML Threat Protection、Regular Expression Protection
日志记录	Message Logging、Statistics Collector

常见策略属性

<PolicyName enabled="true" continueOnError="false" async="false">
  
</PolicyName>

---

消息服务质量

恰好一次处理

在必须防止重复消息时使用：

1. JMS 队列 - 事务性消息存储
2. 幂等流程调用 - 通过 ID 映射检测重复消息
3. Data Store - 持久化消息跟踪

幂等模式

Sender → [ID Mapping] → Check Duplicate → Process → [ID Mapping Complete]
                              ↓ (duplicate)
                         Return Cached Response

---

Edge Integration Cell

部署要求

• Kubernetes 集群（EKS、AKS、GKE、OpenShift、RKE2）
• 最低要求：4 个工作节点，每个节点 4 vCPU、16GB RAM
• 存储：100GB+ 持久卷
• 网络：Ingress 控制器、DNS 配置

工作流

1. 在 Integration Suite 中激活 Edge Integration Cell
2. 准备 Kubernetes 集群（因平台而异）
3. 部署 Edge Lifecycle Management Bridge
4. 部署 Edge Integration Cell 解决方案
5. 配置密钥库同步
6. 部署集成内容

---

故障排除

常见问题

问题	解决方法
适配器连接失败	检查凭据、防火墙和 Cloud Connector
消息映射错误	验证源结构和目标结构，检查 XPath
超时	增加适配器超时时间，优化映射
内存问题	流式处理大型负载，减少日志记录
消息重复	实现幂等处理
密钥库同步失败	验证证书有效性，检查权限

监控层级

Integration Suite → Monitor → Integrations and APIs
    ├── Message Processing → All Integration Flows
    ├── Manage Integration Content → Deployed Artifacts
    ├── Manage Security → Keystores, Credentials
    └── Manage Stores → Data Stores, Variables, Queues

---

限制参考

资源	限制
每个租户的集成流	因计划而异
JMS 队列	每个租户 30 个（标准版）
数据存储	总存储空间 100MB
消息处理日志保留期	30 天
附件大小	40MB
API 代理（APIM）	根据服务计划而定
业务数据图	每个账户 500 个，每个子账户 50 个

---

捆绑资源

参考文档

references/ 目录中提供详细指南：

核心开发：

• cloud-integration.md - iFlow 开发、步骤、模式和最佳实践
• iflow-package-authoring.md - 可导入的 iFlow 软件包结构以及 HTTPS 到 SFTP 的生成规则
• adapters.md - 所有 80 多种适配器配置（HTTP、SFTP、OData、RFC 等）
• scripting.md - Groovy/JavaScript 模式、API 和模板
• api-management.md - API 代理开发、34 种策略、Developer Hub
• security.md - 身份验证、密钥库、证书和凭据

功能：

• edge-integration-cell.md - 混合 Kubernetes 部署指南
• event-mesh.md - 主题、队列、代理、Webhook 和 EDA 模式
• integration-advisor-tpm.md - B2B 集成、MIG、MAG 和合作伙伴管理
• graph-odata.md - 业务数据图、OData 配置
• data-space-integration.md - Catena-X、EDC 和主权数据交换
• migration-assessment.md - PO 迁移、ISA-M 和技术映射

运维：

• operations-monitoring.md - 消息监控、存储和连接测试
• content-transport.md - TMS、CTS+、MTAR、手动导出/导入
• troubleshooting.md - 错误解决、诊断和 HTTP 错误目录

模板

templates/ 目录中提供可直接使用的模板：

• https-to-sftp-iflow-package/ - 可供审查的未压缩、可导入 iFlow 模板，适用于 HTTPS 发送方到 SFTP 接收方场景
• groovy-script-template.groovy - 常见脚本模式
• api-policy-template.xml - 策略配置模板

---

文档链接

官方来源

• GitHub 仓库：https://github.com/SAP-docs/sap-btp-integration-suite
• SAP Help Portal：https://help.sap.com/docs/integration-suite
• SAP Community：https://community.sap.com/topics/cloud-platform-integration-suite
• SAP Business Accelerator Hub：https://api.sap.com/

特定功能

• Cloud Integration：https://help.sap.com/docs/cloud-integration
• API Management：https://help.sap.com/docs/sap-api-management
• Event Mesh：https://help.sap.com/docs/event-mesh
• Integration Advisor：https://help.sap.com/docs/integration-advisor

发布说明

• 新增内容：查看文档中的 what-s-new-for-sap-integration-suite-79cd682.md
• 补丁版本发布：查看 patch-release-notes-for-sap-integration-suite-58595b5.md