Creating a project snapshot from an existing project or project snapshot

Creating a project snapshot creates a new instance of the project and the objects that you choose to snapshot. The snapshot is not a copy; it is a new, executable instance of a project.
Note: The management console does not display snapshots for projects after the first 999 projects.
  1. Click the Edit icon beside the project or project snapshot that you want to snapshot:
    • To snapshot the default project snapshot, in the projects list (Projects), click the Edit icon Edit icon beside the top-level snapshot.
    • To snapshot a nondefault project snapshot, click the Snapshot icon Snapshot icon. The Snapshot view displays the project snapshots in the set. Click the Edit icon Edit icon beside the nondefault project snapshot.
  2. Click Create New Snapshot.
  3. At Name on the Snapshot tab, enter the snapshot name.

    The name must be unique within a project snapshot set. The name is assigned to all the objects that you snapshot with the project.

  4. Select the Build Forge objects to snapshot when you create the project snapshot. The objects that you can select are described in the following table.
    Object Description
    Default In the UI, the default project snapshot is displayed at the top-level of the projects list.

    Select Projects or Jobs > Start to display the projects list.

    Include Project Environments Snapshots the project and step environments in the project.
    Follow Environment Includes If Include Project Environments is selected, also snapshots any other environments that are included by an environment variable of type Include.
    Include Project Selectors Snapshots the project and step selectors that you have included in the project.
    Follow Selector Includes If Include Project Selectors is selected, also snapshots any other selectors that are included by a selector property of type Include.
    Clone Project Adaptor Links Copies the adaptor link as part of the snapshot.

    The adaptor link adds an adaptor into the project. The adaptor runs as the first step (step 0) in the project.

    Clone Project Registers Copies the project registers as part of the snapshot.
    Clone Project Tag Variable Values Copies the tag values for the project tag variables. The tag variables are automatically copied, but their values are not. If you do not copy the tag values, they are reset to 1.
    Clone Project Templates Copies the notification templates for pass and fail notification events that are set at the project level and step level.
    Include Chained Projects Snapshots chained projects or libraries and their steps that are referenced at the project level or step level.

    Chains are triggered by a project pass/fail or a step pass/fail condition.

    Include Project Inlines Snapshots inline projects or libraries and their steps that are referenced at the step level.

    Inlines are triggered by a step and run after the step completes.

  5. Click Save to save the project snapshot.

Feedback