sap-btp-developer-guide

SAP BTP 开发者指南技能

相关技能

• sap-btp-cloud-platform：用于了解平台基础知识、账户管理和运行时配置
• sap-btp-best-practices：用于获取架构指导、治理模型和生产环境模式
• sap-cap-capire：用于了解 CAP 开发详情、服务定义和数据库集成
• sap-fiori-tools：用于 UI 开发、Fiori 应用设置和前端部署
• sap-abap：用于了解 ABAP Cloud 开发、RAP 模式和 ABAP Environment 特性
• sap-btp-connectivity：用于实现与本地部署系统的安全连接
• sap-ai-core：用于设置 AI Core 平台、部署模型和编排
• sap-cloud-sdk-ai：用于在 CAP 应用中进行 SDK 级别的 AI 集成

全面介绍如何在 SAP Business Technology Platform 上开发、部署和运营业务应用。

目录

快速导航

• 目录
• 何时使用此技能
• 运行时和编程模型选择
• 开发工作流
• 关键服务和工具
• 安全实现
• 连接模式
• CI/CD 实现
• 可观测性实现
• 教程和学习任务
• 合作伙伴/ISV 开发
• 常见错误和解决方案
• 捆绑资源
• 快速参考链接
• 版本信息

何时使用此技能

适用于以下场景：

• 在 SAP BTP（Cloud Foundry 或 Kyma 运行时）上构建新应用
• 使用 SAP Cloud Application Programming Model（CAP）进行开发
• 在 SAP BTP ABAP Environment 中构建 ABAP Cloud 应用
• 部署 SAP Fiori 或 SAPUI5 用户界面
• 将应用连接到 SAP S/4HANA、SuccessFactors 或本地部署系统
• 构建多租户 SaaS 应用
• 为 SAP 解决方案实现并行扩展
• 构建 AI 驱动的扩展（大模型分析、文档处理、智能自动化）
• 为 SAP BTP 设置 CI/CD 流水线
• 使用 SAP Cloud ALM 或 SAP Cloud Logging 实现可观测性
• 使用 SAP HANA Cloud 进行数据持久化

运行时和编程模型选择

运行时详细对比：参见 references/runtimes.md

决策矩阵

标准	CAP（Cloud Foundry/Kyma）	ABAP Cloud
语言	Node.js、Java、TypeScript	ABAP
最适合	新建云原生应用、扩展	具备 ABAP 专业知识的组织
运行时	Cloud Foundry 或 Kyma	SAP BTP ABAP Environment
持久化	SAP HANA Cloud、PostgreSQL	SAP HANA Cloud（由 ABAP 管理）
UI 框架	SAP Fiori Elements、SAPUI5	SAP Fiori Elements、SAPUI5
IDE	SAP Business Application Studio、VS Code	ABAP Development Tools（Eclipse）

CAP 应用开发

CAP 提供三种运行配置：

• 开发：模拟服务、最少配置，以及用于本地测试的 SQLite/H2
• 混合：连接到云服务的本地应用
• 生产：使用 SAP HANA Cloud 的完整云部署

主要功能：

• 使用 CDS（Core Data Services）进行领域驱动设计
• 内置多租户支持
• 自动生成 OData/REST 服务
• 与平台无关的设计（无供应商锁定）

CAP 详情：参见 references/cap-development.md

借助 CAP 构建 AI 驱动的扩展

结合 CAP 与 SAP AI Core，构建智能并排扩展：

1. 绑定 AI Core：通过 MTA 将其绑定到 CAP 应用（服务：aicore，计划：extended）
2. 在 CAP 事件处理程序中使用 SAP Cloud SDK for AI（@sap-ai-sdk/orchestration）——切勿直接调用原始 HTTP 接口
3. 异步处理：大模型调用可能需要 30-60 秒。返回 202 Accepted，并使用 cds.spawn 在后台处理，以避免 BTP 负载均衡器超时
4. 存储向量：在 CDS 实体中使用 HANA Cloud Vector(1536) 类型，以支持 RAG 场景
5. 外置提示词：将提示词存储在 JSON 文件或 CDS 实体中，以便更新时无需重新部署
6. 分配内存：使用 AI SDK 的 Node.js 容器至少分配 512MB 内存

完整代码示例请参见 sap-cap-capire 技能（AI 集成部分）和 sap-cloud-sdk-ai 技能（CAP 集成小节）。

ABAP Cloud 开发

ABAP Cloud 使用四项基础技术：

1. Core Data Services（CDS） - 数据建模与分析
2. ABAP RESTful Application Programming Model（RAP） - 面向服务的开发
3. 受限 ABAP 语言 - 安全用于云环境的 API 访问
4. 已发布的公共 API - 升级稳定的扩展

ABAP 详情请参见：references/abap-cloud.md

开发工作流

阶段 1：探索与发现

1. 确定业务问题 - 采访利益相关方
2. 了解用户需求 - 走访客户，观察工作流
3. 定义安全要求 - 威胁建模、合规规划（GDPR、HIPAA）
4. 建立治理机制 - 设置组织架构

阶段 2：设计

1. 用户体验设计

   • 遵循 SAP Fiori Design Guidelines
   • 实施无障碍访问（WCAG 2.2）
   • 使用设计思维方法

2. 技术设计

   • 对复杂应用（30+ 个用例）采用领域驱动设计
   • 定义模块边界和通信模式
   • 如有需要，规划微服务架构

3. 设计阶段的安全

   • 使用 SAP Fiori 身份验证保护用户界面
   • 使用 OAuth/OpenID Connect 实施 RBAC/ABAC
   • 验证 CDS 模型以保护数据

设计模式请参见：references/design-patterns.md

阶段 3：开发

CAP 开发：

# Initialize CAP project
cds init my-project
cd my-project

# Add SAP HANA support
cds add hana

# Add authentication
cds add xsuaa

# Run locally
cds watch

主要开发工具：

• SAP Business Application Studio（主要 IDE）
• SAP Cloud SDK（OData/OpenAPI 客户端）
• MTA Build Tool（打包）

编码标准：

• 遵循 SAPUI5 Guidelines 和 SAP Fiori Design Guidelines
• 制定命名约定
• 实施参数化查询（防止 SQL 注入）
• 使用 CDS 约束验证输入

工具目录请参见：references/tools.md

阶段 4：部署

Cloud Foundry 部署：

# Build MTA archive
mbt build

# Deploy to Cloud Foundry
cf deploy mta_archives/my-project_1.0.0.mtar

Kyma 部署：

# Use Helm charts or Terraform
terraform init
terraform apply

ABAP 部署：

• 使用 Manage Software Components 应用（gCTS）
• 通过 Landscape Portal 进行传输
• 合作伙伴选项：多租户 SaaS 或附加产品

部署详情请参见：references/deployment.md

阶段 5：运行与扩展

监控：

• SAP Cloud ALM（集中式可观测性）
• SAP Cloud Logging（详细日志、指标、追踪）
• ABAP Technical Monitoring Cockpit

扩展：

• Cloud Foundry：跨 AZ 自动分配实例
• Kyma：Kubernetes 原生扩展
• ABAP：使用 ACU 弹性扩展（每次递增 0.5 ACU）

成本优化：

• 系统休眠（ABAP）- 将运营成本降低至 <5%
• SAP HANA Cloud Native Storage Extension
• 用于峰值工作负载的 Elastic Compute Nodes

运维详情请参见：references/operations.md

关键服务与工具

平台服务

服务	用途
SAP HANA Cloud	数据库即服务，多模型
SAP Connectivity Service	通过 Cloud Connector 连接本地环境/VPC
SAP Destination Service	路由、身份验证管理
SAP Event Mesh	在应用之间分发事件
SAP Integration Suite	API 管理、云集成

开发工具

工具	用途
SAP Business Application Studio	主要云端 IDE
SAP Build	低代码／无代码开发
Cloud Foundry CLI	CF 部署和管理
kubectl/Helm	Kyma/Kubernetes 管理
Terraform Provider for SAP BTP	基础设施即代码

有关架构详情：请参阅 references/architecture.md

安全实施

CAP 安全功能

• 参数化查询（防止 SQL 注入）
• UI 应用的 CSRF 防护
• 内置身份验证／授权框架
• 使用 SAP Credential Store 管理机密

安全指南

1. 安全的环境配置 - 限制网络访问
2. 安全测试 - 上线前进行渗透测试
3. 安全的部署流水线 - 代码扫描、依赖项验证
4. 机密管理 - 使用 SAP Credential Store

有关安全详情：请参阅 references/security.md

连接模式

云到本地

• SAP Connectivity Service + Cloud Connector
• 支持用户传播
• 协议：HTTP、RFC、LDAP、FTP

云到云

• 使用 SAP Destination Service 进行路由
• OAuth 令牌管理
• 用于 Kubernetes 的 SAP Transparent Proxy

有关连接详情：请参阅 references/connectivity.md

CI/CD 实施

SAP Continuous Integration and Delivery 提供预配置的流水线：

• Cloud Foundry Environment 作业（SAP Fiori、CAP）
• SAP Fiori for ABAP Platform 作业
• SAP Integration Suite Artifacts 作业

设置步骤：

1. 在 SAP BTP cockpit 中启用
2. 分配管理员／开发者角色
3. 配置仓库凭据（GitHub、GitLab、Bitbucket、Azure Repos）
4. 添加仓库并创建作业
5. 配置 Webhook 以自动构建

有关 CI/CD 详情：请参阅 references/cicd.md

可观测性实施

中央层（SAP Cloud ALM）

• 真实用户监控
• 健康监控
• 集成和异常监控
• 合成用户监控

本地层（SAP Cloud Logging）

• 日志分析（基于 OpenSearch）
• 分布式追踪
• 自定义仪表板和告警

OpenTelemetry 是业界的检测标准。

有关可观测性详情：请参阅 references/observability.md

教程和任务

CAP 学习路径

1. 入门任务：全栈 CAP 应用
2. 扩展任务：并行 CAP 扩展
3. 企业任务：变更跟踪、审计日志记录、附件
4. 多租户任务：SaaS 应用开发
5. 可观测性任务：SAP Cloud Logging 集成

ABAP 学习路径

1. RAP100 基础：Fiori 应用、OData 服务、业务逻辑
2. RAP100 中级：操作、动态功能控制、单元测试
3. RAP120：借助 SAP Joule 进行 AI 辅助开发
4. 分析：使用 SAP Analytics Cloud 的 CDS 视图

示例应用：

• 事件管理（CAP）
• 航班参考场景（ABAP）
• Poetry Slam Manager（合作伙伴 SaaS）

有关教程详情：请参阅 references/tutorials.md

捆绑资源

文件结构

sap-btp-developer-guide/
├── SKILL.md                 # This file - Main guidance
├── README.md               # Quick reference with auto-trigger keywords
└── references/             # Detailed guides (22 files)
    ├── Architecture & Setup
    │   ├── architecture.md      # Platform services and architecture
    │   ├── runtimes.md          # Runtime comparison (CF vs Kyma vs ABAP)
    │   ├── setup.md             # BTP landscape setup and Terraform
    │   └── tools.md             # Development tools catalog
    ├── Development
    │   ├── cap-development.md   # CAP development guide
    │   ├── abap-cloud.md        # ABAP Cloud development guide
    │   ├── design-patterns.md   # Design patterns and DDD
    │   ├── extensions.md        # SAP solution extensions
    │   ├── mta.md               # Multitarget applications
    │   ├── testing.md           # Testing strategies
    │   └── ux-design.md         # UX design and Fiori
    ├── Integration & Security
    │   ├── connectivity.md      # Connectivity patterns
    │   ├── security.md          # Security implementation
    │   ├── hana-cloud.md        # SAP HANA Cloud
    │   └── resilience.md        # Resilience patterns
    ├── Deployment & Operations
    │   ├── deployment.md        # Deployment options
    │   ├── cicd.md              # CI/CD pipelines
    │   ├── observability.md     # Monitoring and logging
    │   ├── operations.md        # Operations and scaling
    │   └── partners.md          # ISV/Partner development
    └── Additional Resources
        ├── tutorials.md         # Learning paths and missions
        └── whats-new.md         # Changelog and updates

按类别划分的参考文件

架构与平台（4 个文件）

• architecture.md - 平台服务概述和架构模式
• runtimes.md - 运行时比较和选择指南
• setup.md - BTP 环境设置及规模建议
• tools.md - 完整的开发工具目录

开发（8 个文件）

• cap-development.md - 使用 Node.js/Java 进行 CAP 开发
• abap-cloud.md - 使用 RAP 进行 ABAP Cloud 开发
• design-patterns.md - 领域驱动设计和模式
• extensions.md - SAP 解决方案的并行扩展
• mta.md - 多目标应用打包
• testing.md - 测试策略和框架
• ux-design.md - SAP Fiori UX 设计指南

集成与安全（4 个文件）

• connectivity.md - 云端到本地的连接
• security.md - 身份验证、授权与安全
• hana-cloud.md - SAP HANA Cloud 数据库
• resilience.md - 应用弹性模式

部署与运维（5 个文件）

• deployment.md - 部署到 CF、Kyma 和 ABAP
• cicd.md - 使用 SAP 工具的 CI/CD 流水线
• observability.md - 监控、日志记录与追踪
• operations.md - 运维、扩展与成本优化
• partners.md - ISV/合作伙伴开发指南

学习与更新（2 个文件）

• tutorials.md - 实践任务与教程
• whats-new.md - 最新功能与更新日志

合作伙伴/ISV 开发

部署选项

1. 多租户 SaaS - 在合作伙伴的全球账户中运行的云服务
2. 附加产品 - 安装在客户的 ABAP 环境中

要求

• SAP PartnerEdge Build 合同
• 已注册的 ABAP 命名空间（必需）
• 用于生命周期管理的 Landscape Portal

合作伙伴详情：参见 references/partners.md

快速参考链接

官方文档：

• SAP BTP 帮助文档：https://help.sap.com/docs/btp
• CAP 文档：https://cap.cloud.sap/docs/
• SAP Discovery Center：https://discovery-center.cloud.sap/
• SAP API Business Hub：https://api.sap.com/

设计资源：

• SAP Fiori 设计：https://experience.sap.com/fiori-design-web/
• SAPUI5 SDK：https://sapui5.hana.ondemand.com/

学习：

• SAP 开发者：https://developers.sap.com/
• SAP 学习平台：https://learning.sap.com/

源文档：

• 本技能基于：https://github.com/SAP-docs/btp-developer-guide

常见错误与解决方案

错误	原因	解决方案
第三方 Cookie 问题	浏览器弃用	参见 SAP Note 3409306
XSUAA 绑定失败	缺少服务实例	运行 cf create-service xsuaa application
HANA 部署错误	目标容器错误	检查 mta.yaml 中的 requires
ATC Priority 1 发现项	代码不符合云端要求	使用 ABAP_CLOUD_DEVELOPMENT_DEFAULT 变体

版本信息

• 源文档最后更新：2025-11-21
• 基于：SAP BTP Developer Guide（https://github.com/SAP-docs/btp-developer-guide）
• 下次审核：2026-02-21