VCS How To: Restore a Previous Module Version in a New Branch

Early Access VCS Articles

1. Enable VCS for an application
2. Version Control Dashboard
3. View App Details Page
4. Create a Branch
5. Branch Details
6. Create a Pull Request
7. Review and Approve a Pull Request
8. Merge a Pull Request
9. Commenting on a VCS Application

 

Overview

To restore the previous version of a main module in a VCS-controlled application, use the Restore To Previous Version action during the Create Branch process. Restoring a module in a branch makes it available for editing by Owners and Contributors.

What You'll Learn

After completing this article, you'll understand the Restore Previous Version History Panel. You'll also know how to restore a main module in a VCS branch.

About the Restore Previous Version History Panel

On the Create Branch page, the Version History panel displays when restoring previous versions of a main module. This panel contains a list of previous versions that can be viewed or selected for restoration.

A static image displaying the UDLC VCS tool's Version History window.

The Version History panel contains the following fields:

Setting Description

Application Name

The name of the application containing the branch history.

Last Modified

Displays the last user to modify the branch and the date/time of the modification.

Branch

The unique ID of the current and previous branches.

Last Save

Displays the current and previous branch's date and time it was last saved.

Last Saved By

The last user to modify the current or previous branch.

Actions

Displays a list of options for current or previous branches:

  • View: Opens the VCS Version History tool.

  • Select: Opens the Create Branch tool on a new page and adds the previous branch version of the module to the Modules to Restore in Branch list. This option is not available for the current (main) branch.

Restoring a Previous Version of a Module in a New Branch

In a VCS-controlled application, use the Create Branch page to restore previous versions of a mainmodule. After creating a branch, restored modules become available for editing by the Owner and Contributors. After completing the edits, it is ready to be submitted to the Main Branch using a Pull Request. After review, approval, and merge, the new module becomes a main module.

Module modifications made in a branch cannot be restored using the Create Branch Version History panel.

This example assumes you have access to a VCS-controlled application.

To learn how to enable VCS, view our How to: Enable VCS (Version Control System) article.

From the Workspaces page:

1. Find and open a workspace that contains a VCS-enabled application.
2. Click the application's View App in VCS button. The UDLC Login page displays.
3. Enter your credentials and click Login. The View App Details' Branches page displays.
4. Click + Create Branch. The Create Branch page displays.

5. In the Branch Name* field, enter a name for the branch.
6. From the Main Modules grid, find the module you want to branch and click Action ▾.
7. Select Restore to Previous Version. The Version History panel displays.
8. Find a previous module version you want to restore and click Select. The Version History panel closes, and the module moves from the Main Modules list to the Modules to Restore in Branch list.

A static image dispolaying the Create Branch Version History Panel, the Select button for a previous module version is highlighted.
(click image to enlarge)

9. Under Participants, click Show Advanced Settings.
10. Set Owner Can Approve Pull Requests to Checked Box icon (Checked).

This setting allows the Owner to review and approve the branch's Pull Request. Outside of testing, the use of this setting should be determined by your organization.

11. In the Please Document Reason field, enter a reason for creating this branch.

12. Click Create. A modal displays informing you the branch has been successfully created.
13. Click OK. The Branch Details page displays.

Resources