Agent skill

sap-btp-developer-guide

Develops business applications on SAP Business Technology Platform (BTP) using CAP (Node.js/Java) or ABAP Cloud. Use when: building cloud applications on SAP BTP, deploying to Cloud Foundry or Kyma runtimes, integrating with SAP HANA Cloud, implementing SAP Fiori UIs, connecting to remote SAP systems, building multitenant SaaS applications, extending SAP S/4HANA or SuccessFactors, setting up CI/CD pipelines, implementing observability, or following SAP development best practices. Keywords: SAP BTP, Business Technology Platform, CAP, Cloud Application Programming Model, ABAP Cloud, Cloud Foundry, Kyma, SAP HANA Cloud, SAP Fiori, SAPUI5, CI/CD, observability, multitenant, SaaS, SAP BTP ABAP environment, SAP Business Application Studio, SAP Cloud SDK, SAP Integration Suite, SAP Event Mesh, SAP Connectivity Service, SAP Destination Service, XSUAA, OAuth, OpenID Connect, OData, CDS, Core Data Services, ABAP CDS, ABAP RESTful Application Programming Model, RAP, ABAP development, SAP BTP development

Stars 204
Forks 51

Install this agent skill to your Project

npx add-skill https://github.com/secondsky/sap-skills/tree/main/plugins/sap-btp-developer-guide/skills/sap-btp-developer-guide

Metadata

Additional technical details for this skill

version
1.1.0
last verified
1764201600
review status
Complete - Phase 1-14 audit
source last updated
1763683200

SKILL.md

SAP BTP Developer Guide Skill

Related Skills

  • sap-btp-cloud-platform: Use for platform fundamentals, account management, and runtime configurations
  • sap-btp-best-practices: Use for architectural guidance, governance models, and production patterns
  • sap-cap-capire: Use for CAP development details, service definitions, and database integration
  • sap-fiori-tools: Use for UI development, Fiori application setup, and frontend deployment
  • sap-abap: Use for ABAP Cloud development, RAP patterns, and ABAP Environment specifics
  • sap-btp-connectivity: Use for implementing secure connections to on-premise systems

Comprehensive guidance for developing, deploying, and operating business applications on SAP Business Technology Platform.

Table of Contents

Quick Navigation

  • Table of Contents
  • When to Use This Skill
  • Runtime and Programming Model Selection
  • Development Workflow
  • Key Services and Tools
  • Security Implementation
  • Connectivity Patterns
  • CI/CD Implementation
  • Observability Implementation
  • Tutorials and Missions
  • Partner/ISV Development
  • Common Errors and Solutions
  • Bundled Resources
  • Quick Reference Links
  • Version Information

When to Use This Skill

Use when:

  • Building new applications on SAP BTP (Cloud Foundry or Kyma runtime)
  • Developing with SAP Cloud Application Programming Model (CAP)
  • Building ABAP Cloud applications in SAP BTP ABAP Environment
  • Deploying SAP Fiori or SAPUI5 user interfaces
  • Connecting applications to SAP S/4HANA, SuccessFactors, or on-premise systems
  • Building multitenant SaaS applications
  • Implementing side-by-side extensions for SAP solutions
  • Setting up CI/CD pipelines for SAP BTP
  • Implementing observability with SAP Cloud ALM or SAP Cloud Logging
  • Using SAP HANA Cloud for data persistence

Runtime and Programming Model Selection

For detailed runtime comparison: See references/runtimes.md

Decision Matrix

Criteria CAP (Cloud Foundry/Kyma) ABAP Cloud
Languages Node.js, Java, TypeScript ABAP
Best For New cloud-native apps, extensions Organizations with ABAP expertise
Runtime Cloud Foundry or Kyma SAP BTP ABAP Environment
Persistence SAP HANA Cloud, PostgreSQL SAP HANA Cloud (ABAP-managed)
UI Framework SAP Fiori Elements, SAPUI5 SAP Fiori Elements, SAPUI5
IDE SAP Business Application Studio, VS Code ABAP Development Tools (Eclipse)

CAP Application Development

CAP provides three operational profiles:

  • Development: Mock services, minimal setup, SQLite/H2 for local testing
  • Hybrid: Local app connected to cloud services
  • Production: Full cloud deployment with SAP HANA Cloud

Key capabilities:

  • Domain-driven design with CDS (Core Data Services)
  • Built-in multitenancy support
  • Automatic OData/REST service generation
  • Platform-agnostic design (no vendor lock-in)

For CAP details: See references/cap-development.md

ABAP Cloud Development

ABAP Cloud uses four foundational technologies:

  1. Core Data Services (CDS) - Data modeling and analytics
  2. ABAP RESTful Application Programming Model (RAP) - Service-oriented development
  3. Restricted ABAP Language - Cloud-safe API access
  4. Released Public APIs - Upgrade-stable extensions

For ABAP details: See references/abap-cloud.md

Development Workflow

Phase 1: Explore and Discover

  1. Identify business problem - Conduct stakeholder interviews
  2. Understand user needs - Visit customers, observe workflows
  3. Define security requirements - Threat modeling, compliance planning (GDPR, HIPAA)
  4. Establish governance - Set up organizational structure

Phase 2: Design

  1. User Experience Design

    • Follow SAP Fiori Design Guidelines
    • Implement accessibility (WCAG 2.2)
    • Use design thinking methodology
  2. Technology Design

    • Apply Domain-Driven Design for complex applications (30+ use cases)
    • Define module boundaries and communication patterns
    • Plan microservices architecture if needed
  3. Security in Design

    • Secure user interfaces with SAP Fiori authentication
    • Implement RBAC/ABAC using OAuth/OpenID Connect
    • Validate CDS models for data protection

For design patterns: See references/design-patterns.md

Phase 3: Develop

CAP Development:

bash
# Initialize CAP project
cds init my-project
cd my-project

# Add SAP HANA support
cds add hana

# Add authentication
cds add xsuaa

# Run locally
cds watch

Key development tools:

  • SAP Business Application Studio (primary IDE)
  • SAP Cloud SDK (OData/OpenAPI clients)
  • MTA Build Tool (packaging)

Coding standards:

  • Follow SAPUI5 Guidelines and SAP Fiori Design Guidelines
  • Establish naming conventions
  • Implement parameterized queries (prevent SQL injection)
  • Use CDS constraints for input validation

For tools catalog: See references/tools.md

Phase 4: Deploy

Cloud Foundry Deployment:

bash
# Build MTA archive
mbt build

# Deploy to Cloud Foundry
cf deploy mta_archives/my-project_1.0.0.mtar

Kyma Deployment:

bash
# Use Helm charts or Terraform
terraform init
terraform apply

ABAP Deployment:

  • Use Manage Software Components app (gCTS)
  • Transport via Landscape Portal
  • Partner options: Multitenant SaaS or Add-on Product

For deployment details: See references/deployment.md

Phase 5: Run and Scale

Monitoring:

  • SAP Cloud ALM (central observability)
  • SAP Cloud Logging (detailed logs, metrics, traces)
  • ABAP Technical Monitoring Cockpit

Scaling:

  • Cloud Foundry: Automatic instance distribution across AZs
  • Kyma: Kubernetes-native scaling
  • ABAP: Elastic scaling with ACUs (0.5 ACU increments)

Cost optimization:

  • System hibernation (ABAP) - reduce to <5% operational cost
  • SAP HANA Cloud Native Storage Extension
  • Elastic Compute Nodes for peak workloads

For operations: See references/operations.md

Key Services and Tools

Platform Services

Service Purpose
SAP HANA Cloud Database-as-a-Service, multi-model
SAP Connectivity Service On-premise/VPC connections via Cloud Connector
SAP Destination Service Routing, authentication management
SAP Event Mesh Event distribution between applications
SAP Integration Suite API Management, Cloud Integration

Development Tools

Tool Purpose
SAP Business Application Studio Primary cloud IDE
SAP Build Low-code/no-code development
Cloud Foundry CLI CF deployment and management
kubectl/Helm Kyma/Kubernetes management
Terraform Provider for SAP BTP Infrastructure as code

For architecture details: See references/architecture.md

Security Implementation

CAP Security Features

  • Parameterized queries (SQL injection prevention)
  • CSRF protection for UI applications
  • Built-in authentication/authorization frameworks
  • SAP Credential Store for secrets management

Security Guidelines

  1. Secure environment configuration - Restrict network access
  2. Security testing - Penetration testing before go-live
  3. Secure deployment pipelines - Code scanning, dependency validation
  4. Secrets management - Use SAP Credential Store

For security details: See references/security.md

Connectivity Patterns

Cloud-to-On-Premise

  • SAP Connectivity Service + Cloud Connector
  • User propagation supported
  • Protocols: HTTP, RFC, LDAP, FTP

Cloud-to-Cloud

  • SAP Destination Service for routing
  • OAuth token management
  • SAP Transparent Proxy for Kubernetes

For connectivity details: See references/connectivity.md

CI/CD Implementation

SAP Continuous Integration and Delivery provides pre-configured pipelines:

  • Cloud Foundry Environment jobs (SAP Fiori, CAP)
  • SAP Fiori for ABAP Platform jobs
  • SAP Integration Suite Artifacts jobs

Setup steps:

  1. Enable in SAP BTP cockpit
  2. Assign Administrator/Developer roles
  3. Configure repository credentials (GitHub, GitLab, Bitbucket, Azure Repos)
  4. Add repositories and create jobs
  5. Configure webhooks for automated builds

For CI/CD details: See references/cicd.md

Observability Implementation

Central Layer (SAP Cloud ALM)

  • Real User Monitoring
  • Health Monitoring
  • Integration and Exception Monitoring
  • Synthetic User Monitoring

Local Layer (SAP Cloud Logging)

  • Log Analytics (OpenSearch-based)
  • Distributed tracing
  • Custom dashboards and alerting

OpenTelemetry is the industry standard for instrumentation.

For observability details: See references/observability.md

Tutorials and Missions

CAP Learning Path

  1. Starter Mission: Full-Stack CAP Application
  2. Extension Mission: Side-by-Side CAP-Based Extensions
  3. Enterprise Mission: Change Tracking, Audit Logging, Attachments
  4. Multitenant Mission: SaaS Application Development
  5. Observability Mission: SAP Cloud Logging Integration

ABAP Learning Path

  1. RAP100 Basics: Fiori apps, OData services, business logic
  2. RAP100 Intermediate: Actions, dynamic feature control, unit testing
  3. RAP120: AI-assisted development with SAP Joule
  4. Analytics: CDS views with SAP Analytics Cloud

Sample applications:

  • Incident Management (CAP)
  • Flight Reference Scenario (ABAP)
  • Poetry Slam Manager (Partner SaaS)

For tutorial details: See references/tutorials.md

Bundled Resources

File Structure

sap-btp-developer-guide/
├── SKILL.md                 # This file - Main guidance
├── README.md               # Quick reference with auto-trigger keywords
└── references/             # Detailed guides (22 files)
    ├── Architecture & Setup
    │   ├── architecture.md      # Platform services and architecture
    │   ├── runtimes.md          # Runtime comparison (CF vs Kyma vs ABAP)
    │   ├── setup.md             # BTP landscape setup and Terraform
    │   └── tools.md             # Development tools catalog
    ├── Development
    │   ├── cap-development.md   # CAP development guide
    │   ├── abap-cloud.md        # ABAP Cloud development guide
    │   ├── design-patterns.md   # Design patterns and DDD
    │   ├── extensions.md        # SAP solution extensions
    │   ├── mta.md               # Multitarget applications
    │   ├── testing.md           # Testing strategies
    │   └── ux-design.md         # UX design and Fiori
    ├── Integration & Security
    │   ├── connectivity.md      # Connectivity patterns
    │   ├── security.md          # Security implementation
    │   ├── hana-cloud.md        # SAP HANA Cloud
    │   └── resilience.md        # Resilience patterns
    ├── Deployment & Operations
    │   ├── deployment.md        # Deployment options
    │   ├── cicd.md              # CI/CD pipelines
    │   ├── observability.md     # Monitoring and logging
    │   ├── operations.md        # Operations and scaling
    │   └── partners.md          # ISV/Partner development
    └── Additional Resources
        ├── tutorials.md         # Learning paths and missions
        └── whats-new.md         # Changelog and updates

Reference Files by Category

Architecture & Platform (4 files)

  • architecture.md - Platform services overview and architecture patterns
  • runtimes.md - Runtime comparison and selection guide
  • setup.md - BTP landscape setup with sizing recommendations
  • tools.md - Complete development tools catalog

Development (8 files)

  • cap-development.md - CAP development with Node.js/Java
  • abap-cloud.md - ABAP Cloud development with RAP
  • design-patterns.md - Domain-driven design and patterns
  • extensions.md - Side-by-side extensions for SAP solutions
  • mta.md - Multitarget application packaging
  • testing.md - Testing strategies and frameworks
  • ux-design.md - SAP Fiori UX design guidelines

Integration & Security (4 files)

  • connectivity.md - Cloud-to-on-premise connectivity
  • security.md - Authentication, authorization, and security
  • hana-cloud.md - SAP HANA Cloud database
  • resilience.md - Application resilience patterns

Deployment & Operations (5 files)

  • deployment.md - Deployment to CF, Kyma, and ABAP
  • cicd.md - CI/CD pipelines with SAP tools
  • observability.md - Monitoring, logging, and tracing
  • operations.md - Operations, scaling, and cost optimization
  • partners.md - ISV/partner development guidelines

Learning & Updates (2 files)

  • tutorials.md - Hands-on missions and tutorials
  • whats-new.md - Latest features and changelog

Partner/ISV Development

Deployment Options

  1. Multitenant SaaS - Cloud service operated in partner's global account
  2. Add-on Product - Installed in customer's ABAP environment

Requirements

  • SAP PartnerEdge Build contract
  • Registered ABAP namespace (mandatory)
  • Landscape Portal for lifecycle management

For partner details: See references/partners.md

Quick Reference Links

Official Documentation:

Design Resources:

Learning:

Source Documentation:

Common Errors and Solutions

Error Cause Solution
Third-party cookie issues Browser deprecation See SAP Note 3409306
XSUAA binding failures Missing service instance Run cf create-service xsuaa application
HANA deployment errors Wrong target container Check requires in mta.yaml
ATC Priority 1 findings Non-cloud-compliant code Use ABAP_CLOUD_DEVELOPMENT_DEFAULT variant

Version Information

Expand your agent's capabilities with these related and highly-rated skills.

secondsky/sap-skills

sap-cap-capire

SAP Cloud Application Programming Model (CAP) development skill using Capire documentation. Use when: building CAP applications, defining CDS models, implementing services, working with SAP HANA/SQLite/PostgreSQL databases, deploying to SAP BTP Cloud Foundry or Kyma, implementing Fiori UIs, handling authorization, multitenancy, or messaging. Covers CDL/CQL/CSN syntax, Node.js and Java runtimes, event handlers, OData services, and CAP plugins.

204 51
Explore
secondsky/sap-skills

sap-btp-cloud-platform

204 51
Explore
secondsky/sap-skills

sap-btp-service-manager

This skill provides comprehensive knowledge for SAP Service Manager on SAP Business Technology Platform (BTP). It should be used when managing service instances, bindings, brokers, and platforms across Cloud Foundry, Kyma, Kubernetes, and other environments. Use when provisioning services via SMCTL CLI, BTP CLI, or REST APIs, configuring OAuth2 authentication, working with the SAP BTP Service Operator in Kubernetes, troubleshooting service consumption issues, or implementing cross-environment service management. Keywords: SAP Service Manager, BTP, service instances, service bindings, SMCTL, service broker, OSBAPI, Cloud Foundry, Kyma, Kubernetes, service-manager, service-operator-access, subaccount-admin, OAuth2, X.509, service marketplace, service plans, rate limiting, cf create-service, btp create services/instance, ServiceInstance CRD, ServiceBinding CRD

204 51
Explore
secondsky/sap-skills

sap-btp-business-application-studio

This skill provides comprehensive guidance for SAP Business Application Studio (BAS), the cloud-based IDE on SAP BTP built on Code-OSS. Use when setting up BAS subscriptions, creating dev spaces, connecting to external systems, deploying MTA applications, troubleshooting connectivity issues, managing Git repositories, configuring runtime versions, or using the layout editor. Keywords: SAP Business Application Studio, BAS, SAP BTP, dev space, Cloud Foundry, MTA, multitarget application, SAP Fiori, CAP, HANA, destination, WebIDEEnabled, Cloud Connector, Service Center, Storyboard, Layout Editor, ABAP, OData, subscription, entitlements, role collection, Business_Application_Studio_Developer, Git, clone, push, pull, Gerrit, PAT, OAuth, asdf, runtime, Node.js, Java, Python, Task Explorer, CI/CD, Yeoman, generator, template wizard, mbt, mtar, debugging, breakpoint

204 51
Explore
secondsky/sap-skills

sap-btp-cias

SAP BTP Cloud Integration Automation Service (CIAS) skill for guided integration workflows. Use when: setting up CIAS subscriptions, configuring destinations, assigning roles (CIASIntegrationAdministrator, CIASIntegrationExpert, CIASIntegrationMonitor), planning integration scenarios, working with My Inbox tasks, monitoring scenario execution, troubleshooting CIAS errors, creating OAuth2 instances, configuring identity providers for CIAS, understanding CIAS security architecture, or integrating SAP products (S/4HANA, SuccessFactors, BTP services, SAP Build, IBP).

204 51
Explore
secondsky/sap-skills

sap-ai-core

Guides development with SAP AI Core and SAP AI Launchpad for enterprise AI/ML workloads on SAP BTP. Use when: deploying generative AI models (GPT, Llama, Gemini, Mistral), building orchestration workflows with templating/filtering/grounding, implementing RAG with vector databases, managing ML training pipelines with Argo Workflows, configuring content filtering and data masking for PII protection, using the Generative AI Hub for prompt experimentation, or integrating AI capabilities into SAP applications. Covers service plans (Free/Standard/Extended), model providers (Azure OpenAI, AWS Bedrock, GCP Vertex AI, Mistral, IBM), orchestration modules, embeddings, tool calling, and structured outputs.

204 51
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results