SAP BTP System Management Automation

An Apify Actor that automates starting and stopping SAP BTP systems through the Landscape Portal using Playwright and Python.

🎯 Features

• Automated Login: Handles SAP BTP authentication automatically
• System Management: Start or stop SAP BTP systems programmatically
• Flexible Configuration: Manage different systems with simple configuration changes
• Debug Mode: Run in non-headless mode locally to see browser interactions
• Error Handling: Comprehensive error handling with screenshots for debugging
• Video Recording: Optional video recording of browser sessions for troubleshooting

📋 Prerequisites

• Python 3.8 or higher
• Node.js 14 or higher
• Apify CLI
• macOS, Linux, or Windows

🚀 Quick Start

1. Installation

# Clone the repository
git clone <your-repo-url>
cd sap-btp-automation

# Install Apify CLI globally
npm install -g apify-cli

# Create Python virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install Python dependencies
pip install -r requirements.txt

# Install Playwright browsers
playwright install
playwright install-deps

2. Configuration

Create an input.json file in the project root:

{
  "start_urls": [
    {
      "url": "https://shared-services.us10.landscape-portal.cloud.sap/ui#systemhibernation-manage"
    }
  ],
  "system_to_start": "H01",
  "action": "Start",
  "btp_username": "your-username@company.com",
  "btp_password": "your-password",
  "headless": false
}

3. Run the Actor

# Run with input.json
apify run -p input.json

# Run with defaults (configured in main.py)
apify run

📝 Configuration Options

Input Schema

Parameter	Type	Required	Default	Description
start_urls	Array	Yes	-	Array containing the Landscape Portal URL
system_to_start	String	Yes	"H01"	System ID to manage (e.g., H01, H02, H03)
action	String	No	"Start"	Action to perform: "Start" or "Stop"
btp_username	String	Yes	-	Your SAP BTP username
btp_password	String	Yes	-	Your SAP BTP password
headless	Boolean	No	false	Run browser in headless mode

Example Configurations

Starting a System

{
  "system_to_start": "H01",
  "action": "Start",
  "btp_username": "user@company.com",
  "btp_password": "password"
}

Stopping a System

{
  "system_to_start": "H02",
  "action": "Stop",
  "btp_username": "user@company.com",
  "btp_password": "password"
}

🛠️ Development

Local Development Setup

1. Enable Debug Mode: Set headless: false in your input.json to see the browser
2. Screenshots: Debug screenshots are saved automatically during execution
3. Video Recording: Videos are saved in the ./videos directory when running locally
4. Console Logging: Browser console messages are logged to help with debugging

Project Structure

sap-btp-automation/
├── .actor/
│   └── input_schema.json    # Input schema definition
├── src/
│   └── main.py              # Main automation script
├── storage/
│   ├── datasets/            # Output data storage
│   └── key_value_stores/    # Key-value storage
├── videos/                  # Recorded videos (local only)
├── input.json              # Input configuration
├── requirements.txt        # Python dependencies
├── .gitignore
└── README.md

Debugging Tips

1. Run with Playwright Inspector:

   $npx playwright codegen https://your-