Versions Compared

Version Old Version 2 New Version 3
Changes made by

Cristina Balcázar

Cristina Balcázar

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
bgColor#F4F5F7

This page provides information about Approval JQL Functions.

Select an Approval JQL Function from the Approval Menu in Herzum Approval Tab

Image Removed

Info

Need support?

We would love to help.

✉ Submit a support request

image-20240404-154637.pngImage Added

In this section

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledefault
typelist
printablefalse

pendingForApproval() 

This function returns issues having at least one approval request in 'Pending' status.

This function can take from 0 to 2 arguments:

  • first parameter expects the Project key or “All”

Examples:  PendingForApproval('All'), issue in PendingForApproval('Pkey')

  • second parameter expects true or false; this parameter, when true, enables an alternative filter method on the conditional rules that may be used to improve performance for some scenarios

Example:  pendingForApproval('All','true')

Admissible operators include IN and NOT IN.

If you do not specify any argument, the function returns all issues having at least one approval request in 'Pending' status.

Code Block
issue in pendingForApproval()

pendingForApprovalName() 

This function returns all issues having at least one approval request in 'Pending' status for the specific 'approval name'. 

This function expects the argument approval name.

Code Block
issue in pendingForApprovalName(<approvalname>)

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-170405.pngImage Addedimage-20240404-170616.pngImage Added

Image Removed

pendingForUserApproval() 

This function returns all issues having at least one approval request in 'Pending' status for the specific user. 

This function expects the argument username.

Code Block
issue in pendingForUserApproval(<username>)

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-162116.pngImage Addedimage-20240404-162947.pngImage Added

Image Removed

pendingUserApprovalName

This function returns all issues having at least one approval request in 'Pending' status for the specific User Name and Approval Name. 

This function expects the argument a User Name and Approval Name.

Code Block
issue in pendingUserApprovalName(<username><approvalname>)

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-171511.pngImage Added

Image Removed
image-20240404-172051.pngImage Added

pendingNotifiedApproval() 

This function returns all issues having at least one notified approval request in 'Pending' status.

This function doesn't take any arguments.

Code Block
issue in PendingNotifiedApproval()

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-173340.pngImage Added

Image Removed

image-20240404-173649.pngImage Added

 

pendingForUserNotifiedApproval()

This function all issues having at least one notified approval request in 'Pending' status for the specific user.

This function expects the argument username. 

Code Block
issue in PendingForUserNotifiedApproval(<username>)
Image Removed

image-20240404-181313.pngImage Addedimage-20240404-221634.pngImage Added

Image Removed

 

myPendingApproval() 

This function returns issues having at least one approval request waiting for logged user approval action.

This function can take from 0 to 2 arguments:

  • first parameter expects the Project key or All

Examples:  myPendingApproval('All'), issue in myPendingApproval('Pkey')

  • second parameter expects true or false; this parameter, when true, enables an alternative filter method on the conditional rules that may be used to improve performance for some scenarios

Example:  myPendingApproval('All','true')

Admissible operators include IN and NOT IN.

Code Block
issue in myPendingApproval()

myPendingNotifiedApproval() 

This function returns all the issues having at least one notified approval request waiting for logged user approval action.

This function doesn't take any arguments.

Code Block
issue in myPendingNotifiedApproval()

Admissible operators include IN and NOT IN.

Image Removed

Image Removed

 

Correct misspelled word, change in all matches and redeploy

image-20240404-215210.pngImage Addedimage-20240404-221000.pngImage Added

myPendingNoComment()

This function returns all the issues having at least one pending approval for logged user that doesn't require an approbation comment.

This function doesn't take any arguments.

Code Block
issue in myPendingNoComment()

Admissible operators include IN and NOT IN.

pendingForGroupApproval()

The function returns all issues having at least one approval request in 'Pending' status for the specified Group.

This function expects the argument Group.

Code Block
issue in pendingForGroupApproval("<Group>")

Admissible operators include IN and NOT IN.

pendingForGroupNotifiedApproval()

The function returns all issues having at least one notified approval request in 'Pending' status for the specified Group.

This function expects the argument Group.

Code Block
issue in pendingForGroupNotifiedApproval("<Group>")

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

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-222447.pngImage Added

Image Removed

image-20240404-222722.pngImage Added

 

rejectedForApprovalStatus()

This function returns all issues having at least one approval request in 'Rejected' status.

This function doesn't take any arguments. 

Code Block
issue in rejectedForApprovalStatus()

Admissible operators include IN and NOT IN.

Image Removed

Image Removed

 

image-20240404-223605.pngImage Addedimage-20240404-224029.pngImage Added

myRejectedApproval()

This function returns all issues having at least one approval request that has been 'Rejected' by the logged user.

This function doesn't take any arguments. 

Code Block
issue in myRejectedApproval()

Admissible operators include IN and NOT IN.

Image Removed

Image Removed

 
image-20240404-224837.pngImage Addedimage-20240404-225015.pngImage Added

approvedForApprovalStatus()

This function returns all issues having all approval requests in 'Approved' status.

This function doesn't take any arguments. 

Code Block
issue in approvedForApprovalStatus()

Admissible operators include IN and NOT IN.

approvedOrAbstainedStatus() 

This function returns all issues having all approval requests in 'Approved' or 'Abstained' statuses.

This function doesn't take any arguments.

Code Block
issue in approvedOrAbstainedStatus()

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-225434.pngImage Added

Image Removed

image-20240404-225416.pngImage Added

 

myApprovedApproval() 

This function returns all issues, found in the Approval Source Status, having at least one approval request that has been 'Approved' by the logged user.

This function doesn't take any arguments. 

Code Block
issue in myApprovedApproval()

Admissible operators include IN and NOT IN.

Image Removed
image-20240404-230216.pngImage Addedimage-20240404-230327.pngImage Added

Image Removed

 

myApprovedOrAbstainedStaus()

This function returns all issues having at least one approval request that has been 'Approved' or 'Abstained' by the logged user.

This function doesn't take any arguments.

Code Block
issue in myApprovedOrAbstainedStaus()

Admissible operators include IN and NOT IN.

Image Removed
image-20240405-212330.pngImage Added

Image Removed

image-20240405-212715.pngImage Added

 

myPendingForDelegatedApproval()

This function returns all issues pending for my approval due to I'm a delegated approver.

This function doesn't take any arguments. 

Code Block
issue in myPendingForDelegatedApproval()

Admissible operators include IN and NOT IN.

Image RemovedImage Removed
image-20240405-214706.pngImage Added

image-20240405-215448.pngImage Added

myPendingForDelegatedNoComment()

This function returns all issues pending for logged user approval due to a delegation that doesn't require an approbation comment.

This function doesn't take any arguments. 

Code Block
issue in MyPendingForDelegatedNoComment()

Admissible operators include IN and NOT IN.

Image RemovedImage Removed
image-20240405-215946.pngImage Added

image-20240405-220221.pngImage Added

pendingForDelegatedNoComment()

This function returns all issues pending approval due to a delegation that doesn't require an approbation comment.

This function doesn't take any arguments. 

Code Block
issue in PendingForDelegatedNoComment()

Admissible operators include IN and NOT IN.

pendingForDelegatedApproval()

This function returns issues pending for approval due to a delegation from a specific delegator for a specific project and issue type in a given time range.

This function takes the listed arguments: delegator username (mandatory), Project Id (optional), IssueType Id (optional), Start Date (optional), End Date (optional). 

Code Block
issue in pendingForDelegatedApproval('delegator username',10004,'10006','','')

Admissible operators include IN and NOT IN.

noApprovalsReceived()

This function returns all issues pending for approval that have no yet received any approbation.

This function doesn't take any arguments. 

Code Block
issue in noApprovalsReceived()

Admissible operators include IN and NOT IN.

Image Removed
image-20240405-220546.pngImage Added

Image Removed

image-20240405-220818.pngImage Added

partiallyApproved()

This function returns all issues pending approval having already at least catched one approbation.

This function doesn't take any arguments. 

Code Block
issue in partiallyApproved()

Admissible operators include IN and NOT IN.

Image Removed

Image Removed

In this section

Table of Contents

Need support?

We would love to help.

✉ Submit a support request
image-20240405-221252.pngImage Addedimage-20240405-222245.pngImage Added