在 SAP BTP Integration Suite…

适用于在 SAP BTP Integration Suite 中开发或排障 Cloud Integration iFlow、API Management 代理、Event Mesh、Edge Integration Cell、Integration Advisor、Trading Partner Management 及迁移评估。

适用场景

解决思路

1. 生成可导入的 iFlow 包时，先阅读 references/iflow-package-authoring.md，不要凭空创建扁平的纯 XML 包。
2. 对于 HTTPS-to-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。
3. 除非用户要求不同设计，只定制外部化占位符：{{HTTPS_ENDPOINT_PATH}}、{{SFTP_HOST}}、{{SFTP_PORT}}、{{SFTP_DIRECTORY}}、{{SFTP_FILENAME}}、{{SFTP_CREDENTIAL_ALIAS}}。
4. 生成的工件中不得包含凭据、租户 URL、私有主机名、证书和已部署运行时状态；若无 SAP Cloud Integration 租户做导入测试，需说明本地包结构与 XML 校验已通过但租户导入仍待验证。
5. 按 iFlow 结构组织流程：Sender → [Adapter] → Integration Process → [Adapter] → Receiver，消息处理可包含 Content Modifier、Router/Filter、Mapping、Splitter/Aggregator、Script、External Call。
6. 按需选用常见流程步骤：路由（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）。
7. 按场景选择适配器：协议类（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）。
8. 优先使用标准步骤而非脚本；必须脚本时用 Groovy 访问 message.getBody(String.class)、message.getHeader("HeaderName", String.class)、message.getProperty("PropertyName")，用 message.setBody(newBody)、message.setHeader("NewHeader", "value") 修改消息，并用 org.slf4j.LoggerFactory.getLogger("script") 记录日志。
9. 脚本最佳实践：大负载用 XmlSlurper.parse(Object) 而非 parseText(String)，字符串拼接用 StringBuilder，禁止使用 TimeZone.setDefault()（影响整个 VM），禁止把凭据写入 header（追踪会暴露）。
10. 构建 API 代理时按结构组织：Client → Proxy Endpoint → [Policies] → Target Endpoint → Backend，两端均配置 PreFlow、Conditional Flows、PostFlow 和 Fault Rules。
11. 按类别选用 API 策略：安全（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）。
12. 策略属性使用 <PolicyName enabled="true" continueOnError="false" async="false"> 形式配置。
13. 需要精确一次处理时，使用 JMS 队列、Idempotent Process Call（通过 ID 映射去重）或 Data Store（持久化消息跟踪）。
14. 幂等模式：Sender → [ID Mapping] → Check Duplicate → Process → [ID Mapping Complete]，重复消息返回缓存响应。
15. 部署 Edge Integration Cell 需满足：Kubernetes 集群（EKS、AKS、GKE、OpenShift、RKE2），最少 4 个工作节点、每节点 4 vCPU、16GB RAM，100GB+ 持久卷，Ingress 控制器与 DNS 配置。
16. Edge Integration Cell 工作流：在 Integration Suite 中激活 → 准备 Kubernetes 集群（按平台）→ 部署 Edge Lifecycle Management Bridge → 部署 Edge Integration Cell 解决方案 → 配置 keystore 同步 → 部署集成内容。
17. 排障常见问题：适配器连接失败检查凭据、防火墙、Cloud Connector；消息映射错误校验源/目标结构与 XPath；超时增大适配器超时并优化映射；内存问题流式处理大负载并减少日志；重复消息实现幂等处理；keystore 同步失败验证证书有效性与权限。
18. 通过监控层级定位问题：Integration Suite → Monitor → Integrations and APIs，下含 Message Processing（所有 iFlow）、Manage Integration Content（已部署工件）、Manage Security（Keystores、Credentials）、Manage Stores（Data Stores、Variables、Queues）。
19. 注意资源限制：JMS 队列每租户 30 个（标准），Data Store 总存储 100MB，消息处理日志保留 30 天，附件大小 40MB，Business Data Graph 每账号 500/每子账号 50。
20. 查阅捆绑资源：references/ 下的 cloud-integration.md、iflow-package-authoring.md、adapters.md、scripting.md、api-management.md、security.md、edge-integration-cell.md、event-mesh.md、integration-advisor-tpm.md、graph-odata.md、data-space-integration.md、migration-assessment.md、operations-monitoring.md、content-transport.md、troubleshooting.md；templates/ 下的 https-to-sftp-iflow-package/、groovy-script-template.groovy、api-policy-template.xml。
21. 参考官方文档：GitHub 仓库 https://github.com/SAP-docs/sap-btp-integration-suite、SAP Help Portal https://help.sap.com/docs/integration-suite、SAP Community、SAP Business Accelerator Hub https://api.sap.com/，以及各能力专属文档与 What's New/补丁发布说明。

适用边界 · 注意事项

• 未订阅 SAP BTP Integration Suite 或没有相应租户/权限时无法直接执行。
• 需要非 SAP 集成平台（如 MuleSoft、Boomi）的场景不适用。
• Edge Integration Cell 需要自备 Kubernetes 集群，无集群时无法部署。