Skip to content

docs: document Azure DevOps custom field mappings and the @CurrentIteration token - #16353

Open
paulOsinski wants to merge 1 commit into
DefectDojo:devfrom
paulOsinski:docs/azdo-current-iteration
Open

paulOsinski wants to merge 1 commit into
DefectDojo:devfrom
paulOsinski:docs/azdo-current-iteration

Conversation

@paulOsinski

Copy link
Copy Markdown
Contributor

Summary

Documents custom field mappings on the Azure DevOps Boards connector page, which previously stopped at the status mapping.

New Custom Field Mappings section covers:

  • Vendor Field must be the Azure DevOps field reference name (e.g. System.AreaPath, Custom.MyField), and the field must exist on the work item type in the project's process.
  • Routing work items to a team's backlog with a static System.AreaPath mapping.
  • The @CurrentIteration / @CurrentIteration(Team Name) token on System.IterationPath, which DefectDojo resolves at push time into the team's currently active sprint (feature in DefectDojo-Inc/go-integrators#283, same release line and milestone).
  • The visibility prerequisite that work item types must belong to a backlog level before pushed items appear on any board or backlog.

Also adds a note under Status Mapping Details that the mapped state values must exist on the work item type in the project's process (e.g. Scrum-process projects have no To Do on every type).

All of these are points customers have tripped over in support; each paragraph answers a question from a real ticket.

🤖 Generated with Claude Code

…ration token

The Azure DevOps Boards connector page stopped at the status mapping, leaving
the three things customers actually trip over undocumented: vendor fields must
be reference names that exist on the work item type, states must exist in the
project's process, and work items only appear on team boards when the Issue
type belongs to a backlog level.

Add a Custom Field Mappings section covering those, the System.AreaPath team
routing pattern, and the new @currentiteration / @currentiteration(Team Name)
token that DefectDojo resolves at push time into a team's active sprint.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@paulOsinski paulOsinski added this to the 3.4.200 milestone Oct 14, 2026
@github-actions github-actions Bot added the docs label Oct 14, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant