12 KiB
Content Transport - Comprehensive Reference
Source: SAP BTP Integration Suite Documentation Documentation: https://github.com/SAP-docs/sap-btp-integration-suite/tree/main/docs/ci/Development Last Updated: 2025-11-22
Table of Contents
- Overview
- Transport Options
- Cloud Transport Management
- CTS+ Transport
- MTAR Download
- Manual Export/Import
- Best Practices
Overview
Content transport enables reuse of integration content across multiple tenants by exporting from source and importing to target.
Use Cases
- Development → Test → Production promotion
- Tenant-to-tenant content sharing
- Backup and restore scenarios
- Multi-region deployment
Key Constraints
| Constraint | Description |
|---|---|
| Environment | Cannot transport between Neo and CF |
| Draft status | Cannot transport draft artifacts |
| Access policies | Protected artifacts restricted |
| Externalized parameters | Values unchanged during transport |
Documentation: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/content-transport-e3c79d6.md
Transport Options
Option Comparison
| Option | Automation | Setup | Use Case |
|---|---|---|---|
| Cloud Transport Management | High | Complex | Enterprise DevOps |
| CTS+ | High | Complex | SAP landscape |
| MTAR Download | Medium | Moderate | Flexible deployment |
| Manual Export/Import | Low | Simple | Ad-hoc, small scale |
Decision Flow
Need automated DevOps pipeline?
├── Yes → Cloud Transport Management
└── No
├── Have CTS+ infrastructure?
│ ├── Yes → CTS+
│ └── No → MTAR Download or Manual
└── Small scale / ad-hoc?
├── Yes → Manual Export/Import
└── No → MTAR Download
Cloud Transport Management
SAP Cloud Transport Management Service provides automated transport across landscapes.
Architecture
┌──────────────────────────────────────────────────┐
│ Cloud Transport Management │
├──────────────────────────────────────────────────┤
│ Source Node → Transport Route → Destination Node │
│ (DEV) (PRD) │
└──────────────────────────────────────────────────┘
Setup Steps
- Subscribe to Cloud Transport Management Service
- Create service instance in BTP cockpit
- Configure source node (source tenant)
- Configure destination node (target tenant)
- Create transport route connecting nodes
- Enable transport in Integration Suite
Configuration
Source Node:
- Integration Suite tenant
- Export permissions
- Content Agent service
Destination Node:
- Target Integration Suite tenant
- Import permissions
- Deployment credentials
Transport Route:
- Source → Destination mapping
- Route name
- Description
Transport Process
- Select content in Integration Suite
- Export to transport queue
- Approve transport in TMS
- Import to destination
- Verify deployment
Node Configuration (JSON)
{
"name": "DEV_Integration",
"description": "Development tenant",
"type": "SAP_CPI",
"url": "[https://dev-tenant.it-cpitrial.cfapps.eu10.hana.ondemand.com",](https://dev-tenant.it-cpitrial.cfapps.eu10.hana.ondemand.com",)
"credentials": {
"type": "OAuth",
"clientId": "...",
"clientSecret": "..."
}
}
CTS+ Transport
SAP Change and Transport System extended for cloud content.
Prerequisites
- CTS+ system configured
- Transport domain setup
- RFC connectivity to cloud
Setup
- Configure CTS+ transport domain
- Create transport routes to cloud targets
- Set up destination in SAP Solution Manager
- Enable CTS+ transport in Integration Suite
Transport Process
- Create transport request in CTS+
- Export content from Integration Suite
- Release transport request
- Import at target via CTS+
Use Cases
- Organizations with existing CTS+ infrastructure
- Integrated with SAP Change Management
- Enterprise transport governance
Documentation: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/content-transport-using-cts-3cdfb51.md
MTAR Download
Download content as Multi-Target Application Archive for flexible deployment.
Process
- Select content to export
- Download MTAR file
- Upload to CTS+ or Cloud Transport Management
- Deploy to target tenant
MTAR Structure
my-content.mtar
├── META-INF/
│ ├── MANIFEST.MF
│ └── mtad.yaml
├── package1/
│ ├── integration-flow1.iflw
│ └── mapping1.mmap
└── package2/
└── integration-flow2.iflw
Deployment Options
| Option | Description |
|---|---|
| CTS+ | Upload to transport request |
| TMS | Upload to transport node |
| CF Deploy | Direct CF deployment |
Neo Environment
MTAR can be deployed directly to target tenant via SAP Cloud Platform Solutions:
- Navigate to Solutions
- Upload MTAR
- Deploy to tenant
Documentation: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/content-transport-using-mtar-download-c111710.md
Manual Export/Import
Direct export and import without transport infrastructure.
Export Process
- Navigate to Design workspace
- Select package to export
- Click Export
- Download .zip file
Import Process
- Navigate to Design workspace
- Click Import
- Select .zip file
- Choose import options
- Import content
Import Options
| Option | Description |
|---|---|
| Create new | Create as new package |
| Overwrite | Replace existing |
| Skip existing | Keep existing, add new |
Exported Content
| Content Type | Included |
|---|---|
| Integration Flows | Yes |
| Value Mappings | Yes |
| Script Collections | Yes |
| Message Mappings | Yes |
| OData APIs | Yes |
| REST APIs | Yes |
Not Exported
| Content Type | Reason |
|---|---|
| Security Material | Security risk |
| Deployed state | Runtime-specific |
| Monitoring data | Tenant-specific |
API Management Transport
Transportable Content
| Content Type | Method |
|---|---|
| API Proxies | TMS / Manual |
| Products | TMS / Manual |
| API Providers | TMS / Manual |
| Key Value Maps | TMS / Manual |
| Certificates | Special handling |
Transport via TMS
- Configure API Management for TMS
- Export API artifacts
- Transport via TMS route
- Import to target
Certificate Transport
Certificates require special handling:
- Export certificate references (not keys)
- Import references to target
- Upload actual certificates separately
Selective Transport
Individual Artifact Transport
Transport specific artifacts instead of entire packages:
- Select artifact in package
- Export individual item
- Transport or download
- Import to target
Restrictions
| Condition | Transport Allowed |
|---|---|
| Draft status | No |
| Access policy protected | No |
| Referenced artifacts | Must include dependencies |
Handling Dependencies
When transporting artifacts with dependencies:
- Include all referenced artifacts
- Verify references exist in target
- Transport in correct order
Best Practices
Transport Strategy
- Define landscape (DEV → QA → PRD)
- Choose transport method based on scale
- Automate where possible
- Document transport procedures
Content Management
- Use packages to group related content
- Version artifacts meaningfully
- Test in lower environment first
- Validate after transport
Externalized Parameters
Externalized parameters retain source values:
- Document parameter differences
- Update after transport if needed
- Use environment-specific configuration
Pre-Shipped Content
Standard SAP content is not updated during transport:
- Update separately from SAP
- Track versions independently
- Test compatibility after updates
Troubleshooting
Common Issues
| Issue | Resolution |
|---|---|
| Transport fails | Check permissions, connectivity |
| Content missing | Verify export includes all dependencies |
| Deployment error | Check target tenant configuration |
| Version conflict | Resolve conflicts manually |
Error Resolution
- Check transport logs in TMS
- Verify credentials for source/target
- Confirm connectivity between systems
- Review artifact compatibility
Documentation: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ISuite/troubleshooting-transporting-content-bbfb41a.md
Related Documentation
- Content Transport Overview: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/content-transport-e3c79d6.md
- Decision Help: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/decision-help-for-choosing-the-right-content-transport-option-19e0e73.md
- TMS Transport: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/content-transport-using-cloud-transport-management-d458b17.md
- Best Practices: https://github.com/SAP-docs/sap-btp-integration-suite/blob/main/docs/ci/Development/guidelines-and-best-practices-for-content-transport-8a8aa38.md