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_Developerrole 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
| 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
| 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
| 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:
cfcommands for deployment -
Cloud MTA Build Tool: Generates
.mtarfiles -
Task Explorer: Execute build/deploy tasks
Roles & Authorization
| 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/reloadthencurl $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
| 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
| SAP Help Portal | https://help.sap.com/docs/bas
| GitHub Docs Source | https://github.com/SAP-docs/sap-btp-business-application-studio
| Discovery Center | https://discovery-center.cloud.sap/serviceCatalog/business-application-studio
| Availability/IPs | https://help.sap.com/docs/bas/sap-business-application-studio/sap-business-application-studio-availability
Last Verified: 2025-11-27 Source: SAP-docs/sap-btp-business-application-studio (145+ docs)