SAP BTP Integration Suite Development Skill

SAP BTP Integration Suite Development

Quick Reference
Capability Overview
Cloud Integration Development
API Management Development
Event Mesh
Edge Integration Cell
Integration Advisor
Trading Partner Management
Migration Assessment
Bundled Resources

Quick Reference

| Capability | Purpose | Key Artifact | |------------|---------|--------------| | Cloud Integration | A2A/B2B/B2G integration | Integration Flow (iFlow) | | API Management | API lifecycle & governance | API Proxy | | Event Mesh | Event-driven architecture | Topics & Queues | | Edge Integration Cell | Hybrid deployment | Kubernetes runtime | | Integration Advisor | B2B mapping automation | MIG/MAG | | Trading Partner Management | Partner onboarding | Agreements | | Graph | Unified data API | Business Data Graph | | Integration Assessment | Technology selection | ISA-M | | Migration Assessment | PO migration planning | Extraction & Analysis |

Capability Overview

Cloud Integration

Build and run integration flows across cloud, on-premise, and hybrid landscapes for A2A, B2B, and B2G scenarios. Supports 80+ adapters and real-time message processing.

Core Components:

Integration Flows (iFlows) - Visual message processing pipelines
Adapters - Protocol/application connectors (SFTP, HTTP, OData, RFC, AMQP, Kafka, etc.)
Message Mapping - Graphical/XSLT/Groovy transformations
Data Stores & Variables - Persistence for stateful processing
Security Material - Keystores, credentials, PGP keys

API Management

Complete API lifecycle management with security, traffic control, and developer engagement.

Core Components:

API Proxies - Facade layer for backend services
Policies (34 types) - Security, traffic, mediation rules
Developer Hub - API portal for developers
Products - API bundles with access control
Analytics - Usage metrics and insights

Event Mesh

Publish and consume business events across your enterprise ecosystem for event-driven architectures.

Edge Integration Cell

Hybrid runtime for processing data within private landscapes while designing in the cloud. Deploy on Kubernetes (EKS, AKS, GKE, OpenShift, RKE2).

Integration Advisor

AI-powered B2B content development supporting UN/EDIFACT, SAP IDoc, ASC X12. Creates Message Implementation Guidelines (MIGs) and Mapping Guidelines (MAGs).

Trading Partner Management

Streamline B2B relationships with partner profiles, agreement templates, and automated runtime artifact generation. Supports AS2, SFTP, FTP protocols.

Cloud Integration Development

Integration Flow Structure

Sender → [Adapter] → Integration Process → [Adapter] → Receiver
                           ↓
              ┌────────────┴────────────┐
              │  Message Processing     │
              │  - Content Modifier     │
              │  - Router/Filter        │
              │  - Mapping              │
              │  - Splitter/Aggregator  │
              │  - Script               │
              │  - External Call        │
              └─────────────────────────┘

Common Flow Steps

| Category | Steps | |----------|-------| | Routing | Router, Filter, Multicast, Recipient List | | Transformation | Content Modifier, Mapping, Converter, Script | | Splitting | General Splitter, Iterating Splitter, EDI Splitter | | Persistence | Data Store, Write Variable, JMS Send | | External | Request Reply, Send, Poll Enrich, Content Enricher | | Security | Encryptor, Decryptor, Signer, Verifier | | Error Handling | Exception Subprocess, Escalation Event |

Adapter Categories

Protocol Adapters: HTTP, HTTPS, SFTP, FTP, AMQP, JMS, Kafka, AS2, AS4, SOAP, OData Application Adapters: SuccessFactors, Ariba, Salesforce, ServiceNow, Workday Database Adapters: JDBC (Oracle, SQL Server, PostgreSQL, HANA, DB2) Cloud Adapters: AWS (S3, SQS, SNS), Azure (Service Bus, Storage), Google Cloud

Scripting Guidelines

Prefer standard steps over scripts. When scripting is necessary:

// Access message body
def body = message.getBody(String.class)

// Access headers
def header = message.getHeader("HeaderName", String.class)

// Access properties
def prop = message.getProperty("PropertyName")

// Modify body
message.setBody(newBody)

// Add header
message.setHeader("NewHeader", "value")

// Logging (use SLF4J)
def log = org.slf4j.LoggerFactory.getLogger("script")
log.info("Processing message")

Best Practices:

Use XmlSlurper.parse(Object) instead of parseText(String) for large payloads
Use StringBuilder for string concatenation
Never use TimeZone.setDefault() (VM-wide impact)
Never write credentials to headers (tracing exposes them)

API Management Development

API Proxy Structure

Client → Proxy Endpoint → [Policies] → Target Endpoint → Backend
              ↓                              ↓
         PreFlow                        PreFlow
         Conditional Flows              Conditional Flows
         PostFlow                       PostFlow
              ↓                              ↓
         Fault Rules                    Fault Rules

Policy Categories

| Category | Policies | |----------|----------| | Security | OAuth 2.0, Verify API Key, Basic Auth, SAML, Access Control | | Traffic | Quota, Spike Arrest, Concurrent Rate Limit, Response Cache | | Mediation | Assign Message, Extract Variables, JSON/XML Transform, XSL Transform | | Extension | JavaScript, Python Script, Service Callout | | Threat Protection | JSON/XML Threat Protection, Regular Expression Protection | | Logging | Message Logging, Statistics Collector |

Common Policy Attributes

<PolicyName enabled="true" continueOnError="false" async="false">
  <!-- Policy configuration -->
</PolicyName>

Message Quality of Service

Exactly-Once Processing

Use when duplicates must be prevented:

JMS Queues - Transactional message storage
Idempotent Process Call - Duplicate detection via ID mapping
Data Store - Persistent message tracking

Idempotent Pattern

Sender → [ID Mapping] → Check Duplicate → Process → [ID Mapping Complete]
                              ↓ (duplicate)
                         Return Cached Response

Edge Integration Cell

Deployment Requirements

Kubernetes cluster (EKS, AKS, GKE, OpenShift, RKE2)
Minimum: 4 worker nodes, 4 vCPU, 16GB RAM each
Storage: 100GB+ persistent volume
Network: Ingress controller, DNS configuration

Workflow

Activate Edge Integration Cell in Integration Suite
Prepare Kubernetes cluster (platform-specific)
Deploy Edge Lifecycle Management Bridge
Deploy Edge Integration Cell solution
Configure keystore synchronization
Deploy integration content

Troubleshooting

Common Issues

| Issue | Resolution | |-------|------------| | Adapter connection failed | Check credentials, firewall, Cloud Connector | | Message mapping error | Validate source/target structures, check XPath | | Timeout | Increase adapter timeout, optimize mapping | | Memory issues | Stream large payloads, reduce logging | | Duplicate messages | Implement idempotent processing | | Keystore sync failed | Verify certificate validity, check permissions |

Monitoring Hierarchy

Integration Suite → Monitor → Integrations and APIs
    ├── Message Processing → All Integration Flows
    ├── Manage Integration Content → Deployed Artifacts
    ├── Manage Security → Keystores, Credentials
    └── Manage Stores → Data Stores, Variables, Queues

Limits Reference

| Resource | Limit | |----------|-------| | Integration flows per tenant | Varies by plan | | JMS queues | 30 per tenant (standard) | | Data stores | 100MB total storage | | Message processing log retention | 30 days | | Attachment size | 40MB | | API proxies (APIM) | Based on service plan | | Business data graphs | 500/account, 50/subaccount |

Bundled Resources

Reference Documentation

Detailed guides available in references/ directory:

Core Development:

cloud-integration.md - iFlow development, steps, patterns, best practices
adapters.md - All 80+ adapter configurations (HTTP, SFTP, OData, RFC, etc.)
scripting.md - Groovy/JavaScript patterns, APIs, and templates
api-management.md - API proxy development, 34 policies, Developer Hub
security.md - Authentication, keystores, certificates, credentials

Capabilities:

edge-integration-cell.md - Hybrid Kubernetes deployment guide
event-mesh.md - Topics, queues, brokers, webhooks, EDA patterns
integration-advisor-tpm.md - B2B integration, MIGs, MAGs, partner management
graph-odata.md - Business Data Graph, OData provisioning
data-space-integration.md - Catena-X, EDC, sovereign data exchange
migration-assessment.md - PO migration, ISA-M, technology mapping

Operations:

operations-monitoring.md - Message monitoring, stores, connectivity tests
content-transport.md - TMS, CTS+, MTAR, manual export/import
troubleshooting.md - Error resolution, diagnostics, HTTP error catalog

Templates

Ready-to-use templates in templates/ directory:

groovy-script-template.groovy - Common script patterns
api-policy-template.xml - Policy configuration template

Documentation Links

Official Sources

GitHub Repository: https://github.com/SAP-docs/sap-btp-integration-suite
SAP Help Portal: https://help.sap.com/docs/integration-suite
SAP Community: https://community.sap.com/topics/cloud-platform-integration-suite
SAP Business Accelerator Hub: https://api.sap.com/

Capability-Specific

Cloud Integration: https://help.sap.com/docs/cloud-integration
API Management: https://help.sap.com/docs/sap-api-management
Event Mesh: https://help.sap.com/docs/event-mesh
Integration Advisor: https://help.sap.com/docs/integration-advisor

Release Notes

What's New: Check what-s-new-for-sap-integration-suite-79cd682.md in documentation
Patch Releases: Check patch-release-notes-for-sap-integration-suite-58595b5.md

Agent Skills: SAP BTP Integration Suite Development

Install this agent skill to your local

Skill Files