Skip to main content

Celonis Product Documentation

Migrate Analyses from Celonis 4 to EMS using Content-CLI

Important

Please note migration only supports CTP versions 4.6 and above. If you need help at any point reach out to your CSM.

Leverage the Celonis Content- CLI to migrate analyses from Celonis 4 to the EMS platform.The Content-CLI allows you to push CTP-files (Celonis 4 transports) to the Studio.

  1. Make yourself familiar with the Celonis Content- CLI and first create a Profile which you will use for pushing the CTP-files.

  2. Create a Celonis 4 Transport (ctp file):

    1. Login to your Celonis 4 instance and create a transport (.ctp file).

    2. Add all analyses you would like to group into one package in the Studio.

    3. Make sure to also tick the box to inlcude the data model. (Don't include the data itself. Data will not be migrated.)

    4. Make sure to remember the Transport password.

      Note

      • The "Global Content Administrator" role of Celonis 4 is required to create transport files

      • When creating the .ctp file, make sure to check "include data-model" when selecting the analyses. The data model meta data is used for creating the data model variable name on the Studio. If you do not check this option then a variable with a default name ("data model default") will be created on the Studio. The data model variable is used to assign the data model later. Please note, the data model itself will not be migrated with this tool.

      • The shared bookmarks will be included in the transport and will be then owned by whoever runs the command for migrating. Personal bookmarks will not be migrated, as we do not have the user mapping. If you want to include personal bookmarks, first share them.

      • The shared bookmarks will be included in the transport and will be then owned by whoever runs the command for migrating. Personal bookmarks will not be migrated, as we do not have the user mapping. If you want to include personal bookmarks, first share them.

      41196346.png
  3. Create a Studio Spaces. Since the release of Studio Spaces, it is required to supply a space key to push any Analyses from CTP.

  4. Use the content-cli in the ML Workbench, make sure that you first created a profile. Then run the following command:

    Command

    content-cli push ctp --profile <profile>--file <filepath> --password <password>
    
    content-cli-push ctp: Command to push a .ctp (Celonis 4 transport file) to create a package
    
    Options:
            -p, --profile <profile>   Profile which you want to use to push the analysis
            -s, --spaceKey <spaceKey> The key of the destination space where the analyses from .ctp file will be created.
            -f, --file <file>         The .ctp file you want to push
    --password <password>         The password used for extracting the .ctp file

    Here with an example:

    Command

    content-cli push ctp --profile local --spaceKey my-cool-space --file ~/Downloads/CE_TRANSPORT_MigrationTestTransport.CTP --password Celonis4Demo 
  5. After the file was successfully pushed, a package with the name of the Transport file was created. Go to the Package Settings > Variables and Assign a data model to the data model variable.

    Notice

    You will first need to create the data model to be able to assign it to the data model variable. Please note, that the data model migration is not part of this tooling.