How to: Enable VCS (Version Control System)

Early Access VCS Articles 1. Enable VCS 2. Version Control Dashboard 3. View App Details Page 4. Create a Branch 5. Branch Details Page 6. Create a Pull Request 7. Review & Approve a Pull Request 8. Merge a Pull Request 9. Commenting on a VCS Application

Estimated Reading Time:  5 minutes

Overview

The UDLC VCS (Version Control System) is an optional tool designed for Creators Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. to simultaneously work on the same module(s) in an application at the same time. In the Unqork Designer Platform, turning on VCS for an application is a simple process. You can enable VCS when creating new applications, or turn it on for existing applications.

What You'll Learn

In this article, you'll learn how to turn on VCS for new or existing applications in your workspace. You'll also learn how to reconcile shared modules for VCS compatibility.

Turn on Version Control (VCS) for a New Application

You can enable VCS during the application creation process. After enabling VCS, you must access the UDLC Toolkit to use it.

What You Need

To create a new application with VCS enabled, you need:

• 1 Workspace

Create a New Application with VCS

From the Workspace view:

1.

Click +Create App

2.

In the App Info tab, enter the required application information, including App Name, App Path, App Type, and App Entry Point.

3.

Click Version Control (VCS).

4.

Set VCS (optional) to (ON).

5.

Click Create.

Once the application is created, the page redirects to the UDLC Toolkit login screen. After logging in, the application's VCS App Details page displays.

Turn on Version Control (VCS) for an Existing Application

You can enable VCS for an existing application in the application tile's settings menu. After enabling VCS, access to the UDLC Toolkit is required to use it.

WARNING  VCS does not support WSRBAC Shared Elements. You can enable VCS for applications with shared elements, but you must reconcile shared modules before using VCS. See the Managing Shared Elements in a VCS Application section for more information.

From the Workspace view:

1.

Navigate to the application tile and click the ··· (ellipsis) button.

2.

Click Settings. The App Settings modal A modal is a window that appears on top of the content you are currently viewing. displays.

3.

Click Version Control (VCS).

4.

Set VCS (optional) to (ON).

5.

Click Save. The Workspace refreshes and the the VCS icon and the View App in VCS selection displays on the application tile.

Click on the application tile or View App in VCS to redirect to the UDLC Toolkit login screen. After logging in, the application's VCS App Details page displays.

Managing Shared Elements in a VCS Application

Modules with shared elements must be converted to a main modules to be compatible with VCS. After enabling VCS for an application with shared elements, the App Details page displays the Library Modules tab under Not VCS Enabled. All other App Details tabs are disabled until modules with shared elements are reconciled.

VCS Library Modules List

The VCS Library Module Modules List displays when turning on VCS for applications that contain modules with shared elements. After resolving all shared elements, the App Details tool becomes available and the Library Modules page becomes unavailable.

	Setting	Description
1	Module	The name of the module.
2	Last Modified	The last time the module was modified by a user.
3	Shared In	This value represents the total number of applications where this module is shared.
4	Keep	Click to convert the shared module to a main module. Converted modules are unshared from all environments. NOTE  If VCS is disabled later, converted modules can be re-shared with other applications.
5	Remove	Removes the module from the list and application. The module remains available to applications where it has been shared.
6	View Connected Apps	Click to display the module's Shared Workspace and Application List.

Shared Workspace and Application List

The Workspace and Application List displays shared modules connected to Applications and Workspaces. From this list, you can disconnect individual applications or view the application's workspace.

Setting	Description
Added To	The application name where the module has been shared.
Workspace	The workspace name that contains the application where the module has been shared.
Disconnect	Removes the shared module from the application. To disconnect the shared module from all other applications and workspaces simultaneously, use the Remove button on the Library Modules page.
Go to App	Opens the application workspace in a new tab.

Reconciling Shared Modules

Reconciling shared modules is required to begin using VCS. Careful consideration should be taken when determining the scope of applications affected by converting a shared module to a main module.

These instructions assume you have enabled VCS on an application containing shared modules.

To reconcile shared modules in a VCS application from the workspace page:

1.

Click the application's View App in VCS button. The View App Details Library Module page displays.

2.

From the Library Modules List, click Keep to unshare the module from all applications and workspaces.

3.

(Optional) Click Remove to remove the module from the VCS application. The module remains accessible in all other applications where it is shared.

4.

Repeat this process until all shared modules are reconciled by converting them to main modules, or removing them from the app.

Once all shared modules are reconciled, the App Details page becomes available, and new branches can be created.

Resources

• How to Enable VCS for an application.

• Learn about the Version Control Dashboard.

• Learn about the VCS App Details page.

• Learn how to create a new branch using VCS.