secondsky/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)