zhongwei/gh-secondsky-sap-skills-skills-sap-btp-integration-suite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f7e6b835303921c06089c46b670540da590bced7
gh-secondsky-sap-skills-ski…/SKILL.md
Zhongwei Li f7e6b83530 Initial commit
2025-11-30 08:55:05 +08:00

332 lines
12 KiB
Markdown
Raw Blame History

---
name: sap-btp-integration-suite
description: |
Develops and operates enterprise integration solutions using SAP Integration Suite on Business Technology Platform.
Covers Cloud Integration (iFlows), API Management, Event Mesh, Edge Integration Cell, Integration Advisor,
Trading Partner Management, Graph, OData Provisioning, Integration Assessment, and Migration Assessment.
Use this skill when:
- Building integration flows (iFlows) to connect applications
- Creating, managing, or debugging API proxies and policies
- Implementing event-driven architectures with Event Mesh
- Setting up B2B/EDI integrations with Trading Partner Management
- Deploying hybrid integrations with Edge Integration Cell
- Migrating from SAP Process Orchestration (PO/PI)
- Configuring adapters (SFTP, HTTP, OData, RFC, AMQP, Kafka, etc.)
- Writing Groovy/JavaScript scripts for message processing
- Troubleshooting integration errors and monitoring message flows
Keywords: sap integration suite, cloud integration, cpi, scpi, sap cpi, iflow, integration flow,
api management, apim, api proxy, api policy, developer hub, developer portal, event mesh,
edge integration cell, integration advisor, trading partner management, tpm, b2b integration,
edi integration, migration assessment, integration assessment, isa-m, graph, odata provisioning,
sap btp integration, cloud platform integration, message mapping, groovy script, adapter configuration,
content modifier, splitter, aggregator, router, sftp adapter, http adapter, odata adapter, rfc adapter,
amqp adapter, kafka adapter, jms queue, data store, idempotent processing, exactly once
license: GPL-3.0
metadata:
version: 1.1.0
last_verified: 2025-11-27
documentation_source: [https://github.com/SAP-docs/sap-btp-integration-suite](https://github.com/SAP-docs/sap-btp-integration-suite)
sap_help_portal: [https://help.sap.com/docs/integration-suite](https://help.sap.com/docs/integration-suite)
status: production
token_savings: ~65-80%
allowed-tools:
- Read
- Bash
- Glob
- Grep
- WebFetch
- WebSearch
---
# SAP BTP Integration Suite Development
## 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:
```groovy
// 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
```xml
<PolicyName enabled="true" continueOnError="false" async="false">
<!-- Policy configuration -->
</PolicyName>
```
---
## Message Quality of Service
### Exactly-Once Processing
Use when duplicates must be prevented:
1. **JMS Queues** - Transactional message storage
2. **Idempotent Process Call** - Duplicate detection via ID mapping
3. **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
1. Activate Edge Integration Cell in Integration Suite
2. Prepare Kubernetes cluster (platform-specific)
3. Deploy Edge Lifecycle Management Bridge
4. Deploy Edge Integration Cell solution
5. Configure keystore synchronization
6. 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](https://github.com/SAP-docs/sap-btp-integration-suite)
- **SAP Help Portal**: [https://help.sap.com/docs/integration-suite](https://help.sap.com/docs/integration-suite)
- **SAP Community**: [https://community.sap.com/topics/cloud-platform-integration-suite](https://community.sap.com/topics/cloud-platform-integration-suite)
- **SAP Business Accelerator Hub**: [https://api.sap.com/](https://api.sap.com/)
### Capability-Specific
- **Cloud Integration**: [https://help.sap.com/docs/cloud-integration](https://help.sap.com/docs/cloud-integration)
- **API Management**: [https://help.sap.com/docs/sap-api-management](https://help.sap.com/docs/sap-api-management)
- **Event Mesh**: [https://help.sap.com/docs/event-mesh](https://help.sap.com/docs/event-mesh)
- **Integration Advisor**: [https://help.sap.com/docs/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`
Reference in New Issue View Git Blame Copy Permalink