sap-btp-business-application-studio

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SAP Business Application Studio

SAP Business Application Studio

Table of Contents

目录

Overview

概述

SAP Business Application Studio is a cloud-based IDE on SAP BTP built on Code-OSS (VS Code foundation). It provides tailored dev spaces for SAP Fiori, CAP, HANA, and mobile development with pre-installed tools and runtimes.
Architecture: Multi-cloud SaaS (AWS, Azure, GCP) with isolated dev spaces functioning as Developer Virtual Appliances.
SAP Business Application Studio是基于Code-OSS(VS Code基础)构建、运行在SAP BTP上的云原生IDE。它为SAP Fiori、CAP、HANA和移动应用开发提供定制化的开发空间,预装了相关工具和运行时环境。
架构:多云SaaS(AWS、Azure、GCP),隔离的开发空间充当开发者虚拟设备。

Quick Decision Tree

快速决策树

Setting up BAS? → See Setup Checklist Creating a dev space? → See Dev Space Types Connecting to external systems? → See Connectivity Deploying applications? → See Build & Deploy Working with Git? → See
references/git-operations.md
Project creation/development? → See
references/development-workflow.md
Service Center/Extensions? → See
references/service-center-and-tools.md
Troubleshooting? → See
references/connectivity-guide.md

正在设置BAS? → 查看设置检查清单 正在创建开发空间? → 查看开发空间类型 正在连接外部系统? → 查看连接配置 正在部署应用? → 查看构建与部署 正在使用Git? → 查看
references/git-operations.md
正在进行项目创建/开发? → 查看
references/development-workflow.md
正在使用服务中心/扩展? → 查看
references/service-center-and-tools.md
正在排查问题? → 查看
references/connectivity-guide.md

Setup Checklist

设置检查清单

Prerequisites

前提条件

  • SAP BTP global account
  • Subaccount in Cloud Foundry environment
  • SAP BTP全球账户
  • Cloud Foundry环境下的子账户

Steps

步骤

  1. Create Subaccount - Select region based on availability
  2. Configure Entitlements - Add SAP Business Application Studio service plan
  3. Subscribe - Complete subscription in subaccount
  4. Assign Roles - Add
    Business_Application_Studio_Developer
    role collection
  5. Optional: Configure IdP - Set up assertion-based attribute mapping
  6. Optional: Connect Git - Link to public or corporate repositories
  7. Optional: Create CF Spaces - At least 1 space per development team
For detailed setup: See
references/setup-checklist.md

  1. 创建子账户 - 根据可用区域选择区域
  2. 配置权限配额 - 添加SAP Business Application Studio服务计划
  3. 完成订阅 - 在子账户中完成订阅操作
  4. 分配角色 - 添加
    Business_Application_Studio_Developer
    角色集合
  5. 可选:配置身份提供商(IdP) - 设置基于断言的属性映射
  6. 可选:连接Git - 关联公共或企业仓库
  7. 可选:创建CF空间 - 每个开发团队至少创建1个空间
详细设置步骤:查看
references/setup-checklist.md

Dev Space Types

开发空间类型

TypePurposeKey Extensions
SAP FioriFiori apps (CF, ABAP Cloud, on-prem)SAP Fiori Tools, SAPUI5 Layout Editor, MTA Tools
Full Stack Cloud ApplicationCAP with Node.js/Java + FioriCAP Tools, CDS Graphical Modeler, Java Tools
Full-Stack Application Using Productivity ToolsLow-code developmentProductivity Tools, CAP Tools, Mobile Services
SAP HANA Native ApplicationNative HANA apps, calculation viewsHANA Tools, Calculation View Editor, SDI Tools
SAP Mobile ApplicationiOS/Android with MDKMobile Services Tools, HTML5 Runner
SAP SME Business ApplicationSME apps with Business Application FactorySME programming model tools
BasicMinimal environmentSAP Basic Tools only
For extension details: See
references/dev-space-types.md

类型用途核心扩展
SAP Fiori开发Fiori应用(CF、ABAP Cloud、本地部署)SAP Fiori Tools、SAPUI5 Layout Editor、MTA Tools
Full Stack Cloud Application基于Node.js/Java的CAP + Fiori全栈开发CAP Tools、CDS图形建模器、Java Tools
Full-Stack Application Using Productivity Tools低代码开发生产力工具、CAP Tools、移动服务工具
SAP HANA Native Application原生HANA应用、计算视图开发HANA Tools、计算视图编辑器、SDI Tools
SAP Mobile Application基于MDK的iOS/Android应用开发移动服务工具、HTML5运行器
SAP SME Business Application基于Business Application Factory的中小企业应用开发中小企业编程模型工具
Basic极简开发环境仅包含SAP基础工具
扩展详情:查看
references/dev-space-types.md

Service Plans

服务计划

PlanDev SpacesRunningStorageNotes
Standard10210 GBProduction development
Free214 GBCommunity support only, 2 deployments max
Trial214 GB1-hour timeout, 30-day inactivity deletion
Build-CodeVariesVariesVariesRequires SAP Build Code subscription
For restrictions: See
references/service-plans.md

计划开发空间数量可同时运行数量存储空间说明
Standard10210 GB生产环境开发
Free214 GB仅社区支持,最多2次部署
Trial214 GB1小时超时,30天无活动将被删除
Build-Code按需分配按需分配按需分配需要SAP Build Code订阅
限制说明:查看
references/service-plans.md

Connectivity

连接配置

Required Destination Properties

必需的目标配置属性

WebIDEEnabled = true
HTML5.DynamicDestination = true
WebIDEEnabled = true
HTML5.DynamicDestination = true

WebIDEUsage by System Type

按系统类型划分的WebIDEUsage取值

System TypeWebIDEUsage Value
ABAP System
odata_abap,dev_abap
SAP Cloud for Customer
odata_c4c
Service URL
odata_gen
SAP Business Accelerator Hub
apihub_sandbox
系统类型WebIDEUsage取值
ABAP系统
odata_abap,dev_abap
SAP Cloud for Customer
odata_c4c
服务URL
odata_gen
SAP Business Accelerator Hub
apihub_sandbox

Cloud Connector Requirements (On-Premise)

云连接器(Cloud Connector)要求(本地系统)

  1. Virtual URL in Cloud Connector must match destination URL (host:port only)
  2. Protocol must be HTTP
  3. Grant access to required paths:
    • /sap/opu/odata/
      (OData services)
    • /sap/bc/ui5_ui5/
      (UI5 resources)
    • /sap/bc/adt/
      (ABAP Development Tools)
    • /sap/bc/ui2/app_index/
      (App index)
For troubleshooting: See
references/connectivity-guide.md

  1. 云连接器中的虚拟URL必须与目标配置URL匹配(仅主机:端口)
  2. 协议必须为HTTP
  3. 授予以下路径访问权限:
    • /sap/opu/odata/
      (OData服务)
    • /sap/bc/ui5_ui5/
      (UI5资源)
    • /sap/bc/adt/
      (ABAP开发工具)
    • /sap/bc/ui2/app_index/
      (应用索引)
排查指南:查看
references/connectivity-guide.md

Build & Deploy

构建与部署

Prerequisites

前提条件

  1. Log into Cloud Foundry account
  2. For HANA apps: Add "SAP HANA Cloud, SAP HANA Schemas & HDI Containers" entitlement
  3. For Trial/Free: Add "SAP Build Work Zone, standard edition" + Launchpad_Admin role
  1. 登录Cloud Foundry账户
  2. 开发HANA应用:添加“SAP HANA Cloud, SAP HANA Schemas & HDI Containers”权限配额
  3. 使用试用版/免费版:添加“SAP Build Work Zone, standard edition” + Launchpad_Admin角色

MTA Deployment

MTA部署

bash
undefined
bash
undefined

Build MTA archive

Build MTA archive

mbt build
mbt build

Deploy to Cloud Foundry

Deploy to Cloud Foundry

cf deploy mta_archives/<app>.mtar
undefined
cf deploy mta_archives/<app>.mtar
undefined

Key Tools

核心工具

  • MTA Editor: Visual editing of
    mta.yaml
  • Cloud Foundry CLI:
    cf
    commands for deployment
  • Cloud MTA Build Tool: Generates
    .mtar
    files
  • Task Explorer: Execute build/deploy tasks

  • MTA编辑器:可视化编辑
    mta.yaml
  • Cloud Foundry CLI:使用
    cf
    命令进行部署
  • Cloud MTA构建工具:生成
    .mtar
    文件
  • 任务资源管理器(Task Explorer):执行构建/部署任务

Roles & Authorization

角色与权限

RolePurpose
Developer
Business_Application_Studio_Developer
- Application development
AdministratorExport/delete user data, restart dev spaces
Extension DeployerCreate and deploy custom extensions
Assign via: SAP BTP Cockpit → Security → Role Collections

角色用途
开发者
Business_Application_Studio_Developer
- 应用开发
管理员导出/删除用户数据、重启开发空间
扩展部署者创建并部署自定义扩展
分配路径:SAP BTP控制台 → 安全 → 角色集合

Common Issues

常见问题

Dev Space Stuck in STARTING

开发空间卡在STARTING状态

  1. Wait 5 minutes
  2. If persists, start new dev space and restore via Git
  3. Contact support with workspace ID (ws-id)
  1. 等待5分钟
  2. 若仍未解决,创建新开发空间并通过Git恢复
  3. 联系支持并提供工作区ID(ws-id)

Connectivity Failures

连接失败

  1. Verify destination in BTP Cockpit (WebIDEEnabled, HTML5.DynamicDestination)
  2. Check Cloud Connector configuration
  3. Run in terminal:
    curl localhost:8887/reload
    then
    curl $H2O_URL/api/listDestinations -o dests.json
  1. 在BTP控制台验证目标配置(WebIDEEnabled、HTML5.DynamicDestination)
  2. 检查云连接器配置
  3. 在终端执行:
    curl localhost:8887/reload
    然后执行
    curl $H2O_URL/api/listDestinations -o dests.json

Storage/Inode Issues

存储/Inode问题

bash
df -ih  # Check inodes
df -h   # Check disk space
Remove cache folders and unnecessary files.
bash
df -ih  # Check inodes
df -h   # Check disk space
删除缓存文件夹和不必要的文件。

HANA Connection Issues

HANA连接问题

Configure SAP HANA Cloud to allow BAS IP addresses. See Availability for region IPs.

配置SAP HANA Cloud以允许BAS的IP地址。查看可用区域获取区域IP列表。

Keyboard Shortcuts

键盘快捷键

ActionShortcut
Command Palette
F1
or
Cmd+Shift+P
Select parent control
Ctrl+Click
Move control up
Shift+Left Arrow
Move control down
Shift+Right Arrow

操作快捷键
命令面板
F1
Cmd+Shift+P
选择父控件
Ctrl+Click
向上移动控件
Shift+Left Arrow
向下移动控件
Shift+Right Arrow

Security Recommendations

安全建议

  • BTP-BAS-0001: Limit administrators with full management permissions
  • Use Personal Access Tokens (PATs) for Git authentication
  • Protect connections to external systems
  • Avoid personal data in source files when using Joule AI

  • BTP-BAS-0001:限制拥有完整管理权限的管理员数量
  • 使用个人访问令牌(PAT)进行Git身份验证
  • 保护与外部系统的连接
  • 使用Joule AI时避免在源文件中包含个人数据

Reference Files

参考文件

  • references/dev-space-types.md
    - Detailed dev space extensions and capabilities
  • references/connectivity-guide.md
    - Complete connectivity troubleshooting
  • references/service-plans.md
    - Plan restrictions and metering
  • references/setup-checklist.md
    - Detailed setup procedures
  • references/git-operations.md
    - Git commands, stash, authentication, Gerrit
  • references/development-workflow.md
    - Project creation, UI development, debugging, CI/CD
  • references/service-center-and-tools.md
    - Service providers, extensions, IDE features

  • references/dev-space-types.md
    - 开发空间扩展与功能详情
  • references/connectivity-guide.md
    - 完整连接排查指南
  • references/service-plans.md
    - 服务计划限制与计量
  • references/setup-checklist.md
    - 详细设置步骤
  • references/git-operations.md
    - Git命令、暂存、身份验证、Gerrit
  • references/development-workflow.md
    - 项目创建、UI开发、调试、CI/CD
  • references/service-center-and-tools.md
    - 服务提供商、扩展、IDE功能

Bundled Resources

内置资源

Reference Documentation

参考文档

  • references/connectivity-guide.md
    - Complete connectivity setup guide
  • references/dev-space-types.md
    - All dev space types and use cases
  • references/git-operations.md
    - Git integration and operations
  • references/service-center-and-tools.md
    - Service Center and tool management
  • references/service-plans.md
    - Service plans comparison and selection
  • references/setup-checklist.md
    - Complete setup checklist
  • references/development-workflow.md
    - Development workflow and best practices
  • references/connectivity-guide.md
    - 完整连接设置指南
  • references/dev-space-types.md
    - 所有开发空间类型与使用场景
  • references/git-operations.md
    - Git集成与操作
  • references/service-center-and-tools.md
    - 服务中心与工具管理
  • references/service-plans.md
    - 服务计划对比与选择
  • references/setup-checklist.md
    - 完整设置检查清单
  • references/development-workflow.md
    - 开发工作流与最佳实践

Templates

模板

  • templates/destination-config.md
    - Destination configuration examples
  • templates/dev-space-setup.md
    - Dev space creation checklist

  • templates/destination-config.md
    - 目标配置示例
  • templates/dev-space-setup.md
    - 开发空间创建检查清单

Documentation Links

文档链接