Skip to Content
Technical Articles
Author's profile photo Olga Dolinskaja

How to backup custom code with gCTS

In an average customer SAP ERP system, a large part of custom code is never executed in the production. Therefore, while converting your system to SAP S/4HANA it is crucial to identify and remove unused custom code in order to save your costs for its adaptation and future maintenance.

Custom Code Migration app can identify obsolete custom code based on uploaded usage data, store it in the deletion transport on your SAP ERP system, and during system conversion to SAP S/4HANA this deletion transport can be removed from the system (see the blogs Custom code analysis for SAP S/4HANA with SAP Fiori App Custom Code Migration for more details about the Custom Code Migration app and ABAP Call Monitor (SCMON) – Analyze usage of your code on how to collect usage data).

If you have concerns about deleting unused code, because you think, that you may need it at a later point of time, a downsized production or development system for backup of your unused code might be a solution. However, it is associated with costs and effort since you would need to set up and maintain an additional system in your landscape only for backup purposes.

That’s why we decided to offer the much better option to backup and possibly restore your unused code – backup with gCTS.

The idea behind that is as following. During SAP S/4HANA system conversion you don’t remove your unused custom code. Instead of this, after the system conversion, you create an external Git repository, enable Git-enabled Change and Transport System (gCTS) and configure a Git repository on your converted SAP S/4HANA system to create a connection between your SAP S/4HANA system and this external Git repository. Finally you transfer the objects from your deletion transport to the external Git repository. Your backup of unused custom code is ready, and you can remove the unused objects of the deletion transport from your SAP S/4HANA system.


How to import individual objects from Git repository to your SAP S/4HANA system

Just imagine, that using gCTS you have created the backup for your unused objects as a Git repository:

and deleted these objects from your SAP S/4HANA system.

Now you want to import some objects from the backup back into your SAP S/4HANA system, for example domain ZFILEPATH and data element ZFILEPATH:

On your SAP S/4HANA system these objects don’t exist anymore, since you removed them after creating the backup:

If you want to import these individual objects you can use the corresponding API, which takes as parameters your repository ID (as configured in gCTS UI) and the list of objects, you want to import. Here is the code snippet containing the API usage example:

data(request) = value cl_cts_abap_vcs_repo_facade=>ty_deploy_repository_request(
    repository = 'myRepositoryId'  " Enter your repository ID (as configured in gCTS UI) here
    scope      = 'CUSTOM'
    objects    = value #(
        " List all objects you want to deploy from the repository into your ABAP system here:
        ( pgmid = 'R3TR' type = 'DOMA' object = 'ZFILEPATH' )
        ( pgmid = 'R3TR' type = 'DTEL' object = 'ZFILEPATH' )
data(response) = cl_cts_abap_vcs_repo_facade=>deploy_repository( request = request ).

To use this API you need to implement the SAP Note 3084108 on your SAP S/4HANA >=2020 system.

After executing it domain ZFILEPATH and data element ZFILEPATH get imported into the SAP S/4HANA system and are available again:


Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Łukasz Pęgiel
      Łukasz Pęgiel

      Interesting! Any UI to manage this? 🙂

      Author's profile photo Olga Dolinskaja
      Olga Dolinskaja
      Blog Post Author

      Hi Łukasz,

      not yet :-). For now you can write for example a report using the APIs.



      Author's profile photo Łukasz Pęgiel
      Łukasz Pęgiel

      Not yet sounds prommising 🙂 Thanks Olga!

      Author's profile photo Marcelo M Bovo
      Marcelo M Bovo

      Would be a nice to be have an api to export those objects too. This way we wouldn't be dependant on the good will of basis team to implement GCTS

      Author's profile photo Olga Dolinskaja
      Olga Dolinskaja
      Blog Post Author

      Hi Marcelo,

      you can export the objects to the Git repository using gCTS. What are you missing?

      Kind Regards,


      Author's profile photo Marco Beier
      Marco Beier

      Fantastic. Nice example of the API usage and the "not yet" for a UI does indeed sound very good.

      Author's profile photo Edo von Glan
      Edo von Glan

      Sounds nice!

      Just to mention it, another option is to

      • assign all the to-be-deleted objects to a separate package like Z_BACKUP_<DATE>
      • then create an offline ZIP (or online github) repository from that package using abapGit.
      • Then delete the objects
      • Since April 2021, abapGit offers a selective restore of objects from a repository
      Author's profile photo martin coetzee
      martin coetzee

      Really useful info. Thanks.