| name | sap-btp-business-application-studio |
| description | | Use when this capability is needed. |
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.
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
mbt build
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
df -h
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)
Converted and distributed by TomeVault — claim your Tome and manage your conversions.