VersionOne Integration Plugin
This topic describes how to configure the XL Release VersionOne Integration plugin.
Prerequisites
- Install the VersionOne plugin into the XLR plugins/xlr-official folder
Requirements
- VersionOne 20.0.0+: XL Release 9.5.0+
Server Configuration
- Define an Access Token using the VersionOne UI: Go to
Configuration - Applications
and add a new Application with the nameXLRelease
. UseAccess Token
as an authentication mechanism.
You need to create a Shared Configuration for your VersionOne Server. The Shared Configuration will have the information to connect to your VersionOne Server.
Release Tasks
Create Issue
This task allows you to create new issue in VersionOne. See Asset Types for a list of possible values.
Create Asset
This task allows you to create new asset (Story, Test, Defect, Task) in VersionOne
Get Stories
This task allows you to get a list of the stories available in VersionOne based on a query. There are several examples of queries available on the VersionOne site. For details of the VersionOne query language:
Get Story
Only one story is returned for this task. Details of the story will be contained in the Data field
Update Story Status
Update a story status from the available workspace statuses.
Check Issue Status
Check the issue (Story) by continuous polling until the given VersionOne issue returns an expected status.
The following properties are available:
Server: The VersionOne server where XL Release connects.
Ticket Id: The ID of the ticket to check.
Expected Status List: A list of statuses to check for.
Poll Interval: The time in seconds between each polling action.
The output of the task is finalStatus which is the final status of the ticket on last check.
Check Asset Status
Check asset (Story, Defect, Test, Task) by continous polling until the given VersionOne asset return an expected status.
The following properties are available:
Server: The VersionOne server where XL Release connects.
Asset Type: List of available asset type (Story, Defect, Test, Task).
Ticket: The ticket number of the associated asset type, such as a story number, a defect number, etc.
Expected Status List: A list of statuses to check for.
Poll Interval: The time in seconds between each polling action.
The output of the task is tickets. This is a key-value map that contains the issue IDs (keys) and the summaries (values) of the tickets that were found.
Check Query Status
Check a list of issues by continous polling until the queried VersionOne issues return an expected status.
The following properties are available:
Server: The VersionOne server where XL Release connects.
Asset Type: List of available asset type (Story, Defect, Test, Task).
Query: A VersionOne query that finds the tickets that will be checked in this task.
Expected Status List: A list of statuses to check for.
Poll Interval: The time in seconds between each polling action.
The output of the task is tickets. This is a key-value map that contains the issue IDs (keys) and the summaries (values) of the tickets that were found.
Release notes
XL Release Integration Plugin 9.8.0
Improvements
- [ENG-1528] - Updated product documentation
XL Release Integration Plugin 9.7.0
- [ENG-230] Initial release.