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 2026.1 LTS dropdown lists the differences between 2026.1 LTS and 2025.1. So, if you upgrade from an older version, you also need to consider the changes of all versions in between.
TCAddon API: upcoming property deprecation
The TCAddon API (opens in new tab) allows you to extend Tosca Commander functionality with your own, custom tasks. With 2026.2, we plan to deprecate the TCAddon property TCAddon.ActiveWorkspace.
As a result, we're introducing new methods for the following classes (opens in new tab) in 2026.1:
-
TCAddonDropTask
-
TCAddonMenuItem
-
TCAddonTask
In 2026.1, the TCAddon.ActiveWorkspace property is still available, so you can use the old or the new methods. We recommend that you switch to the new methods to ensure a smooth transition.
Effective 2026.2, the property will be gone. If you're still using the old methods by then, the API will stop working.
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.
We're very sorry, but we don't offer this information in the 2026.1 LTS manual. To learn more, check out "Upgrade end-of-life versions".