How to create an extension for branch policy?

[mesuttalebiacerpro]

Hi There,

I want to create an extension for branch policies to check for Jira WorkItem link in description?

Or maybe force adding Jira WorkItem link in another field like what we use for WorkItemID?

any Suggestion? or is it possible at all?

[bryanbcook]

There is documentation on how to setup a custom pull request server. I've done something recently using the same concepts but using a C# Function App to handle the webhooks.

At a high-level:

1. You define a "Custom Status" in your Branch Policy and give it a name like "jira/work-item". Set this status as required to ensure that all pull requests meet this requirement.
2. You define a webhook that calls out to your function app.
3. Your function app receives the details of the pull request in the webhook payload, and you perform your custom logic there. You post a custom status for "jira/work-item" back to your pull request to indicate the outcome of the check.

By default, the custom check appears like any other branch policy requirement. If you want to add custom drop-down options to that policy check, there is an example here that targets the fabricam/ci-service custom status.