Changes in customizations

This topic describes changes in customizations that you need to be aware of after an upgrade of Tricentis Tosca.

Each dropdown contains the changes that occurred between the listed version and the previous one. For example, the 2025.1 dropdown lists the differences between 2025.1 and 2024.2. So, if you upgrade from an older version, you also need to consider the changes of all versions in between.

No changes to customizations.

No changes to customizations.

DokuSnapper

The parameters for the constructor ExecutionReportScreenshotTaskExecutor have changed. All inherited classes of ExecutionReportScreenshotTaskExecutor should adapt their usages to comply with these changes.

Additionally, if the class you're inheriting from is not available anymore, use its base class instead. This is because executors for Engines aren't needed anymore.

Java Engine 3.0

With Tricentis Tosca 2024.1, we've moved the following types from Interaction library to the Java Engine library: 

  • IJavaEntryPointTechnical

  • JavaEntryPointTechnicalBase

  • JavaTechnicalMethodInfo

  • JavaTechnicalParameterInfo

  • JavaTechnicalPropertyInfo

  • JavaTechnicalTypeInfo

  • RemoteJavaReflectableTechnical

If you have affected customizations, you need to recompile them after upgrading to the latest version.

TBox executors

TBox executors, which are classes inheriting from ItemExecutor<T>, are now internal. This means you can no longer customize any behavior of ItemExecutors.

Contact Tricentis Support if you need assistance with this matter.

No changes to customizations.

Updated class constructors

2023.1 has the new parameters IScreenServices and IConfiguration in these class constructors:

  • Tricentis.Automation.Engines.Representations.ListBoxRepresentationController

  • Tricentis.Automation.Engines.Adapters.Controllers.OptInt.OptIntScreenAdapterController

  • Tricentis.Automation.Engines.Adapters.Controllers.Pdf.PdfDocumentContextAdapterController

  • Tricentis.Automation.Engines.Representations.Controllers.DefaultContextRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.ListBoxContextRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.PagedTableContextRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.ReplacedTableCellContextRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.RepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.RootRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.TableCellContextRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.TableColumnContextRepresentationController

  • Tricentis.Automation.Engines.Representations.Controllers.TableContextRepresentationControllerBase

  • Tricentis.Automation.Engines.Representations.Controllers.TableRowContextRepresentationController

If you have customizations that use one of these classes, you must set the new parameters in the constructor of the classes which inherit these parameters and forward them to their base classes.

Custom DLL locations

To upgrade custom DLLs, place all your custom DLL files directly in the %TBOX_HOME% directory. If you have custom DLL files in folders within this directory, choose one of the following options:

  • Move the DLL files directly into %TBOX_HOME% and delete the folders.

  • Keep the files in the folders, but define the custom location in the settings.

We're very sorry, but we don't offer this information in the 2025.1 manual. To learn more, check out "Upgrade end-of-life versions".