Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Introduction:

This guide outlines the quick and easy process of adding and editing Azure Boards connections in PSknowHOW application.

Add Connection

To add new Azure Boards connection:

  • Click on the From the drop-down menu, select "Azure Boards," and then click on "New Connection." button.A pop-up window will open then select connection type Azure Boards.

...

  • Fill in all the required fields to save connection otherwisethe connection. If any mandatory field is left empty, a validation message will be shown displayed below the mandatory field textboxrespective text box.

  • Save the connection by clicking on the "Save" button.

...

...

  • Is Connection Private:

To make the connection private, tick the checkbox labeled "Private" This ensures that the connection is only accessible and visible to authorized users,

Azure Boards Connection Fields Description:

Field Name mandatory

Sample Values

Field Description

Affected KPI

Connection Name

This field provides a name for connection detail.

Base Url *

https://dev.azure.com/sundeepm/AzureSpeedy

Azure URL

All Azure Boards based KPIs in case of online method.

User Name

Username *

Azure username to access Azure Boards data

All Azure Boards based KPIs in case of online method.

PAT*

Azure PAT access token to access Azure Boards data.

All Azure Boards based KPIs in case of online method.

Saved Once saved successfully, the new Azure Boards connection will be shown under connection displayed under the "Connections" tab on the connections screen:.

...

Edit Connection

...

  1. Click on the edit icon of

...

  1. the Azure Boards connection under the

...

  1. "Connection Type" tab on the connections screen (refer to the above screenshot)

...

  1. . A pop-up window will open

...

  1. .

  2. Edit and update the existing connection details as required.

...

  1. To save

...

  1. the new connection

...

  1. or the updated details, click on the "Save" button on the "Connection Details" popup.

...

Prerequisites

Area

Behavior

Guideline

Sprint Status

Last available sprint of the project will show as CURRENT as long as subsequent sprints are not defined, even when the sprint’s end date is out of sync with the calendar date

  •  Projects using Azure Boards must create future sprints in advance to avoid data discrepancies
  •  KnowHOW will generate sprint snapshots based on the Sprint Status only, i.e., a sprint will be considered as Active as long as the status is CURRENT in Azure Board, irrespective of the end date of the sprint

Area Path

If workitems are tagged across different area paths and the area paths are not included in the WIQL, KnowHOW will not fetch those as they don’t satisfy the criteria

At KnowHOW, project boards should be configured in such a way that it requires minimal updates

Scope Changes

Daily snapshots are formed at KnowHOW during an active sprint.
The final snapshot is frozen on closure of the sprint.

  •  KnowHOW compares the latest snapshot with the previous day’s snapshot to determine the following scope changes
  1. Workitems added

  2. Workitems removed

  •  Snapshot captured on Day 1 of the sprint is considered the Initial Scope of the sprint
  •  The sprint snapshots will not get update based on changes that happen after the sprint is completed

Scope Completion

  •  KnowHOW compares the latest snapshot with the previous day’s snapshot to determine the following
  1. completed workitems

  2. not completed workitems

Spilled issues

Not supported