sap-btp-business-application-studio（SAP BTP 业务应用工作室）

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

For extension details: See references/dev-space-types.md

Service Plans

For restrictions: See references/service-plans.md

Connectivity

Required Destination Properties

WebIDEEnabled = true
HTML5.DynamicDestination = true

WebIDEUsage by System Type

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

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

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)