Issue Tracking Tools (Azure DevOps/Jira)

Overview

Users can create, link and update Azure DevOps issues or Jira Tickets from the TODO items in vFunction Server.

After meeting the Prerequisites, follow the Configuration Steps below to set up the integration. Once configured, all vFunction users can Create Tickets From TODOs via the configured issue tracking tool.

Configuration Prerequisites

Azure DevOps (ADO)

  • An Azure DevOps Account. This can be a standard user and does not need to be an administrator. It is recommended but not mandatory to create a special Service Account user for vFunction since this user will be assigned as the reporter of all issues
  • The Azure DevOps Organization’s Base URL such as https://dev.azure.com/{yourorganization}
  • An Azure DevOps Token to authenticate the Azure DevOps user. Follow the instructions to create a Personal Access Token in the Azure DevOps support page

Jira Cloud

  • A Jira Cloud Account. This can be a standard user and does not need to be an administrator. It is recommended but not mandatory to create a special Service Account user for vFunction since this user will be assigned as the reporter of all issues
  • The Jira Base URL for the organization, such as https://mycompany.atlassian.net
  • A Jira Token to authenticate the Jira user. Follow the instructions to create an API token in the Manage API Tokens Atlassian support page

Configuration Steps

  1. As a vFunction Administrator, log into the vFunction Server UI in a browser
  2. Select Account Settings (the Person icon) in the top-right corner
  3. Select Configuration and Settings in the dropdown menu
  4. Select Configure Apps in the left-hand sidebar
  5. Toggle the Task Management System slider in the Configure Apps popup
  6. In the Workspace Type dropdown, select Azure or Jira
  7. Fill in the following subitems

Azure

  • Token: An Azure Personal Access Token (PAT) used to authenticate the Azure DevOps Account user
  • Org: Your organization name (e.g., MyOrg)

Jira

  • User Name: the email address of the Jira Cloud Account user
  • Token: A Jira Token used to authenticate the Jira Cloud Account user
  • Jira Base Url: The base Url to your Jira cloud site
  1. Click the Integrate Azure button on the bottom-right of the Configure Apps popup. This will perform an API call to Azure DevOps to check the access and if successful the dialog will be closed

Create Tickets From TODOs

  1. Log into the vFunction Server UI and select the relevant application.
  2. Open the TODO List for the application and hover over a specific TODO
  3. Select Open Ticket
  4. Select the Project and Issue from Open Ticket popup (Summary and Description are auto filled but you can modify them)
  5. Fill in the rest of the ticket form (mandatory fields are marked with *) and Click Open Ticket

Once the Ticket is created, you will see details of it in the TODO, including a hyperlink to open the ticket in a new window.

Updated on 01 Apr 2025