SAP Business Application Studio
Related Skills
- sap-btp-cloud-platform: Use for subaccount, entitlement, subscription, and Cloud Foundry setup
- sap-fiori-tools: Use for Fiori project generation and Fiori-specific BAS workflows
- sap-cap-capire: Use for CAP projects, CDS modeling, and service implementation in BAS
- sap-btp-connectivity: Use for destinations, Cloud Connector, and external-system access
When to Use This Skill
Use this skill when setting up BAS subscriptions, choosing dev space types, connecting BAS to SAP or external systems, configuring Git and runtime versions, deploying MTA projects, using Service Center/Layout Editor, or troubleshooting BAS access and connectivity.
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.
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
Setup Checklist
Prerequisites
- SAP BTP global account
- Subaccount in Cloud Foundry environment
Steps
- Create Subaccount - Select region based on availability
- Configure Entitlements - Add SAP Business Application Studio service plan
- Subscribe - Complete subscription in subaccount
- Assign Roles - Add
Business_Application_Studio_Developer role collection
- Optional: Configure IdP - Set up assertion-based attribute mapping
- Optional: Connect Git - Link to public or corporate repositories
- Optional: Create CF Spaces - At least 1 space per development team
For detailed setup: See references/setup-checklist.md
Dev Space Types
| Type |
Purpose |
Key Extensions |
| SAP Fiori |
Fiori apps (CF, ABAP Cloud, on-prem) |
SAP Fiori Tools, SAPUI5 Layout Editor, MTA Tools |
| Full Stack Cloud Application |
CAP with Node.js/Java + Fiori |
CAP Tools, CDS Graphical Modeler, Java Tools |
| Full-Stack Application Using Productivity Tools |
Low-code development |
Productivity Tools, CAP Tools, Mobile Services |
| SAP HANA Native Application |
Native HANA apps, calculation views |
HANA Tools, Calculation View Editor, SDI Tools |
| SAP Mobile Application |
iOS/Android with MDK |
Mobile Services Tools, HTML5 Runner |
| SAP SME Business Application |
SME apps with Business Application Factory |
SME programming model tools |
| Basic |
Minimal environment |
SAP Basic Tools only |
For extension details: See references/dev-space-types.md
Service Plans
| Plan |
Dev Spaces |
Running |
Storage |
Notes |
| Standard |
10 |
2 |
10 GB |
Production development |
| Free |
2 |
1 |
4 GB |
Community support only, 2 deployments max |
| Trial |
2 |
1 |
4 GB |
1-hour timeout, 30-day inactivity deletion |
| Build-Code |
Varies |
Varies |
Varies |
Requires SAP Build Code subscription |
For restrictions: See references/service-plans.md
Connectivity
Required Destination Properties
WebIDEEnabled = true
HTML5.DynamicDestination = true
WebIDEUsage by System Type
| System Type |
WebIDEUsage Value |
| ABAP System |
odata_abap,dev_abap |
| SAP Cloud for Customer |
odata_c4c |
| Service URL |
odata_gen |
| SAP Business Accelerator Hub |
apihub_sandbox |
Cloud Connector Requirements (On-Premise)
- Virtual URL in Cloud Connector must match destination URL (host:port only)
- Protocol must be HTTP
- 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
Build & Deploy
Prerequisites
- Log into Cloud Foundry account
- For HANA apps: Add "SAP HANA Cloud, SAP HANA Schemas & HDI Containers" entitlement
- For Trial/Free: Add "SAP Build Work Zone, standard edition" + Launchpad_Admin role
MTA Deployment
# Build MTA archive
mbt build
# Deploy to Cloud Foundry
cf deploy mta_archives/<app>.mtar
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
Roles & Authorization
| Role |
Purpose |
| Developer |
Business_Application_Studio_Developer - Application development |
| Administrator |
Export/delete user data, restart dev spaces |
| Extension Deployer |
Create and deploy custom extensions |
Assign via: SAP BTP Cockpit → Security → Role Collections
Common Issues
Dev Space Stuck in STARTING
- Wait 5 minutes
- If persists, start new dev space and restore via Git
- Contact support with workspace ID (ws-id)
Connectivity Failures
- Verify destination in BTP Cockpit (WebIDEEnabled, HTML5.DynamicDestination)
- Check Cloud Connector configuration
- Run in terminal:
curl localhost:8887/reload then curl $H2O_URL/api/listDestinations -o dests.json
Storage/Inode Issues
df -ih # Check inodes
df -h # Check disk space
Remove cache folders and unnecessary files.
HANA Connection Issues
Configure SAP HANA Cloud to allow BAS IP addresses. See Availability for region IPs.
Keyboard Shortcuts
| Action |
Shortcut |
| Command Palette |
F1 or Cmd+Shift+P |
| Select parent control |
Ctrl+Click |
| Move control up |
Shift+Left Arrow |
| Move control down |
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
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
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
Templates
templates/destination-config.md - Destination configuration examples
templates/dev-space-setup.md - Dev space creation checklist
Documentation Links
Last Verified: 2025-11-27
Source: SAP-docs/sap-btp-business-application-studio (145+ docs)
1---2name: sap-btp-business-application-studio3description: This skill provides comprehensive guidance for SAP Business Application Studio (BAS), the cloud-based IDE on SAP BTP built on Code-OSS. Use when setting up BAS subscriptions, creating dev spaces, connecting to external systems, deploying MTA applications, troubleshooting connectivity issues, managing Git repositories, configuring runtime versions, or using the layout editor. Keywords: SAP Business Application Studio, BAS, SAP BTP, dev space, Cloud Foundry, MTA, multitarget application, SAP Fiori, CAP, HANA, destination, WebIDEEnabled, Cloud Connector, Service Center, Storyboard, Layout Editor, ABAP, OData, subscription, entitlements, role collection, Business_Application_Studio_Developer, Git, clone, push, pull, Gerrit, PAT, OAuth, asdf, runtime, Node.js, Java, Python, Task Explorer, CI/CD, Yeoman, generator, template wizard, mbt, mtar, debugging, breakpoint4license: GPL-3.05---6
7# SAP Business Application Studio
8
9## Related Skills
10
11- **sap-btp-cloud-platform**: Use for subaccount, entitlement, subscription, and Cloud Foundry setup
12- **sap-fiori-tools**: Use for Fiori project generation and Fiori-specific BAS workflows
13- **sap-cap-capire**: Use for CAP projects, CDS modeling, and service implementation in BAS
14- **sap-btp-connectivity**: Use for destinations, Cloud Connector, and external-system access
15
16## When to Use This Skill
17
18Use this skill when setting up BAS subscriptions, choosing dev space types, connecting BAS to SAP or external systems, configuring Git and runtime versions, deploying MTA projects, using Service Center/Layout Editor, or troubleshooting BAS access and connectivity.
19
20## Table of Contents
21- [Overview](#overview)
22- [Quick Decision Tree](#quick-decision-tree)
23- [Setup Checklist](#setup-checklist)
24- [Dev Space Types](#dev-space-types)
25- [Service Plans](#service-plans)
26- [Connectivity](#connectivity)
27- [Build & Deploy](#build--deploy)
28- [Roles & Authorization](#roles--authorization)
29- [Common Issues](#common-issues)
30- [Keyboard Shortcuts](#keyboard-shortcuts)
31- [Security Recommendations](#security-recommendations)
32- [Reference Files](#reference-files)
33- [Templates](#templates)
34- [Bundled Resources](#bundled-resources)
35- [Documentation Links](#documentation-links)
36
37## Overview
38
39SAP 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.
40
41**Architecture**: Multi-cloud SaaS (AWS, Azure, GCP) with isolated dev spaces functioning as Developer Virtual Appliances.
42
43## Quick Decision Tree
44
45**Setting up BAS?** → See [Setup Checklist](#setup-checklist)
46**Creating a dev space?** → See [Dev Space Types](#dev-space-types)
47**Connecting to external systems?** → See [Connectivity](#connectivity)
48**Deploying applications?** → See [Build & Deploy](#build--deploy)
49**Working with Git?** → See `references/git-operations.md`
50**Project creation/development?** → See `references/development-workflow.md`
51**Service Center/Extensions?** → See `references/service-center-and-tools.md`
52**Troubleshooting?** → See `references/connectivity-guide.md`
53
54---
55
56## Setup Checklist
57
58### Prerequisites
59- SAP BTP global account
60- Subaccount in Cloud Foundry environment
61
62### Steps
63
641. **Create Subaccount** - Select region based on [availability](https://help.sap.com/docs/bas/sap-business-application-studio/sap-business-application-studio-availability)
652. **Configure Entitlements** - Add SAP Business Application Studio service plan
663. **Subscribe** - Complete subscription in subaccount
674. **Assign Roles** - Add `Business_Application_Studio_Developer` role collection
685. **Optional: Configure IdP** - Set up assertion-based attribute mapping
696. **Optional: Connect Git** - Link to public or corporate repositories
707. **Optional: Create CF Spaces** - At least 1 space per development team
71
72For detailed setup: See `references/setup-checklist.md`
73
74---
75
76## Dev Space Types
77
78| Type | Purpose | Key Extensions |
79|------|---------|----------------|
80| **SAP Fiori** | Fiori apps (CF, ABAP Cloud, on-prem) | SAP Fiori Tools, SAPUI5 Layout Editor, MTA Tools |
81| **Full Stack Cloud Application** | CAP with Node.js/Java + Fiori | CAP Tools, CDS Graphical Modeler, Java Tools |
82| **Full-Stack Application Using Productivity Tools** | Low-code development | Productivity Tools, CAP Tools, Mobile Services |
83| **SAP HANA Native Application** | Native HANA apps, calculation views | HANA Tools, Calculation View Editor, SDI Tools |
84| **SAP Mobile Application** | iOS/Android with MDK | Mobile Services Tools, HTML5 Runner |
85| **SAP SME Business Application** | SME apps with Business Application Factory | SME programming model tools |
86| **Basic** | Minimal environment | SAP Basic Tools only |
87
88For extension details: See `references/dev-space-types.md`
89
90---
91
92## Service Plans
93
94| Plan | Dev Spaces | Running | Storage | Notes |
95|------|------------|---------|---------|-------|
96| **Standard** | 10 | 2 | 10 GB | Production development |
97| **Free** | 2 | 1 | 4 GB | Community support only, 2 deployments max |
98| **Trial** | 2 | 1 | 4 GB | 1-hour timeout, 30-day inactivity deletion |
99| **Build-Code** | Varies | Varies | Varies | Requires SAP Build Code subscription |
100
101For restrictions: See `references/service-plans.md`
102
103---
104
105## Connectivity
106
107### Required Destination Properties
108
109```
110WebIDEEnabled = true
111HTML5.DynamicDestination = true
112```
113
114### WebIDEUsage by System Type
115
116| System Type | WebIDEUsage Value |
117|-------------|-------------------|
118| ABAP System | `odata_abap,dev_abap` |
119| SAP Cloud for Customer | `odata_c4c` |
120| Service URL | `odata_gen` |
121| SAP Business Accelerator Hub | `apihub_sandbox` |
122
123### Cloud Connector Requirements (On-Premise)
124
1251. Virtual URL in Cloud Connector must match destination URL (host:port only)
1262. Protocol must be HTTP
1273. Grant access to required paths:
128 - `/sap/opu/odata/` (OData services)
129 - `/sap/bc/ui5_ui5/` (UI5 resources)
130 - `/sap/bc/adt/` (ABAP Development Tools)
131 - `/sap/bc/ui2/app_index/` (App index)
132
133For troubleshooting: See `references/connectivity-guide.md`
134
135---
136
137## Build & Deploy
138
139### Prerequisites
140
1411. Log into Cloud Foundry account
1422. For HANA apps: Add "SAP HANA Cloud, SAP HANA Schemas & HDI Containers" entitlement
1433. For Trial/Free: Add "SAP Build Work Zone, standard edition" + Launchpad_Admin role
144
145### MTA Deployment
146
147```bash
148# Build MTA archive
149mbt build
150
151# Deploy to Cloud Foundry
152cf deploy mta_archives/<app>.mtar
153```
154
155### Key Tools
156
157- **MTA Editor**: Visual editing of `mta.yaml`
158- **Cloud Foundry CLI**: `cf` commands for deployment
159- **Cloud MTA Build Tool**: Generates `.mtar` files
160- **Task Explorer**: Execute build/deploy tasks
161
162---
163
164## Roles & Authorization
165
166| Role | Purpose |
167|------|---------|
168| **Developer** | `Business_Application_Studio_Developer` - Application development |
169| **Administrator** | Export/delete user data, restart dev spaces |
170| **Extension Deployer** | Create and deploy custom extensions |
171
172Assign via: SAP BTP Cockpit → Security → Role Collections
173
174---
175
176## Common Issues
177
178### Dev Space Stuck in STARTING
1791. Wait 5 minutes
1802. If persists, start new dev space and restore via Git
1813. Contact support with workspace ID (ws-id)
182
183### Connectivity Failures
1841. Verify destination in BTP Cockpit (WebIDEEnabled, HTML5.DynamicDestination)
1852. Check Cloud Connector configuration
1863. Run in terminal: `curl localhost:8887/reload` then `curl $H2O_URL/api/listDestinations -o dests.json`
187
188### Storage/Inode Issues
189```bash
190df -ih # Check inodes
191df -h # Check disk space
192```
193Remove cache folders and unnecessary files.
194
195### HANA Connection Issues
196Configure SAP HANA Cloud to allow BAS IP addresses. See [Availability](https://help.sap.com/docs/bas/sap-business-application-studio/sap-business-application-studio-availability) for region IPs.
197
198---
199
200## Keyboard Shortcuts
201
202| Action | Shortcut |
203|--------|----------|
204| Command Palette | `F1` or `Cmd+Shift+P` |
205| Select parent control | `Ctrl+Click` |
206| Move control up | `Shift+Left Arrow` |
207| Move control down | `Shift+Right Arrow` |
208
209---
210
211## Security Recommendations
212
213- **BTP-BAS-0001**: Limit administrators with full management permissions
214- Use Personal Access Tokens (PATs) for Git authentication
215- Protect connections to external systems
216- Avoid personal data in source files when using Joule AI
217
218---
219
220## Reference Files
221
222- `references/dev-space-types.md` - Detailed dev space extensions and capabilities
223- `references/connectivity-guide.md` - Complete connectivity troubleshooting
224- `references/service-plans.md` - Plan restrictions and metering
225- `references/setup-checklist.md` - Detailed setup procedures
226- `references/git-operations.md` - Git commands, stash, authentication, Gerrit
227- `references/development-workflow.md` - Project creation, UI development, debugging, CI/CD
228- `references/service-center-and-tools.md` - Service providers, extensions, IDE features
229
230---
231
232## Bundled Resources
233
234### Reference Documentation
235- `references/connectivity-guide.md` - Complete connectivity setup guide
236- `references/dev-space-types.md` - All dev space types and use cases
237- `references/git-operations.md` - Git integration and operations
238- `references/service-center-and-tools.md` - Service Center and tool management
239- `references/service-plans.md` - Service plans comparison and selection
240- `references/setup-checklist.md` - Complete setup checklist
241- `references/development-workflow.md` - Development workflow and best practices
242
243### Templates
244- `templates/destination-config.md` - Destination configuration examples
245- `templates/dev-space-setup.md` - Dev space creation checklist
246
247---
248
249## Documentation Links
250
251| Resource | URL |
252|----------|-----|
253| SAP Help Portal | [https://help.sap.com/docs/bas](https://help.sap.com/docs/bas) |
254| GitHub Docs Source | [https://github.com/SAP-docs/sap-btp-business-application-studio](https://github.com/SAP-docs/sap-btp-business-application-studio) |
255| Discovery Center | [https://discovery-center.cloud.sap/serviceCatalog/business-application-studio](https://discovery-center.cloud.sap/serviceCatalog/business-application-studio) |
256| Availability/IPs | [https://help.sap.com/docs/bas/sap-business-application-studio/sap-business-application-studio-availability](https://help.sap.com/docs/bas/sap-business-application-studio/sap-business-application-studio-availability) |
257
258---
259
260**Last Verified**: 2025-11-27
261**Source**: SAP-docs/sap-btp-business-application-studio (145+ docs)