Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

 

This page provides information about Approval JQL Functions.

 

The add-on provides a set of useful JQL functions to filter on the tickets:
  • pendingForApproval()
  • pendingForUserApproval(<username>) 
  • PendingNotifiedApproval()
  • PendingUserNotifiedApproval(<username>)
  • myPendingApproval() 
  • myPendingNotifiedApproval()
  • pendingForGroupApproval("") 
  • pendingForGroupNotifiedApproval("") 
  • approvedForApprovalStatus()
  • approvedOrAbstainedStatus()
  • myApprovedApproval()
  • myapprovedOrAbstainedStatus() 
  • rejectedForApprovalStatus()
  • myRejectedApproval()
  • pendingAutomaticTransitioning() 
  • defineApproval()
  • failedAutomaticTransitioning()

 

The JIRA menu bar includes the Approval menu allowing to select the filters My issues pending Approval returning issue in myPendingApproval() and My notified issues pending approval returning issue in myPendingNotifiedApproval()

How to use Approval JQL Functions

 

1

From the JIRA header, click Issues -> Search for Issues

Search for Issues tab

2

Click Advanced to switch the form to advance search mode using JQL.

Search screen

3

Enter an Approval JQL function

Search screen

4

Click the search icon to run the search. The list of issues appears.

JIRA search screen list view

 

The JQL functions have the behavior described below.

The issue in pendingForApproval() JQL function returns all issues having at least one approval request in 'Pending' status.

JIRA search screen detail view

The pendingForUserApproval(<username>) JQL function returns all issues having at least one approval request in 'Pending' status for the specific user (Mandatory).

JIRA search screen detail view

The PendingNotifiedApproval() JQL function returns all issues having at least one notified approval request in 'Pending' status.

JIRA search screen detail view

The PendingUserNotifiedApproval(<username>) JQL function returns all issues having at least one notified approval request in 'Pending' status for the specific user (Mandatory).

JIRA search screen detail view

The myPendingApproval() JQL function returns all the issues having at least one approval request waiting for logged user approval action (Approve or Reject).

JIRA search screen detail view

The myPendingNotifiedApproval() JQL function returns all the issues having at least one notified approval request waiting for logged user approval action (Approve or Reject).

JIRA search screen detail view

The pendingForGroupApproval(<Group>) JQL function returns all issues having at least one approval request in 'Pending' status for the specified Group.

The search for issue in pendingForGroupApproval("") returns all issues having at least one notified approval request in 'Pending' status for every Group.

JIRA search screen detail view

The pendingForGroupNotifiedApproval(<Group>) JQL function returns all issues having at least one notified approval request in 'Pending' status for the specified Group.

The search for issue in pendingForGroupNotifiedApproval("") returns all issues having at least one notified approval request in 'Pending' status for every Group.

JIRA search screen detail view

The rejectedForApprovalStatus() JQL function retuns all issues having at least one approval request in 'Rejected' status.

JIRA search screen detail view

The myRejectedApproval() JQL function retuns all issues having at least one approval request that has been 'Rejected' by the logged user.

JIRA search screen detail view

The approvedForApprovalStatus() JQL function returns all issues having all approval requests in 'Approved' status

JIRA search screen detail view

The approvedOrAbstainedStatus() JQL function returns all issues having all approval requests in 'Approved' or 'Abstained' statuses

JIRA search screen detail view

The myApprovedApproval() JQL function returns all issues having at least one approval request that has been 'Approved' by the logged user.

JIRA search screen detail view

The myApprovedOrAbstainedStaus() JQL function returns all issues having at least one approval request that has been 'Approved' or 'Abstained' by the logged user.

JIRA search screen detail view

The pendingAutomaticTransitioning() JQL function returns all issues configured to be automatically transitioned on reached approval.

JIRA search screen detail view

The defineApproval() JQL function returns all issues configured with specific approvals (not following the overall approval mapping).

JIRA search screen detail view

The failedAutomaticTransitioning() JQL function returns all issues not automatically transitioned due to conditions and validators have not been validated.

JIRA search screen detail view

The Approval JQL functions can be combined with other functions as showed in the following screenshot. 

 

  • No labels