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:

ini

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

toml

[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:

ini

versionone.timebox_name = Sprint 2014-09-22

toml

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’:

ini

versionone.project_name = important_project

toml

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:

ini

versionone.timezone = America/Los_Angeles

toml

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)