SAP Knowledge Base Article - Public

3482742 - Transport Management in S/4HANA Cloud - Central KBA

Symptom

Transport management is a crucial aspect of any ERP system, including SAP S/4HANA Cloud. It enables organizations to efficiently and securely move software changes and configurations across different system landscapes, such as development, quality assurance, and production environments. In this article, we will provide an overview of transport management in S4HANA Cloud, discuss best practices, offer recommendations, and address some frequently asked questions.

Note: The current KBA focuses on the 3-System Landscape scenario.

Environment

SAP S/4HANA Cloud Public Edition

Resolution

System Landscapes in SAP S/4HANA Cloud

The 3-system landscape consists of a development system, test system, and production system. Configuration content in the 3-system landscape is always provided via SAP Central Business Configuration, which is connected only to the development system. While SAP handles the software updates and upgrades, you decide within a dedicated time frame when you want to apply the content updates and upgrades available in SAP Central Business Configuration.

 

The following graphic illustrates the connection between SAP Central Business Configuration with the development system. The graphic also shows the basic transport process from the development to the test system, and from the test to the production system.

    Transports

    SAP provides dedicated tools and apps to move transport requests from your development system into your test system and production system. The following graphic shows the movement of the different types of transport request through your systems:

    Transport Management Summary

    The following tables give you an overview of transport management in a 3-system landscape.

    TypeChangeable inChange RecordingTool for Change Request CreationTool for Change Request Release/ExportTool for ImportCollection Type in Import Collection App
    Developer ExtensibilityDevelopment TenantWorkbench RequestTransport Organizer in ADTTransport Organizer in ADT

    Import Collection

    SAP Fiori App

    Developer Extensibility
    Key User ExtensibilityCustomizing TenantSoftware Collection

    Transport is created automatically by

    the system during export from the

    Export Software Collection SAP Fiori app

    Export Software Collection SAP Fiori AppKey User Extensibility

    Business

    Configuration

    Business Scenario Scoping in

    SAP Central Business Configuration

    Customizing Tenant

    (deployed from SAP Central Business Configuration workspace)

    Development Tenant

    (deployed from SAP Central Business Configuration workspace),

    no transport to test and production system

    Customizing Request

    Customizing request is created automatically

    by the system during deployment of workspace

    from SAP Central Business Configuration

    Export Customizing Transports SAP Fiori AppCustomizing

    Client-Dependent

    Fine-Tuning

    Customizing Tenant

    Development Tenant, no transport to test and production system

    Test and production tenant for current settings
    Export Customizing Transports SAP Fiori App

    Client-Independent

    Fine-Tuning

    Customizing Tenant

    Cross-Client Customizing Request

    (technically Workbench Request)

    Cross-Client Customizing

    Business Role

    TaskTool for Transport ManagementBusiness Catalog for Creating RequestsBusiness Catalog for Releasing Request/ExportBusiness Catalog for ImportBusiness Role Template
    Developer- Implement custom ABAP code in the development tenant using ABAP Development Tools (ADT).  
    - Release the workbench request by using the Transport Organizer view in ABAP Development Tools once you have finished the implementation.
    ABAP Development Tools (ADT)SAP_A4C_BC_TRN_MNG_PCSAP_A4C_BC_TRN_REL_PC-SAP_BR_DEVELOPER
    Key User- Customize applications using SAP Fiori-based key user apps(for instance, Custom Fields SAP Fiori app). 
    - Add the extensions to a software collection and export the software collection using the Export Software Collection app.
    SAP Fiori app Export Software Collection-SAP_CORE_BC_SL_EXPSAP_BR_ADMINISTRATOR

    Business Process 

    Configuration Expert 

    - Scope the business scenarios in the workspace in SAP Central Business Configuration.
    - Deploy the workspace to the customizing tenant of the development system.
    - Fine-tune the configuration content via implementation activities. 
    - Release the customizing requests using the Export Customizing Transports SAP Fiori app.
    SAP Fiori app Export Customizing TransportsSAP_CORE_BC_BCT_TRN_MNG_PCSAP_CORE_BC_BCT_TRN_REL_PCSAP_BR_BPC_EXPERT
    Administrator - Import the customizing requests, the software collection, and the workbench request into the test/production tenant.SAP Fiori app Import Collection-SAP_CORE_BC_SL_IMPSAP_BR_ADMINISTRATOR

    Restrictions and Constraints

    • Transports for developer extensibility, key user extensibility, and business configuration are separated, and content can't be mixed.
    • Transport requests of the different categories can't be merged.
    • It is not possible to delete requests, request objects, tasks and task objects which contain the Object Type Semantic Business Configuration Lock Token.
    • You import all types of transport request into the test tenant (100) of your test system, and forward/import them into the production tenant (100) of your production system, by using the app Import Collection. You should always export and import transport requests in the sequence in which they were created; transport requests for scope and organizational structure, as well as those for reference content, can only be imported and forwarded in this sequence.
    • All SAP CBC transport requests must be transported in the same sequence of their deployment.
    • Transport requests with dependencies must be transported in the right sequence or they must be merged.
    • You can't import a transport created on release n into release n+2 and higher, which means that you have to recreate the transport in the development system. However, it is not possible to recreate CBC transports. In this case, you have to create a support incident.
    • Export, import, and forward are not possible while the system is being prepared for upgrade. Preparation for upgrade normally begins a few days before the actual upgrade is performed.

    Recommendations

    We have several recommendations for your transports:

    • Release your transports regularly; they should not be unnecessarily large. In particular, you should note the following:
      • When working with developer extensibility, you should have one transport per sprint and independent feature.
      • When working with business configuration, you should have one default transport per sprint.
    • Dependency checks may require you to release some transport requests in a specific sequence, to avoid import errors and inconsistencies in the target system. You should plan transports so that any dependencies are managed accordingly. It is not always possible to fix issues with transport dependencies by merging the transports, as transport requests of different types cannot be merged; they have to be released in the correct sequence instead. This is especially important when transports for reference content have dependencies to transports for business configuration. The transport without dependencies should be released first, and then the dependent transport. For more information, see section Object Dependencies under Transport Dependencies.
    • If a transport for reference content needs to be imported or forwarded but it has dependencies to other transports, the transports should all be imported or forwarded together.
    • Once your scope is deployed from SAP Central Business Configuration and activated in your development system, you should immediately release your transports of type Central Business Configuration in the app Export Customizing Transports, before starting any business configuration activities.
    • Large content deployments for new countries, scope enhancements, or organizational changes from SAP Central Business Configuration to the development system should not be triggered in the 24 hours prior to the upgrade preparation due to the possibility of longer content activation times. This may interfere with the upgrade activities triggered by SAP.
    • Release all transports from your development system before it is upgraded.
    • Make sure that the states of your test system and production system are as similar as possible, so that you can apply and test corrections quickly.
    • Have an approval process for corrections, and use dedicated transport requests for them; you must be able to make corrections and transport them at any time.
    • Work in sprints according to your needs (for example, 2 weeks per sprint); you should always have an open default transport request available for each sprint. To obtain more information, consult the help document Best Practices and learning SAP S/4HANA Cloud, Public Edition, 3-System Landscape - Transport Management Fundamentals.
    • Establish a dedicated role or team to take care of transports between systems.
    • Collaborate closely within your implementation team, to ensure timely release of dependent changes between different countries or lines of business.
    • It is recommended to import collections with a high business interruption risk after working hours.

    Frequently Used KBAs/Notes

    TopicCategorySAP KBA/NoteComponent
    Export - Export Customizing TransportsHow to3381903 - Which transport request save changes made in SSCUI 100297 Automatic Account Determination in 3SL landscapes - SAP S/4HANA Cloud?FI-FIO-GL-CA-2CL, BC-CUS-TOL-CTO
    3414345 - How to use Fiori Apps to manage the Transport RequestsBC-CUS-TOL-CTO
    3414407 - Basic Information on Export Customizing Transports App BC-CUS-TOL-CTO
    3448385 - Guidance for transport requests of Central Business Configuration(CBC) TypeBC-CUS-TOL-CTO, X4-CBC-PRX, X4-CBC-BCL
    3450189 - How to delete task or object of a request with SBCL TokenBC-CUS-TOL-CTO
    3478201 - How to re-transport the configurations recorded in the outdated transports from customizing tenantBC-CUS-TOL-CTO
    Problem3359506 - Error FOT_TDT121 in export customizing transportFI-GL-GL-F-2CL, FI-GL-GL-F, BC-CTS-TMS
    3462787 - Transport Request type Central Business Configuration has status "Request Has Dependencies."BC-CUS-TOL-CTO, BC-SRV-APS-EXT-SL
    3477065 - Outdated customizing transport request - SAP S/4HANA CloudBC-CUS-TOL-CTO, BC-SRV-APS-EXT-SL
    Export - Export Software CollectionHow To2638029 - ATO: How to resolve Dependencies of ATO itemsBC-SRV-APS-EXT-SL
    3116689 - Export Software Collection - Best PracticeBC-SRV-APS-EXT-SL
    2633449 - Exporting a single change from Software CollectionBC-SRV-APS-EXT-SL
    2914802 - Error when checking software collectionBC-SRV-APS-EXT-SL
    Problem2525944 - Error message trying to export a Software Collection after an upgradeBC-SRV-APS-EXT-SL
    2567793 - Software Collection Export Failed After Quality System UpgradedBC-SRV-APS-EXT-SL
    2734930 - Objects in Export Software Collection Show Status ChangedBC-SRV-APS-EXT-SL
    2748201 - Error During Export Software Collection CheckBC-SRV-APS-EXT-SL, BC-SRV-APS-IAM
    2803215 - Export checks failed in app Export Software CollectionBC-SRV-FP-OM
    2807406 - Unable to export software collectionBC-SRV-APS-EXT-SL
    2840284 - Failed Export after unpublishing Catalog ExtensionBC-SRV-APS-IAM
    2855544 - xtit.error when launching the Export Software Collection AppBC-SRV-APS-EXT-SL
    2902696 - Item cannot be added to Software CollectionBC-SRV-APS-EXT-SL
    2934489 - Warnings on software collection checkBC-SRV-APS-GKE
    3069850 - Unresolvable dependencies error in Export Software Collection when attempting to export in the productionBC-SRV-APS-IAM
    3132487 - Item not found when trying to add to software collection - S/4HANA CloudBC-SRV-APS-EXT-SL
    3134895 - Export Software Collection: Could not find a extensibility item via "Add Items"BC-SRV-APS-EXT-SL
    3168405 - Can't find changes in Export Software Collection app - SAP S/4HANA CloudBC-SRV-APS-EXT-SL
    3200444 - Export is locked for the tenant - S/4HANA CloudBC-SRV-APS-EXT-SL
    3248598 - Hotfix shows one item but content table is emptyBC-SRV-APS-EXT-SL
    3257896 - Access Sequence must be added to ATO before Condition Type is transported - S/4HANA CloudSD-MD-CM
    3268882 - Check of collection fails with error "Segmentation Data Source <segmentDataSource> depends on Custom Field <customField> - Export Software CollectionBC-SRV-APS-EXT-SL
    3269050 - Performance issue while exporting software collection with large version numberBC-SRV-APS-EXT-SL
    3309168 - Warning message "The following item types can only be imported to the xxxx release" displays when exporting a software collection - SAP S/4HANA CloudBC-SRV-APS-EXT-SL
    3317614 - Export Software Collection app is missing in the Quality System of a 3-System Landscape | S/4HANA CloudBC-SRV-APS-IAM, BC-SRV-APS-EXT-SL 
    3327116 - Get error: "A deleted collection is already named xxx" when creating software collectionBC-SRV-APS-EXT-SL
    3332535 - Error message like "Merged item xxxxxx cannot be added to hotfix." is displayed when trying to add the merged items to hotfix - SAP S/4HANA CloudBC-SRV-APS-EXT-SL
    3347417 - Error: Item YY1_<ItemName> of type <ItemType> has dependencies to collection <SoftwareCollectionName> - S/4HANA CloudBC-SRV-APS-EXT-SL, BC-SRV-APS-EXT-FLD, BC-SRV-APS-EXT-BL, BC-SRV-APS-EXT-AQD, BC-SRV-APS-GKE
    3407810 - Publish custom catalog extension YY1_XXXX for catalog XXXXX before transporting | SAP S/4HANA CloudBC-SRV-APS-EXT-SL, BC-SRV-APS-IAM
    3446856 - Review button is disabled in Export software collectionBC-SRV-APS-EXT-SL
    3448865 - Export checks failed. Please report an incident on component BC-SRV-APS-EXT-AQDBC-SRV-APS-EXT-AQD, BC-SRV-APS-EXT-SL
    3469036 - Error "Object ... is part of a local software component" when trying to transport object from development tenant - S/4HANA CloudBC-SRV-APS-EXT-SL
    Export/ImportHow To3094619 - FAQ: Is it possible to transport entries of a Custom Business Object? - S/4HANA CloudBC-SRV-APS-EXT-BO
    3401738 - FAQs about Transport Management for S/4HANA Public Cloud CustomersXX-S4C-OPR-SRV
    3433477 - Best practices for Key User Extensibility in parallel project line - SAP S/4HANA Cloud, public editionBC-SRV-APS-EXT-SL
    Problem2535246 - Import Software Collection Shows More Objects Than ExportBC-SRV-APS-EXT-SL
    3103104 - What to do if an unwanted Key User Extensibility Software Collection is exported to P-System?BC-SRV-APS-EXT-SL
    3126032 - Export/import Software Collections in S/4HANA Cloud - Frequently Asked QuestionBC-SRV-APS-EXT-SL
    Upgrade information3040585 - In-APP Extensibility and ATO transports are temporarily disabledBC-SRV-APS-EXT-SL
    Import CollectionHow To3133027 - How to interpret the "Release at Export" column? - Import CollectionBC-SRV-APS-EXT-SL
    Problem2680324 - Custom Field not displayed in UI after importBC-SRV-APS-EXT-FLD
    3125495 - Error "You are not authorized to import a Software Collection." - S/4HANA CloudBC-SRV-APS-EXT-SL
    3133027 - How to interpret the "Release at Export" column? - Import CollectionBC-SRV-APS-EXT-SL
    3216638 - Software Collection stuck in Importing status and business interruption - SAP S/4HANA Cloud BC-SRV-APS-EXT-SL
    3271415 - Software Collection import failed due to existing draft of a business roleBC-SRV-APS-IAM, BC-SRV-APS-EXT-SL
    3272744 - Importing a Software Collection that contains Custom fieldsBC-SRV-APS-EXT-FLD, BC-SRV-APS-EXT-SL, BC-DWB-DIC-AC
    3296288 - "Outdated" status - Import Key User Extensibility collections to higher releases - S/4HANA CloudBC-SRV-APS-EXT-SL
    3324929 - Not able to Import Collection into Customizing/Development Tenant (3SL) - SAP S/4HANA CloudBC-SRV-APS-EXT-SL
    3404200 - Transport request released in ABAP Environment not visible in Import Collection app in test tenant - Developer extensibility - SAP S/4HANA CloudBC-SRV-APS-EXT-SL

    See Also

    Learning

    Refer to the attached learning map 'S4HC Learning Journey - Transport Management.pdf' for a more systematic approach to learning transport management. 

    Help Document

    3-System Landscape and Transport Management

    Overview of Software and Content Upgrade

    Transport Management Summary

    Transport Dependencies

    Tools and Apps

    Export Software Collection

    Import Collection

    Community Blog

    Transport Management in S/4HANA Cloud

    How to Manage and Move Transport Request in S/4HANA Public Cloud (Cloud ERP) in 3 System Landscape

    3-System Landscape Provisioning and Initial Activities in CBC for S/4HANA Cloud

    Transport Management in SAP S/4HANA Cloud Public Edition 3-System Landscape: From Basics to Complex

    Transport Management in SAP S/4HANA Cloud 3SL (2): Parallel Implementation and Maintenance

    Keywords

    Transport Management, 3-System Landscape, Export Software Collection, Export Customizing Transports, Import Collection , KBA , BC-SRV-APS-EXT-SL , Manage and Import Software Collections , XX-SER-MCC , Mission Control Center - Knowledge Management , BC-CUS-TOL-CTO , Export Customizing Transports App , How To

    Product

    SAP S/4HANA Cloud Public Edition all versions

    Attachments

    Pasted image.png
    Pasted image.png
    Pasted image.png
    Pasted image.png
    Pasted image.png
    Pasted image.png
    S4HC Learning Journey_Transport Management.pdf