Synchronizing data

To synchronize data between a local workspace and a common repository, you can use synchronization mechanisms. This is started via the option Update All (see chapter "Update"). The function Checkout (see chapter "Checkout objects") includes an automatic update. The duration of data synchronization depends mainly on the data volume.

The synchronization management is only available for multi-user repositories.

Update

The Update All option refreshes the current status of all objects contained in the workspace. Any modifications, which have been performed and checked in by other users, are transferred to the local workspace and displayed.

Specifying synchronization behavior settings - Parameter SynchronizationPolicy

You can specify binding settings on the synchronization behavior for all OwnedItems via the property SynchronizationPolicy.

SynchronizationPolicy

The default setting of SynchronizationPolicy is CustomizableDefaultIsOn. Additionally, the following settings are available:

  • CustomizableDefaultIsOn

    If the SynchronizationPolicy is set to CustomizableDefaultIsOn, this object is part of the synchronization by default.

    Exception:

    • If a workspace is either updated or newly created, the synchronization state of new objects having CustomizableDefaultIsOn as SynchronizationPolicy, is set based on the parent object. This is done as follows:

    • If the SynchronizationPolicy of the parent object is set to CustomizableDefaultIsOff, the object is excluded from synchronization.

    • If the SynchronizationPolicy of the parent object is either set to CanNotBeExcludedForWholeTree or CanNotBeExcluded, the object is part of the synchronization.

    • If the SynchronizationPolicy of the parent object is also set to CustomizableDefaultIsOn, its parent object determines according to the same rules.

  • CustomizableDefaultIsOff

    If the SynchronizationPolicy is set to CustomizableDefaultIsOff, this object is excluded from synchronization by default. When a new workspace is created, the content of these objects is not transferred.

  • CanNotBeExcluded

    If the SynchronizationPolicy is set to CanNotBeExcluded, the option Exclude from synchronization is not available in the context menu for this object.

  • CanNotBeExcludedForWholeTree

    If the SynchronizationPolicy is set to CanNotBeExcludedForWholeTree, the option Exclude from synchronization is not available in the context menu for this object and all elements contained.

    Newly created folders automatically receive the SynchronizationPolicy CanNotBeExcludedForWholeTree of the parent folder (This applies only to folders).

The property SynchronizationPolicy is not retained when exporting or importing an object, and is set back to the default value CustomizableDefaultIsOn.

Synchronization - enable/disable

You can exclude every object that can be checked out (OwnedItem) from synchronization between the local workspace and the common repository. Objects which have been excluded from synchronization are no longer part of the local workspace.

In large repositories, this option can help to significantly reduce the duration of the synchronization process.

Disable Synchronization

To disable synchronization, follow the steps below:

  1. Select the required object(s).

    The object must be checked in. Newly created objects can only be excluded from synchronization after they have been checked in.

  2. Select Exclude from Synchronization or Exclude tree from synchronization from the context menu.

  1. The local workspace is being updated after your selection. This procedure may take a few minutes depending on the data volume and infrastructure.

Objects, which are excluded from synchronization, are displayed in light gray and additionally receive the following symbol in the tree view:

TestCases excluded from synchronization

ExecutionEntries, which are linked to TestCases that are excluded from synchronization, are also displayed in gray . If ActualLogsare excluded from synchronization, the Loginfocolumn display changes.

Enable Synchronization

If you have excluded objects from synchronization and want to include them for synchronization, click on the arrow symbol next to the appropriate object.

Alternatively, you can select the option Include for Synchronization from the context menu of the respective object(s).

If enabled, you can select the option Include tree for Synchronization from the context menu.

To do so, set the IncludeTreeForSynchronizationEnabled setting to True in the TOSCACommander.exe.config file.

If you have a large number of objects to include for synchronization, the progress bar repeats itself until the synchronization is fully completed.

Reset Synchronization State

The option Reset exclusions to default for tree is used along with the parameter SynchronizationPolicy. The object receives either the value which is indicated for the SynchronizationPolicy parameter, or the default value CustomizableDefaultsOn.

To reset the synchronization state, follow the steps below:

  1. Select the required object(s).

  2. Select the option Reset exclusions to default for tree from the context menu.

Reset exclusions to default for tree

  1. Tosca Commander refreshes the local workspace according to your selection. This procedure may take a few minutes depending on the data volume and infrastructure.

Including all necessary Items in synchronization

If you select the option Include all necessary Items, all elements required for the selected items are included. This means for instance, that all the TestCases and Modules that are linked to an ExecutionList and are needed for test execution are included.

Alternatively, you can use the key combination Ctrl + Alt + H.

Before you select this option, ensure to synchronize the elements.

Include all necessary Items

Including all necessary Items for tree

This option leads to the same result as "Including all necessary Items in synchronization" and can be additionally applied to all sub-items.

Alternatively, you can use the key combination Ctrl + Shift + H.

Include all necessary Items for tree