sap-btp-business-application-studio
SAP Business Application Studio
Table of Contents
- Overview
- Quick Decision Tree
- Setup Checklist
- Dev Space Types
- Service Plans
- Connectivity
- Build & Deploy
- Roles & Authorization
- Common Issues
- Keyboard Shortcuts
- Security Recommendations
- Reference Files
- Templates
- Bundled Resources
- Documentation Links
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_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
| 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:
cfcommands for deployment - Cloud MTA Build Tool: Generates
.mtarfiles - 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/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
| 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 capabilitiesreferences/connectivity-guide.md- Complete connectivity troubleshootingreferences/service-plans.md- Plan restrictions and meteringreferences/setup-checklist.md- Detailed setup proceduresreferences/git-operations.md- Git commands, stash, authentication, Gerritreferences/development-workflow.md- Project creation, UI development, debugging, CI/CDreferences/service-center-and-tools.md- Service providers, extensions, IDE features
Bundled Resources
Reference Documentation
references/connectivity-guide.md- Complete connectivity setup guidereferences/dev-space-types.md- All dev space types and use casesreferences/git-operations.md- Git integration and operationsreferences/service-center-and-tools.md- Service Center and tool managementreferences/service-plans.md- Service plans comparison and selectionreferences/setup-checklist.md- Complete setup checklistreferences/development-workflow.md- Development workflow and best practices
Templates
templates/destination-config.md- Destination configuration examplestemplates/dev-space-setup.md- Dev space creation checklist
Documentation Links
| Resource | URL |
|---|---|
| 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)