Migrate existing files to Tricentis File Service

After you have enabled Tricentis File Service, Tricentis Tosca saves all new files that you create to Tricentis File Service.

If you want to move files that already exist in your workspace to Tricentis File Service, you need to migrate them.

Only admin users can migrate files to Tricentis File Service.

Migration process

To migrate existing files, follow the steps below:

  1. Perform preparatory steps to clean up your workspace.

  2. Perform a test migration. Tricentis recommends that you create a backup of your database and test the migration on a test database first. If it's successful, perform the actual migration.

  3. Migrate your files.

Preparatory steps

Before you migrate, make sure that your workspace is up-to-date and clean:

  1. Double-check your synchronization policies. Tricentis Tosca only migrates files that are included in the workspace.

  2. Search your workspace for lost objects and remove them. If you don't, Tricentis Tosca also moves lost object files to Tricentis File Service.

  3. Ensure that all users have checked in their changes.

  1. Update your workspace to get the changes.

    Alternatively, you can search for objects that are currently checked out and revoke the checkout. However, you lose all changes that the user who checked out the object has made to it.

    If you still want to proceed, use the following TQL query on the project root: ->AllOwnedSubItems[CheckOutState == "CheckedOut"]. Then right-click the search results and select Revoke Checkout from the context menu.

  2. Check in your own changes.

Migrate your files

You can migrate specific attachments, or you can migrate all attachments of the following objects:

To perform the migration, follow the steps below:

  1. In Tosca Commander, right-click the object you want to migrate and select Migrate to FileService from the context menu. Tosca Commander checks out the object you selected.

  2. Check in to upload the files to Tricentis File Service.