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 2024.2 dropdown lists the differences between 2024.2 and 2024.1. So, if you upgrade from an older version, you also need to consider the changes of all versions in between.

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.

Updated library
The Tricentis.Common.Logging library no longer exposes the TricentisLogger class. If you use this class in your customizations, remove it and use the ILog interface instead.

Changes in facilities
With Tricentis Tosca 15.1 STS, we have moved members of the facility LocalWin32ObjectManager.EntryPoint to IWindowServices and IWindow. You must therefore adapt all customizations which use the facility LocalWin32ObjectManager.EntryPoint to instead use IWindowServices or IWindow . After this change, you can use the following factory call when getting a new window service:
Tricentis.Automation.Win32Base.Services.ServiceFactory.CreateWindowService()

No changes to customizations.

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