Code review and feedback field reference in Azure Boards and Azure DevOps
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018 - TFS 2013
You can use the code review and feedback fields to create queries and reports that track the status of these processes. The fields appear in the following work item types, which are included with the default processes for Azure Boards and TFS: Code Review Request, Code Review Response, Feedback Request, and Feedback Response.
Note
If your Azure DevOps or TFS server has been upgraded from an earlier version you might need to update your project to get access to these work item types. See Configure features after an upgrade.
Fields used to track code reviews
The following fields are used to track code review requests and responses. You can only make a Code Review request against code maintained in a Team Foundation version control (TFVC) repository. A code review response is created for each person who provides review comments. See Day in the life of a Developer: Suspend work, fix a bug, and conduct a code review.
Note
Retrieving code review comments programmatically isn't a supported feature.
| Field name | Description | Data type |
|---|---|---|
| Accepted By | The name of the code reviewer. Reference name=Microsoft.VSTS.CodeReview.AcceptedBy |
String |
| Accepted Date | The date and time when the code-reviewer responded. Reference name=Microsoft.VSTS.CodeReview.AcceptedDate |
DateTime |
| Associated Context | The name assigned to the code work requested for review. Reference name=Microsoft.VSTS.CodeReview.Context |
String |
| Associated Context Code | An integer value that captures whether the code review is for 1 (shelveset) or 2 (changeset). Reference name=Microsoft.VSTS.CodeReview.ContextCode |
Integer |
| Associated Context Owner | The GUID assigned to the shelveset owner who requested the code review. Reference name=Microsoft.VSTS.CodeReview.ContextOwner |
String |
| Associated Context Type | The type of code work requested for review: Shelveset or Changeset. Reference name=Microsoft.VSTS.CodeReview.ContextType |
String |
| Closed Status | The status selected by the reviewer when closing the code review request. The number is stored in the system and written to the data warehouse as follows: - 0 — Not Reviewed - 1 - Looks Good - 2 - With Comments - 3- Needs Work - 4 - Declined - 5 - Removed Reference name=Microsoft.VSTS.CodeReview.ClosedStatus |
String |
| Closed Status Code | A value ranging from 0 to 5 that corresponds to the status selected by the reviewer when closing the code review request. Reference name=Microsoft.VSTS.CodeReview.ClosedStatusCode |
Integer |
| Closing Comments | The comment entered by the reviewer when closing the review request. Reference name=Microsoft.VSTS.CodeReview.ClosingComment |
String |
| Reviewed By | The name of the team member who reviewed the code. The State transitions to Reviewed when the code reviewer responds. (Code Review Response) Reference name=Microsoft.VSTS.Common.ReviewedBy |
String |
| Reviewed Date | The date-time stamp when the reviewer closed the request. (Code Review Response) Reference name=Microsoft.VSTS.Common.ReviewedDate |
Date-Time |
| State Code | Mirror field used to track the current state in code. Reference name=Microsoft.VSTS.Common.StateCode |
Integer |
Fields used to track feedback
The following fields track feedback requests and responses. You complete the first three fields in the feedback request form. A feedback response is created for each person and for each item for which feedback is provided. See Get feedback.
| Field name | Description | Data type |
|---|---|---|
| Application Launch Instructions | Instructions to stakeholders on how to start the application. Reference name=Microsoft.VSTS.Feedback.ApplicationLaunchInstructions |
HTML |
| Application Start Information | Guidelines to direct stakeholder feedback. Reference name=Microsoft.VSTS.Feedback.ApplicationStartInformation |
PlainText |
| Application Type | The type of application that stakeholders will provide feedback on. The valid types are specified in the process configuration file, ProcessConfiguration. The default values are Web Application, Remote Machine, and Client Application. Reference name=Microsoft.VSTS.Feedback.ApplicationType |
String |
| Rating | The number of stars that an item receives from a reviewer in a star-based ranking system. (Feedback Response) The number is stored in the system and written to the data warehouse as follows: - 0 — Not Rated - 1 - Poor - 2 - Fair - 3- Good - 4- Very Good - 5 - Excellent Reference name=Microsoft.VSTS.Common.Rating |
String |