Proposal for Update board column function

[mammabear123]

Hi Alexander,

I'm still finishing off my evaluation of this change - but it certainly seems to work. However, I'd love your feedback on my approach and whether or not you think it 'fits' with the current code. I'd especially like to hear if you think I should have gone about this a different way.

The main complication is that the kanban column (see references) does not exist until after the work-item is created. For this reason I've chosen to only update the value in the 'last' revision. I also elected not to support setting the board column value for items with only a single revision as this would add unwarranted extra complexity - in most cases, these will be in the New column and will appear there by default anyway)

It is based on the following references:

• https://stackoverflow.com/questions/56165538/how-to-modify-boardcolumn-field-of-a-work-item-using-rest-api
• https://stackoverflow.com/questions/63521786/azure-devops-boards-rest-api-move-ticket-between-columns
• https://github.com/microsoft/azure-devops-dotnet-samples/blob/7af1c874215e79f628db9c849f99b69035c05724/ClientLibrary/Samples/WorkItemTracking/WorkItemsSample.cs#L1105C52-L1105C52

[Alexander-Hjelm]

@mammabear123 Is this PR ready for merging now? It seems like both of my comments have been addressed. I had a quick look now and everything seems good!

Many thanks as always :)

[mammabear123]

Oops I closed the wrong one :(

[mammabear123]

@mammabear123 Is this PR ready for merging now?

It could be but I'm not sure.

All of the user reports I've looked into so far have been a failure to set up the ADO project with Board Columns in accordance with their configuration file. Importantly, this includes getting the Area Path correct, as ADO must/will validate against the Board that the card would appear on. What's more, if something is wrong, ADO just silently ignores it, and hence so does the migration tool. We have had no reports of this code causing regression of anything else though.

However, there are some reports that I haven't had a chance to investigate yet. It's up to you whether you want to wait for me to get around to that or not. I also haven't written any documentation for this feature yet, as you requested. So if you want to wait for that, then you'll have to wait for that :)

I would strongly recommend a clear note that this will only work if your ADO Board is set up correctly. And to double check the columns' name and status configuration, as well as area-path of your board if things go wrong. Many users have run into this issue perhaps even most.