GitPullRequestCompletionOptions interface

Package:

azure-devops-extension-api

Preferences about how the pull request should be completed.

Properties

autoCompleteIgnoreConfigIds	List of any policy configuration Id's which auto-complete should not wait for. Only applies to optional policies (isBlocking == false). Auto-complete always waits for required policies (isBlocking == true).
bypassPolicy	If true, policies will be explicitly bypassed while the pull request is completed.
bypassReason	If policies are bypassed, this reason is stored as to why bypass was used.
deleteSourceBranch	If true, the source branch of the pull request will be deleted after completion.
mergeCommitMessage	If set, this will be used as the commit message of the merge commit.
mergeStrategy	Specify the strategy used to merge the pull request during completion. If MergeStrategy is not set to any value, the service selects the first merge strategy not prohibited by the target branch’s policy. If the limit merge type policy is not configured, the default is noFastForward unless the deprecated SquashMerge is true, in which case the default is squash. If an explicit value is provided for MergeStrategy, the SquashMerge property will be ignored.
squashMerge	SquashMerge is deprecated. You should explicitly set the value of MergeStrategy. This flag is only used when MergeStrategy is not specified and the target branch has no merge-strategy policy configured. In all other cases it is ignored.
transitionWorkItems	If true, we will attempt to transition any work items linked to the pull request into the next logical state (i.e. Active -> Resolved)
triggeredByAutoComplete	If true, the current completion attempt was triggered via auto-complete. Used internally.

Property Details

autoCompleteIgnoreConfigIds

List of any policy configuration Id's which auto-complete should not wait for. Only applies to optional policies (isBlocking == false). Auto-complete always waits for required policies (isBlocking == true).

autoCompleteIgnoreConfigIds: number[]

Property Value

number[]

bypassPolicy

If true, policies will be explicitly bypassed while the pull request is completed.

bypassPolicy: boolean

Property Value

boolean

bypassReason

If policies are bypassed, this reason is stored as to why bypass was used.

bypassReason: string

Property Value

string

deleteSourceBranch

If true, the source branch of the pull request will be deleted after completion.

deleteSourceBranch: boolean

Property Value

boolean

mergeCommitMessage

If set, this will be used as the commit message of the merge commit.

mergeCommitMessage: string

Property Value

string

mergeStrategy

Specify the strategy used to merge the pull request during completion. If MergeStrategy is not set to any value, the service selects the first merge strategy not prohibited by the target branch’s policy. If the limit merge type policy is not configured, the default is noFastForward unless the deprecated SquashMerge is true, in which case the default is squash. If an explicit value is provided for MergeStrategy, the SquashMerge property will be ignored.

mergeStrategy: GitPullRequestMergeStrategy

Property Value

GitPullRequestMergeStrategy

squashMerge

SquashMerge is deprecated. You should explicitly set the value of MergeStrategy. This flag is only used when MergeStrategy is not specified and the target branch has no merge-strategy policy configured. In all other cases it is ignored.

squashMerge: boolean

Property Value

boolean

transitionWorkItems

If true, we will attempt to transition any work items linked to the pull request into the next logical state (i.e. Active -> Resolved)

transitionWorkItems: boolean

Property Value

boolean

triggeredByAutoComplete

If true, the current completion attempt was triggered via auto-complete. Used internally.

triggeredByAutoComplete: boolean

Property Value

boolean