在 SAP BTP 上使用 CIAS 进行引导式集成：订阅…

适用于 SAP BTP Cloud Integration Automation Service（CIAS）的订阅、角色分配、集成场景规划、任务处理、执行监控、OAuth2 API 访问和常见错误排查。

适用场景

解决思路

1. 选择 CIAS 服务计划：Standard 计划用于 UI 访问、场景规划、任务监控和集成管理；OAuth2 计划用于程序化 API 访问（ABAP 自动化必需）。
2. 订阅 CIAS（Standard Plan）：进入 SAP BTP Cockpit → Global Account → Subaccount；转到 Services → Service Marketplace；筛选 Cloud Integration Automation Service；点击 tile → Create → 选择 Standard 计划；确认创建；通过 Instances and Subscriptions → “Go to Application” 图标访问。
3. 分配角色集合：进入子账户 Security → Role Collections；选择角色集合（如 CIASIntegrationAdministrator）；点击 Edit → Users；按 email ID 或 login user ID 添加用户；保存；一个角色可用逗号分隔多个用户 ID。
4. 按用途使用角色集合：CIASIntegrationAdministrator 拥有 Plan for Integration、My Inbox、Monitoring 完整权限并可终止场景；CIASIntegrationExpert 可访问 My Inbox 并处理分配任务；CIASIntegrationMonitor 对 Scenario Execution Monitoring 只读。
5. 规划集成场景：从 Instances and Subscriptions 访问 CIAS 应用；打开 Plan for Integration tile；在 Solutions 标签浏览可用解决方案；选择 scenario 和 scenario option；按 customer number 选择系统；指定目标 subaccount、SAP BTP Workflow Users（必须有子账户访问权）、用于监控的 Transaction name；确认工作流生成；在 My Inbox tile 访问任务。
6. 处理 My Inbox 任务：打开 My Inbox tile（需要 Administrator 或 Expert 角色）；点击 Claim 锁定任务；查看 Task Instructions 标签；自动化任务配置参数后点击 Execute Step；完成后点击 Task Completed；点击 Refresh 显示下一任务；重复直到查看 Execution Summary。
7. 为自动化创建 Destination：在 My Inbox → Confirm System Components 任务点击 Create Destination 链接；配置 Name（有效标识符）、Description（用途描述）、URL（目标系统主机 URL）、Authentication（方法+凭据）、Type（默认 HTTP）；保存；始终使用 HTTPS。
8. 监控场景执行：打开 Scenario Execution Monitoring tile（需要 Administrator 或 Monitor 角色）；按 Running、Completed、Canceled 过滤 workflows；查看 Task Details、Targets、Roles and Users、Scope、Support Information 标签；用 Terminate Execution 永久移除场景；在 Logs 标签查看自动化执行详情。
9. 遵守 CIAS 服务限制：每个子账户最多 15 个 active workflows；不可自助删除数据，需向组件 BC-INS-CIT-RT 提 ticket；日志保留 90 天；OAuth2 证书最长有效期 1 年；确认后不能修改执行范围；Destination 一旦用于自动化任务就不能更改；使用受支持浏览器 Google Chrome、Microsoft Edge (Chromium)、Mozilla Firefox、Apple Safari (macOS)。
10. 按安全架构配置：确保 Runtime 渲染集成任务、Planning 规划 UI、Inbox 任务 UI、Monitoring 监控 UI、Managed System 被配置系统、Automation Runtime 调用受管系统配置 API；通过 SAP BTP 授权框架做基于角色的访问；后端连接调用启用 XSRF 保护；集成身份提供者并支持 SAML assertion Name ID attribute；凭据存放在 Credential Store service，外部方不可访问。
11. 修复 Destination 下拉为空：当任务执行时 Destination 下拉无选项，原因是没有匹配租户 Host Base URL 的 destination；手动创建 destination；确保 destination URL 与租户 Host Base URL 完全匹配；创建后刷新下拉。
12. 处理 Workflow Conflict Lock：当多个集成工作流具有相同系统组件且执行锁激活时，选择 Proceed 继续稍后手动解决；Terminate 结束选定冲突实例；Terminate Current Instance 仅停止活动工作流；Cancel 完全停止操作。
13. 修复 IdP 变更后应用访问被拒：将用户添加到新的 identity provider；在子账户 Security 设置中重新分配角色集合；验证用户 ID 存在于已配置 IdP。
14. 处理任务被标记为 Reserved：无法 claim 任务时与团队协调；同一时间只有一名用户可处理已 claim 的任务。
15. 使用支持渠道：一般 CIAS 支持向组件 BC-INS-CIT-RT 创建 support ticket；手动任务说明查看 Support Information 标签并向列出的组件提交 incident；数据删除请求向 BC-INS-CIT-RT 提交并包含 email ID 和 subaccount name；服务可用性在 Consumer account 中检查 Service Availability 功能。
16. 配置 OAuth2 API 访问：进入子账户 Services → Service Marketplace；选择 Cloud Integration Automation Service → Create；选择 OAuth2 计划；选择 runtime “Other” 或 “Cloud Foundry”；提供 instance name → Create。
17. 创建 OAuth2 Service Key（mTLS 证书）：使用 xsuaa.credential-type=x509、x509.key-length=2048、x509.validity=365、x509.validity-type=DAYS 的 JSON；无证书时仅用 name 创建；使用生成的 client ID 和 client secret 创建 OAuth JWT token 进行 API 认证。
18. 遵守数据保护要求：Email IDs 和 subaccount names 存储在服务数据库；系统/租户选择数据保留用于工作流执行；日志不存储用户相关个人数据；审计日志遵循 SAP BTP Audit Log retention policy；敏感数据存储在 Credential Store service。
19. 使用 Task UI 自动化任务控件：Refresh 更新自动化状态；Expand All 显示所有参数面板；Collapse All 隐藏所有参数面板；Show/Hide Read-Only Parameters 切换只读可见性；Save Parameters 保存当前值；Logs 查看执行记录；Information 查看参数描述；Execute Step 异步运行自动化。
20. 自动化失败恢复：选择 Only Failed Automations 仅重试失败步骤；选择 All Automations 重试整个序列。
21. 参考捆绑资源：setup-guide.md 查订阅、OAuth2、destination 配置；security-guide.md 查安全架构、IdP 配置、角色管理；integration-scenarios.md 查 100+ 支持场景与代码（1M1、22K、4A1 等）；troubleshooting.md 查错误解决；maintenance-planner.md 查 Maintenance Planner 集成与工作流调用；task-ui-guide.md 查任务 UI 控件、标签、行为、自动化步骤；whats-new.md 查 2021-2025 release notes；destination-config.md 查目标系统类型 destination 配置模板；role-assignment.md 查角色分配流程和清单。
22. 查阅官方文档源：GitHub SAP-docs/btp-cloud-integration-automation-service/tree/main/docs；SAP Help Portal https://help.sap.com/docs/cloud-integration-automation-service；Maintenance Planner https://maintenanceplanner.cfapps.eu10.hana.ondemand.com；Credential Store 和 SAP BTP Destinations 的帮助页面。
23. 在支持区域使用 CIAS：AWS EU10、EU11、US10、AP10、JP10、CA10；Azure EU20、CN20；Alibaba CN40。
24. 配合相关技能：子账户、订阅、entitlement、role collection 设置用 sap-btp-cloud-platform；destinations、OAuth2 service instances、Cloud Connector 依赖用 sap-btp-connectivity；CIAS 场景产生或依赖 Integration Suite artifacts 时用 sap-btp-integration-suite；影响 CIAS 访问的 identity-provider 和 trust 配置用 sap-btp-cloud-identity-services。

适用边界 · 注意事项

• 不适用于非 SAP BTP 环境或未订阅 CIAS 的场景。
• 若只需配置 BTP 子账户、授权、目标、连接器、Integration Suite 或 IdP，应使用对应的 sap-btp-* 技能，而不是本技能。
• 需要 ABAP 自动化时，若未创建 OAuth2 实例和 Service Key，不能使用 OAuth2 API 访问。