Home
Developing
Learn how to develop software with HCL VersionVault and HCL VersionVault Remote Client.
Developing software with HCL VersionVault Explorer
HCL VersionVault provides two clients for software developers: local and remote. Each client supports different mechanisms for accessing source-controlled filesystem objects. Both clients provide graphical and command-line interfaces.
Working in the team environment with HCL VersionVault
The HCL VersionVault Explorer supports a variety of team development tasks.
Working with resources under HCL VersionVault source control
You can use UCM or base VersionVault to share your work with a team.
Using base VersionVault
Unstructured access to VersionVault tools is provided by base VersionVault.
Modifying resources in a VersionVault view
The workflow for modifying resources in a VersionVault view involves checking them out and checking them in.
Finding resources that need to be merged
Use the VersionVault Merge Manager to find resources in a VersionVault view that need to have changes merged from a version in a VOB.

Developing
Learn how to develop software with HCL VersionVault and HCL VersionVault Remote Client.
- Developing software with HCL VersionVault
  HCL VersionVault provides a flexible set of tools that your organization uses to implement its development and change management policies.
- Developing software with HCL VersionVault Explorer
  HCL VersionVault provides two clients for software developers: local and remote. Each client supports different mechanisms for accessing source-controlled filesystem objects. Both clients provide graphical and command-line interfaces.
  - Team software development with VersionVault
    HCL VersionVault provides configuration management services that make it easy for development teams to work with resources in a shared repository. With the HCL VersionVault Explorer, developers can access HCL VersionVault from a variety of network connections, including broadband (WAN) and traditional local area networks (LANs).
  - Working in the team environment with HCL VersionVault
    The HCL VersionVault Explorer supports a variety of team development tasks.
    - Using the HCL VersionVault Explorer
      You can use the HCL VersionVault Explorer with UCM or base VersionVault.
    - Using the HCL VersionVault Explorer for Eclipse
      You can use the HCL VersionVault Explorer for Eclipse with UCM or base VersionVault.
    - Setting HCL VersionVault Explorer preferences
      Before you begin working with the HCL VersionVault Explorer, review and, if necessary, change the application's default preferences.
    - Connecting to an HCL VersionVault (WAN) server
      If you are using a Web view or automatic view, you must connect to an HCL VersionVault (WAN) server to access resources in VersionVault repositories.
    - Disconnecting from a server or user database
      In some circumstances, you might want to disconnect from a VersionVault WAN server.
    - Removing a server
      You can remove a server from the VersionVault Navigator if you no longer want it to appear in the VersionVault Navigator.
    - Creating a VersionVault view
      Create a VersionVault view to access resources in VersionVault repositories.
    - Mounting VOBs
      Mount (or activate) VOBs to access source files from a view.
    - Unmounting VOBs
      When using dynamic views, you may want to unmount (or deactivate) a VOB.
    - Starting Dynamic views
      Start an existing Dynamic view to access source files.
    - Ending Dynamic views
      You can deactivate a Dynamic view by ending it.
    - Exploring VersionVault repositories
      Use the VersionVault Navigator and VersionVault Details view to explore VersionVault repositories and views.
    - Loading resources into a VersionVault view
      To work with resources in a VersionVault Web view or snapshot view that are under VersionVault source control, load them into the view. Load rules are optional for automatic views and inapplicable to dynamic views.
    - Adding resources to HCL VersionVault source control
      Use the Add to Source Control dialog box to add view-private resources to HCL VersionVault.
    - Working with resources under HCL VersionVault source control
      You can use UCM or base VersionVault to share your work with a team.
      - Using UCM
        Unified Change Management (UCM) is a structured development process that is based on HCL VersionVault tools.
      - Using base VersionVault
        Unstructured access to VersionVault tools is provided by base VersionVault.
        Creating a base VersionVault view
        Use the VersionVault View Creation wizard to create a base VersionVault view.
        Using VersionVault dynamic views
        You can use VersionVault dynamic views in the HCL VersionVault Explorer to access and manage resources under VersionVault source control.
        Using VersionVault web and automatic views
        You can use a VersionVault web view or automatic view in the HCL VersionVault Explorer to access and manage VersionVault elements through an HCL VersionVault WAN server.
        Modifying version selection rules
        Each VersionVault view has a set of version selection rules, which specify the versions of elements to display in the view.
        Updating a VersionVault view
        Update a VersionVault snapshot, web, or automatic view to load the element versions selected by the view's config spec. Update also synchronizes a UCM view with its stream. Dynamic views never need updating: they are always up to date
        Updating a resource in a VersionVault view
        Update a resource in a VersionVault web view, automatic view, or snapshot view to load the version selected by the view's config spec.
        Viewing the version tree of a resource
        Use the VersionVault Version Tree view to see the version tree of a resource and to perform VersionVault operations (such as check in, check out, and apply label) on specific versions.
        Locating objects in the Version Tree Browser view
        Use the Locate dialog in the VersionVault Version Tree view to find objects in the version tree of a VersionVault resource. You can search for specific versions, branches, labels, or activities that contain the that text you specify.
        Modifying resources in a VersionVault view
        The workflow for modifying resources in a VersionVault view involves checking them out and checking them in.
        Controls in the checkout dialog box
        Check out a resource when you want to modify it.
        Checking out resources
        Check out resources when you want to modify them.
        Checking in resources
        Check in resources to commit your modifications to the repository (VOB).
        Canceling a checkout
        Cancel a checkout if it was not needed or to discard your changes.
        Hijacking files
        Hijack a file when you need to modify it when you cannot connect to a server.
        Canceling a hijack
        Cancel a hijack if it was not needed or to discard your changes.
        Converting hijacked files to checkouts
        You must convert hijacked files to checked-out files before you can check them in.
        Finding modified files
        Use VersionVault Search to find files that have been checked out, hijacked, or that have not been added to source control.
        Deleting resources
        You can use the VersionVault Navigator or VersionVault Details view to delete resources under VersionVault source control. On Windows systems, you can also perform this operation from Windows Explorer. The resources are not, in fact, deleted: they are only uncataloged from the current version of the directory and can be recovered from the predecessor version of the directory.
        Moving resources
        You can use the VersionVault Navigator or VersionVault Details view to move resources under VersionVault source control. On Windows systems, you can also perform this operation from Windows Explorer. This operation affects resources (versions) in the local VersionVault view and elements in the VOB.
        Renaming resources
        You can use the VersionVault Navigator or VersionVault Details view to rename resources under VersionVault source control. These operations affects resources (versions) in the local VersionVault view and elements in the VOB.
        Finding resources that need to be merged
        Use the VersionVault Merge Manager to find resources in a VersionVault view that need to have changes merged from a version in a VOB.
        Listing the history of a resource
        List the VersionVault history of a resource to see comments and other metadata associated with changes to the resource.
        Using tools to compare and merge files and directories
        With the HCL VersionVault Explorer you can compare or merge files and directories.
        Exploring VersionVault metadata in base VersionVault VOBs
        Use the VersionVault Navigator and the VersionVault Details views to explore VersionVault metadata in base VersionVault (non-UCM project) VOBs.
      - Working disconnected
        When you choose to work disconnected, actions that require a server connection are disabled and you are not prompted to connect when you attempt to perform them. You can work disconnected from a VOB server (in the case of a snapshot view) or from the VersionVault WAN server (in the cases of a web view or automatic view).
    - Working with ACLs
      You can create, edit, and remove ACL policies and rolemaps using the VersionVault Explorer.
    - Creating a working set
      To create a working set in the VersionVault Navigator view, complete the following steps.
    - Maintaining your VersionVault environment
      This section provides descriptions of HCL VersionVault Explorer maintenance tasks.
  - Team support for the HCL VersionVault Explorer interface
    The HCL VersionVault Explorer provides graphical user interfaces to VersionVault tools.

Finding resources that need to be merged

Use the VersionVault Merge Manager to find resources in a VersionVault view that need to have changes merged from a version in a VOB.

About this task

The VersionVault Merge Manager works as follows:

It considers a set of versions, which you specify on the Select Elements for Merging page of the VersionVault Merge Search wizard.
For each of these versions, the merge manager examines the relationship between the version in the target view and a from-version selected using criteria you specify on the Specify selection criteria and merge options page. It determines whether a merge is required from that version to the version in the target view.
The merge manager then displays the list of merge candidates in the Merge Manager Search Results view. Some merge candidates can be merged automatically. Others must be merged manually, using VersionVault tools or, in the HCL VersionVault Explorer for Eclipse, Eclipse tools.

You typically use the merge manager with base VersionVault, before you check in resources that may have modifications that conflict with ones you have made. If you use UCM, the Rebase Stream and Deliver from Stream operations subsume merge manager functionality for most use cases.

Procedure

To start the merge manager:

In the VersionVault Navigator, select the VersionVault view in which you want to search for resources that may need to be merged.
The view you select will be used as the target view for the merge.
Click the VersionVault Merge Search icon on the VersionVault advanced toolbar.
In the VersionVault Merge Search wizard, specify merge search options.
When the search is complete, examine the results in the Merge Manager Search Results view and specify how to carry out any required merges.

Results

If you choose to manually start a merge, the default tool associated with the object type starts. You can change which tool starts by default for different types on the Compare/Merge preferences page.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.