VersionOne

You can import tasks from VersionOne using the versionone service name.

Additional Requirements

Install the following package using pip:

  • v1pysdk-unofficial

Example Service

Here’s an example of a VersionOne project:

[my_issue_tracker]
service = versionone
versionone.base_uri = https://www3.v1host.com/MyVersionOneInstance/
versionone.usermame = somebody
versionone.password = hunter5
[my_issue_tracker]
service = "versionone"
base_uri = "https://www3.v1host.com/MyVersionOneInstance/"
usermame = "somebody"
password = "hunter5"

The above example is the minimum required to import issues from VersionOne. You can also feel free to use any of the configuration options described in Common Service Configuration Options or described in Service Features below.

Note

This plugin does not infer a project name from any attribute of the version one Task or Story; it is recommended that you set the project name to use for imported tasks by either using the below Set a Global Project Name feature, or, if you require more flexibility, setting the project_template configuration option (see Field Templates).

Service Features

Restrict Task Imports to a Specific Timebox (Sprint)

You can restrict imported tasks to a specific Timebox (VersionOne’s internal generic name for a Sprint) – in this example named ‘Sprint 2014-09-22’ – by using the timebox_name option; for example:

versionone.timebox_name = Sprint 2014-09-22
timebox_name = "Sprint 2014-09-22"

Set a Global Project Name

By default, this importer does not set a project name on imported tasks. Although you can gain more flexibility by using Field Templates to generate a project name, if all you need is to set a predictable project name, you can use the project_name option; in this example, to add imported tasks to the project ‘important_project’:

versionone.project_name = important_project
project_name = "important_project"

Set the Timezone Used for Due Dates

You can configure the timezone used for setting your tasks’ due dates by setting the timezone option. By default, your local timezone will be used. For example:

versionone.timezone = America/Los_Angeles
timezone = "America/Los_Angeles"

Provided UDA Fields

Field Name

Description

Type

versiononestorydescription

VersionOne Story Description

Text (string)

versiononestorydetailestimate

VersionOne Story Detail Estimate

Text (string)

versiononestoryestimate

VersionOne Story Estimate

Text (string)

versiononestoryname

VersionOne Story Name

Text (string)

versiononestorynumber

VersionOne Story Number

Text (string)

versiononestoryoid

VersionOne Story Object ID

Text (string)

versiononestoryurl

VersionOne Story URL

Text (string)

versiononetaskdescrption

VersionOne Task Description

Text (string)

versiononetaskdetailestimate

VersionOne Task Detail Estimate

Text (string)

versiononetaskestimate

VersionOne Task Estimate

Text (string)

versiononetaskname

VersionOne Task Name

Text (string)

versiononetaskoid

VersionOne Task Object ID

Text (string)

versiononetaskreference

VersionOne Task Reference

Text (string)

versiononetasktodo

VersionOne Task To Do

Text (string)

versiononetaskurl

VersionOne Task URL

Text (string)

versiononetimeboxbegindate

VersionOne Timebox Begin Date

Text (string)

versiononetimeboxenddate

VersionOne Timebox End Date

Text (string)

versiononetimeboxname

VersionOne Timebox Name

Text (string)