Azure DevOps¶
You can import tasks from Azure DevOps instance using
the azuredevops
service name.
Example Service¶
Here’s an example of a azure devops project:
[my_issue_tracker]
service = azuredevops
ado.PAT = 1234abcd5678efgh
ado.project = testproject1
ado.organization = testorganization
[my_issue_tracker]
service = "azuredevops"
pat = "1234abcd5678efgh"
project = "testproject1"
organization = "testorganization"
Note
If you look at a work item in the browser, the url should be something like https://dev.azure.com/testorganziation/testproject/_workitems/edit/12345/
The above example is the minimum required to import issues from Azure DevOps. You can also feel free to use any of the configuration options described in Common Service Configuration Options or described in Service Features below.
The PAT (Personal Access Token) can be generated for your project by following https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate
Service Features¶
The following default configuration is used:
ado.host = dev.azure.com
ado.wiql_filter = SELECT [System.Id] FROM workitems
host = "dev.azure.com"
wiql_filter = "SELECT [System.Id] FROM workitems"
Specify the Query to Use for Gathering Issues¶
By default, the Azure DevOps plugin will include all issues in the project, but you can fine-tune the query used
for gathering issues by setting the wiql_filter
parameter.
Please note there is a limit imposed by the Azure DevOps API on the number of workitems you can pull at the same time (20000). If your query exceeds this limitation, the application will produce an error.
A good default would be to only pull ado workitem assigned to yourself. Do that with this query:
configuration option:
ado.wiql_filter = [System.AssignedTo] = @me
wiql_filter = "[System.AssignedTo] = @me"
To select issues only in an active state configuration option:
ado.wiql_filter = [System.AssignedTo] = @me AND [System.State] = 'Active'
wiql_filter = "[System.AssignedTo] = @me AND [System.State] = 'Active'"
Provided UDA Fields¶
Field Name |
Description |
Type |
---|---|---|
adoactivity |
Azure Devops Activity |
Text (string) |
adodescription |
Azure Devops Description |
Text (string) |
adoid |
Azure Devops ID number |
Number (numeric) |
adonamespace |
Azure Devops Namespace |
Text (string) |
adoparent |
Azure Devops Parent Work Item Name |
Text (string) |
adopriority |
Azure Devops Priority |
Number (numeric) |
adoremainingwork |
Azure Devops Amount of Remaining Work |
Number (numeric) |
adostate |
Azure Devops Work Item State |
Text (string) |
adotitle |
Azure Devops Title |
Text (string) |
adotype |
Azure Devops Work Item Type |
Text (string) |
adourl |
Azure Devops URL |
Text (string) |