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

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

---

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)

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

---

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

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

1. Wait 5 minutes
2. If persists, start new dev space and restore via Git
3. Contact support with workspace 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

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

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)