Replace Modules

There is a distinct connection between TestSteps and Modules. In Tricentis Tosca, you can exchange Modules in order to define a new technical basis (Modules) for all referenced TestCases. Any existing references between Modules and TestSteps will be maintained upon exchange. In case of XModules and folders, specializations and references are additionally considered (see chapter "Structure XModules").

When Modules are exchanged, all referenced TestCases are executed with a modified technical basis. This allows TestCases of different Module versions to be executed.

There are two possible scenarios for exchanging Module versions: you can either exchange Modules or transfer technical information from other Modules (classic Modules).

Exchanging Modules

In Tosca Commander you can exchange individual Modules, XModules and Module folders without deleting any references to the TestSteps.

Preconditions

  • All Modules which exist in the source folder must also exist in the target folder, and their names must match.

  • All ModuleAttributes which exist in the source Module must also exist in the target Module, and their names must match.

Preconditions for multi-user projects

Procedure

The procedure for exchanging Modules or Module folders is identical.

  1. Click on the Module to be replaced and keep the left mouse button pressed.

  2. Drag the selected Module over the Module with which to replace it and keep the Shift key pressed.

  3. Release the left mouse button.

  4. In the subsequent dialog box, select the option Replace Module Usages or Replace XModule Usages.

Replace Module Usages

  1. Confirm your selection by clicking OK in the subsequent dialog box:

Replacing Modules in TestSteps

  1. In the subsequent dialog you will be prompted to decide whether the source objects should be deleted or not.

Deleting source objects

All TestStep references will now point to the replaced Modules.

Replacing Module Definitions (classic Module)

Replacing Module definitions is similar to synchronizing Modules. You are able to replace the definitions of individual Modules or Module folders. The target object transfers

  • ModuleAttributes and

  • Technical information (ObjectMap, TechnicalId, etc.)

from the source object.

Prerequisites

  • The target folder may only include Modules whose names match the Module names in the source folder. If a Module does not exist in the target folder, this will automatically be created during Module replacement.

  • The target folder may only include ModuleAttributes whose names match the ModuleAttribute names in the source folder. If a ModuleAttribute does not exist in the target folder, this will automatically be created upon replacement.

  • All ObjectControls of the source folder must be of the same type as the ObjectControls of the target folder.

Prerequisites for multi-user environments

Procedure

  1. Select the Module (Module folder), from which the information should be copied and keep the left mouse button pressed.

  2. Drag the selected object over the object whose Module definition should be replaced while keeping the Shift key pressed.

  3. Release the left mouse button.

  4. If you had selected a Module in the previous steps, the Module Definition is automatically replaced. If however you had selected a Module folder, you have to select the option Replace Module Definitions from the subsequent dialog.

Replace Module Definitions

A warning message will appear if a Module definition cannot be replaced due to prerequisites that are not fulfilled.