Description

AccuRev is a client- and server-based source configuration management tool developed by AccuRev Inc. and maintained by MicroFocus. Use the AccuRev Source Configuration plug-in to create component versions from the following AccuRev artifact sets: promote transactions, issues, snapshots, and workplaces.

Quick Info

Product
HCL Launch
Type
plugin
Compatibility
HCL Launch version 7.0 or later
Created by
HCL Software
Website
Updated Date
March 23, 2021
Version Name Modified date Action

9.1100795

launch-accurevsourceconfig-9.1100795.zip 16-Mar-2021 11:42

launch-accurevsourceconfig-9.1100795.zip

9.1100795


Summary

The AccuRev source configuration plugin supports creating components from AccuRev promote transactions, issues, snapshots, and workspaces.

Compatibility

This plugin requires HCL Launch version 7.0 or later.

To use this plugin, you must install the AccuRev accurev command-line tool on the runtime agent. See the CLI User’s Guide for command details.

Installation

See Installing plugins in HCL Launch for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
9 Resolved class (FileListerBuilder$Permissions) not found dependency issue. (APAR PH24084)

Usage

The AccuRev source configuration plugin is used to import various artifact sets from AccuRev SCM. To use this plugin, create a component to define the ACCURev artifacts to be used. The component contains the information for importing the artifacts and any processes to perform on the artifacts.

To create a component by importing from AccuRev, complete the following steps. For more information, see Creating components.

  1. On the Components page in HCL Launch, click Create New Component.
  2. In the Source Config Type list, select AccuRev.

  3. Complete the settings required to import the desired artifacts. See the Setting tab for descriptions.
  4. Click Save.
  5. Click the Versions tab for the component.
  6. Click Import New Versions.

Manual import settings

Manual Import Properties
Name Description
Version Name Tag The value to identify specific imports.
Transaction Numbers One or more promote transaction numbers to import. The default is to import the latest functionality.
Issue Numbers One or more issue numbers to import. The default is to import the latest functionality.
Stream Snapshot One or more snapshots to import. The default is to import the latest functionality.

Import settings

The AccuRev plugin enables version imports of various artifact sets. Configure your desired component versions using the following settings to import specific artifact sets based on the Depot and Stream settings.

  • Import Issues
  • Import Promote Transactions
  • Import Snapshots

Any combination of the three properties can be enabled. If you specify a workspace in the Stream property, the import properties are ignored. In a Workspace, artifacts have not been saved to a Stream, and thus, promote transactions, issues, and snapshots will not exist.

If using the automatic import feature, the latest identified artifact set is imported for each type.

If using the manual import feature, you can specify a transaction, issue, or stream value to import a desired version. You can specify one or more values for each property.

Steps

The following process steps are available in the AccuRev plugin.

Import Version

Use this step to create a new component version and imports artifacts from AccuRev.

This step has no input properties.

Roles

The plugin adds the following roles automatically to resources. You cannot add these roles manually.

AccuRevComponentProperties

Properties for the AccuRevComponentProperties role
Name Type Description Reference
AccuRev Executable Path String Full path to the AccuRev executable on the agent’s file system. ${p:component/AccuRevComponentProperties/accurev}

AccuRev URL String Full URL for the AccuRev server. The hostname and port can be identified by running the accurev info command locally. ${p:component/AccuRevComponentProperties/serverUrl}

Depot String The depot to retrieve artifacts from. ${p:component/AccuRevComponentProperties/depot}

Excludes String A list of files to exclude during artifact import. ${p:component/AccuRevComponentProperties/excludes}

Import Issues Boolean Import the latest issue change set artifacts on automatic import. Artifacts continue to be retrieved if the issue number is specified on manual import. Only valid for a non-workspace stream. ${p:component/AccuRevComponentProperties/importIssues}

Import Promote Transactions Boolean Import the latest Promote Transaction artifacts on an automatic import. Artifacts will still be retrieved if the Transaction number is specified on manual import. Only valid for a non-workspace stream. ${p:component/AccuRevComponentProperties/importTransactions}

Import Snapshots Boolean Import the latest snapshot artifacts on an automatic import. Artifacts will still be retrieved if the snapshot name is specified on manual import. Only valid for a non-workspace stream. ${p:component/AccuRevComponentProperties/importSnapshots}

Includes String A list of files to include during artifact import. ${p:component/AccuRevComponentProperties/includes}

Password Password The password of the user with permissions to access the AccuRev Depot and Stream. ${p:component/AccuRevComponentProperties/password}

Preserve Execute Permissions Boolean Save the file execute permissions with files. ${p:component/AccuRevComponentProperties/saveFileExecuteBits}

Stream String A stream or workspace to retrieve artifacts from. If a value is not specified, the Depot name is used. If a workspace is specified, the checkboxes and manual import values for Promote Transactions, Issues, and Snapshot are ignored. A version is created based on the runtime timestamp and file contents of the workspace. ${p:component/AccuRevComponentProperties/stream}

Username String A user with permissions to access the AccuRev Depot and Stream. ${p:component/AccuRevComponentProperties/username}

AccuRevImportProperties

Properties for the AccuRevImportProperties role
Name Type Description Reference
Issue Numbers String One or more issue numbers to import. This setting is valid for non-workspace streams. Separate multiple issue numbers with commas. For example: 5, 16, 27.
Stream Snapshots String One or more stream snapshots to import. This setting is valid for non-workspace streams. Separate multiple snapshots with a comma. For example: snap-stream1, snap-stream2.
Transaction Numbers String One or more promote transaction numbers to import. This setting is valid for non-workspace streams. Separate multiple transaction numbers with commas. For example: 80, 120, 184.
Version Name Tag String The tag to append to the name of a version.