8.2 KiB
8.2 KiB
Setup Checklist - Complete Reference
Table of Contents
- Overview
- Prerequisites
- Setup Steps
- Role Assignment
- Optional Configurations
- Build & Deploy Prerequisites
- Verification
- Documentation Links
Overview
This checklist covers setting up SAP Business Application Studio for development.
Important Notes:
- SAP Build Code users: Follow SAP Build Code Initial Setup instead
- Trial account users: Refer to Getting Started with a Trial Account
Prerequisites
Required
| Requirement | Description |
|---|---|
| SAP BTP Global Account | Active global account access |
| Cloud Foundry Environment | Subaccount must use CF environment |
| Administrator Access | Subaccount administrator privileges |
| Supported Browser | Mozilla Firefox, Google Chrome, or Microsoft Edge (latest versions) |
Recommended
| Requirement | Description |
|---|---|
| Identity Provider | SAML 2.0 compliant IdP for custom authentication |
| Git Repository | Public or corporate Git for version control |
| Cloud Foundry Space | At least 1 space per development team |
Setup Steps
Step 1: Create a Subaccount
- Log into SAP BTP Cockpit
- Navigate to your global account
- Create new subaccount with Cloud Foundry environment
- Select region based on BAS availability
Region Recommendation: Choose data center closest to your physical location for best performance.
Step 2: Configure Entitlements
- In global account, go to Entitlements
- Click Configure Entitlements → Add Service Plans
- Search for "SAP Business Application Studio"
- Select appropriate service plan:
standard- Productive developmentfree- Evaluation (no SLA)build-code- AI-based development (requires Build Code)
- Save changes
Step 3: Subscribe to the Service
- Navigate to your subaccount
- Go to Instances and Subscriptions
- Click Create
- Search for "SAP Business Application Studio"
- Select plan and create subscription
Step 4: Assign Roles
- Navigate to Security → Role Collections
- Select
Business_Application_Studio_Developer - Click Edit
- Add user(s) by email address
- Select Identity Provider
- Save
For Administrators: Also assign administrator role collection.
Role Assignment
Available Roles
| Role Collection | Purpose | Capabilities |
|---|---|---|
Business_Application_Studio_Developer |
Development access | Create/manage dev spaces, develop applications |
Business_Application_Studio_Administrator |
Administration | Export/delete user data, restart dev spaces |
Business_Application_Studio_Extension_Deployer |
Extension deployment | Create and deploy custom extensions |
Assignment Process
- Navigate to Security → Role Collections in SAP BTP Cockpit
- Select or create role collection
- Click Edit
- Enter user email address
- Select Identity Provider (e.g., SAP ID Service, custom IdP)
- Save changes
Note: Users needing both development and administration require both role collections assigned.
China (Shanghai) Region
Create new role collections before assigning permissions (pre-built collections not available).
Optional Configurations
Step 5: Configure Identity Provider (Optional)
For custom IdP with assertion-based attribute mapping:
- Navigate to Security → Trust Configuration
- Add trusted identity provider
- Configure attribute mappings
- Test authentication flow
Step 6: Connect Git Repositories (Optional)
Public Repositories:
- No additional configuration needed
- Clone directly from dev space
Corporate Repositories:
- Administrator configures destination to corporate Git
- Set up authentication (Personal Access Tokens recommended)
- Configure Cloud Connector if on-premise
Authentication Recommendation: Use Personal Access Tokens (PATs) instead of passwords, refresh regularly.
Step 7: Create Cloud Foundry Spaces (Optional)
- Navigate to Cloud Foundry → Spaces in subaccount
- Create new space
- Recommendation: At least 1 space per development team working on same project
Step 8: Assign Team Members (Optional)
Enable developer access to Cloud Foundry:
- Navigate to Cloud Foundry → Space Members
- Add developers with appropriate roles:
- Space Developer
- Space Manager (for team leads)
Build & Deploy Prerequisites
General Requirements
- Log into Cloud Foundry account from dev space
SAP HANA Cloud Applications
| Requirement | Action |
|---|---|
| Entitlement | Add "SAP HANA Cloud, SAP HANA Schemas & HDI Containers" |
| Database | Create SAP HANA Cloud instance via HANA Cloud Central |
| Admin Tools | Subscribe to SAP HANA Cloud Administration Tools |
Trial Account Special: In database wizard, select "Allow all IP addresses" in Advanced Settings.
Trial/Free Plan Requirements
| Requirement | Action |
|---|---|
| Work Zone | Add "SAP Build Work Zone, standard edition" entitlement and subscribe |
| Role | Assign Launchpad_Admin role collection |
| CF Runtime | Add Cloud Foundry Runtime entitlements (adjustable based on needs) |
Verification
Test Access
- Open SAP Business Application Studio URL
- Authenticate with assigned identity
- Verify Dev Space Manager loads
- Create test dev space
Test Development
- Create dev space with appropriate type
- Start dev space
- Verify tools and extensions load
- Test Git connectivity (if configured)
Test Deployment (Optional)
- Create simple project from template
- Build project
- Log into Cloud Foundry
- Deploy to CF space
- Verify application runs
Quick Reference
URLs
| Resource | Pattern |
|---|---|
| BAS Access | [https://<subaccount>.eu10.applicationstudio.cloud.sap](https://.eu10.applicationstudio.cloud.sap`) (varies by region) |
| BTP Cockpit | [https://cockpit.btp.cloud.sap](https://cockpit.btp.cloud.sap`) |
| Discovery Center | [https://discovery-center.cloud.sap/serviceCatalog/business-application-studio](https://discovery-center.cloud.sap/serviceCatalog/business-application-studio`) |
Key Commands
# Cloud Foundry Login
cf login -a <api-endpoint>
# Check CF Target
cf target
# List Services
cf services
Documentation Links
Last Updated: 2025-11-22 Source: https://github.com/SAP-docs/sap-btp-business-application-studio/tree/main/docs