Public/Set-JSMRequestTransition.ps1
|
function Set-JSMRequestTransition { <# .SYNOPSIS Transitions a Jira Service Management request to a new status. .DESCRIPTION Performs a customer transition through POST /rest/servicedeskapi/request/<key>/transition. Get the available transition ids with Get-JSMRequestTransition. .PARAMETER IssueKey The issue key or id of the request, for example SD-42. .PARAMETER TransitionId The id of the transition to perform. .EXAMPLE Set-JSMRequestTransition -IssueKey 'SD-42' -TransitionId '761' Performs transition 761 on request SD-42. .OUTPUTS None. Jira returns no content for a successful transition. #> [CmdletBinding(SupportsShouldProcess = $true)] param ( [Parameter(Mandatory = $true)] [ValidatePattern('^([A-Za-z][A-Za-z0-9_]*-\d+|\d+)$')] [string]$IssueKey, [Parameter(Mandatory = $true)] [ValidatePattern('^\d+$')] [string]$TransitionId ) $telemetry = Start-TcsTelemetry try { if (-not $PSCmdlet.ShouldProcess($IssueKey, "Perform transition $TransitionId")) { return } $body = @{ id = $TransitionId } $result = Invoke-JiraRequest -Method Post -URIPath "/servicedeskapi/request/$([System.Uri]::EscapeDataString($IssueKey))/transition" -Body $body Write-Verbose "Successfully transitioned JSM request $IssueKey." if ($result) { return $result } } catch { Complete-TcsTelemetry -Token $telemetry -ErrorRecord $_ throw } finally { Complete-TcsTelemetry -Token $telemetry } } |