Delete files from Tricentis File Service

Files can accumulate quickly. To reduce the size of your Tricentis File Service database, Tricentis recommends that you delete old files on a regular basis.

To do so, choose one of the following options:

  • Delete objects from Tosca Commander. Any user who has the necessary rights to an object can delete the object from Tosca Commander.

  • Clear execution log data via TC-Shell. Only admin users can clear execution log data.

Don't delete files manually from the Tricentis File Service database. Doing so will break your project.

Only delete files via the delete tasks described in this chapter.

Delete objects from Tosca Commander

The simplest way to manage Tricentis File Service size is to delete outdated objects from Tosca Commander. This deletes all connected files from Tricentis File Service.

Once you check in, the deletion is permanent. You can't undo the deletion from Tricentis File Service, and you can't restore deleted files to Tricentis File Service.

What can you remove?

Tricentis recommends that you clear out test objects regularly. For instance:

  • Delete attachments you no longer need.

  • Delete outdated test objects like old Modules.

  • Delete old logs or clear the ActualLog of playground ExecutionLists. This removes the results from Tosca Commander and all log data from Tricentis File Service.

Clear execution log data

Execution logs and their screenshots can take up significant space in Tricentis File Service.

To clear log data, use the TC-Shell task deleteOldExecutionLogs as described in the TC-Shell manual.

Once you have executed the task, the deletion is permanent. You can't undo the deletion from Tricentis File Service, and you can't restore deleted files to Tricentis File Service.

What's the difference to deleting logs in Tosca Commander?

If you delete a log or clear an ActualLog in Tosca Commander, the results are gone.

If you delete a log with the deleteOldExecutionLogs task, Tosca Commander keeps some result information. You can still see past test runs and whether they passed or failed.

Execution logs for ExampleExecutionList after clearing all logs from Tricentis File Service

What can you remove?

The deleteOldExecutionLogs task allows you to perform one of the following actions: 

  • Delete all execution logs from Tricentis File Service. This includes screenshots that are attached to the logs.

  • Delete all execution logs and log screenshots that are older than the specified number of days.

  • Only delete screenshots that are attached to the logs. You can delete screenshots from all logs or only from logs that are older than the specified number of days.