.snapshot

Use the .snapshot command to create a new instance of the calling project and store the instance as a project snapshot in the database. A project snapshot is an executable project.
Description
The .snapshot command creates a snapshot of a project and its associated objects that you also choose to snapshot or copy.
Use the .snapshot options to specify the objects to snapshot or copy, as described in the following table. If you do not specify any options, only the project definition, steps, and tags are included.
The snapshot name is required and must be unique to the project snapshot set. The snapshot name is also assigned to the other objects that you snapshot.
After the project that runs .snapshot is completed, the project snapshot is displayed in the UI as a child of the calling project. The other snapshot objects are also displayed in the UI as children of their base snapshot or parent object.
Syntax
.snapshot -v <"snapshot_name"> [-c <"comment">][-e[f]][-s[f]][-pI][-pC]
 [-a][-t][-r][-g]
Option Description
-v <"snapshot_name"> The name of the project snapshot is required. The snapshot name must be unique to the project. You must quote the name.
-c <"comment"> Saves an optional comment as part of the snapshot. You must quote the comment.
-e

-ef

Snapshots the project and step environments when the project snapshot is created.

Adding the f option also snapshots any environments that the snapshot environments include with the Include environment variable type.

-s

-sf

Snapshots the project and step selectors when the project snapshot is created.

Adding the f option also snapshots any selectors that the snapshot selectors include with the Include selector property type.

-pI Snapshots the inline projects or libraries and their steps when the project snapshot is created.

Inlined projects or libraries are triggered by a step and run after the step completes.

-pC Snapshots the chained projects or libraries and their steps when the project snapshot is created.

Projects or libraries can be triggered by a project pass/fail condition or a step pass/fail condition. Snapshots are created for both types of conditionally chained projects or libraries.

-a Copies the adaptor link when the project snapshot is created.

The adaptor link adds an adaptor to the project and runs the adaptor code.

-t Copies notification templates for pass and fail notification events that are set at the project level and step level.
-r

Copies the project registers when the project snapshot is created.

-g Copies the tag values for the project tag variables.

Tag variables are automatically copied, but their values are not. If you do not copy the tag values, they are reset to 1.


Feedback