Allow to Update-VSTeamWorkItem to add relations with other work items

[mnieto]

PR Summary

This PR is related to #518
Adding the below changes around the Update-VSTeamWorkItem to enable adding relations to another workitems. This could be achived using:

• Update-VSTeamWorkItem: allows mix field changes and relations changes
• *-VSTeamWorkItemLink: allow a simplified way to manage relations of a work item

Proposed added/modified cmdlets:

• Update-VSTeamWorkItem: add a -Relations parameter
• Get-VSTeamWorkItemRelationTypes: list Relations types. Paramerters:
  • Usage: All|resourceLink|workItemLink. Default workItemLink
• New-VSTeamWorkItemRelation: Helper cmdlet that creates an in-memory object to facilitate building the -Relations parameter in Update-VSTeamWorkIte. Parameters:
  • Id Work item to be modified
  • RelationType: Values got from dynamic parameter
  • RelatedWorkItemId Related work item id
  • Operation Add|Remove|Replace
• Add-VSTeamWorkItemLink Parameters:
  • Id workitem to be modified
  • RelationType: Values get from dynamic parameter
  • RelatedWorkItemId Related work item id
• Get-VSTeamWorkItemLink Parameters
  • Id workitem to be modified
  • RelationType Optional. If not specified, return all relations in -Id
• Remove-VSTeamWorkItemLink Parameters
  • Id workitem to be modified
  • RelatedWorkItemId Related work item id

All the above cmdlets will work internally with a JsonPatchDocument or compatible object. Also, below cmdlets will return this object/collection of objects respectively. Using this aproach, the -Relations paramter in the Update-VSTeamWorkItem can be built with the help of New-VSTeamWorkItemRelation or directly as the example at the very beginning of this thread.

• New-VSTeamWorkItemRelation
• Get-VSTeamWorkItemLink

PR Checklist

• Write Help
• Write Unit Test
• Update CHANGELOG.md

[SebastianSchuetze]

I guess you are still in development, correct?

[mnieto]

I guess you are still in development, correct?

Yes, this is the first of multiple commits. Once it's ready I'll change the PR from draft

[SebastianSchuetze]

Yes. I didn't see the draft part. 😎

[mnieto]

@SebastianSchuetze Do will finally merge this PR? Do you need some clarification or changes from my side before accepting the PR?

[mnieto]

the actions actions-pipeline.yml is failling now. @SebastianSchuetze do you will fix this? or if you prefer I can create a separate PR to update the action versions

[SebastianSchuetze]

I actually just wanted to remove the review Tag somehow. I am off the project and and Donovan for a while as well.

Basically this project is dead. Sorry 😐