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.
The AccuRev source configuration plugin supports creating components from AccuRev promote transactions, issues, snapshots, and workspaces.
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.
See Installing plugins in HCL Launch for installing and removing plugins.
The following table describes the changes made in each plugin version.
| Version | Description |
|---|---|
| 9 | Resolved class (FileListerBuilder$Permissions) not found dependency issue. (APAR PH24084) |
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.
| 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. |
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.
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.
The plugin adds the following roles automatically to resources. You cannot add these roles manually.
| 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}
|
| 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. |
Summary
Usage
Steps
Roles
