com.atlassian.servicedesk.api.approval

Interface ApprovalService

@ExperimentalApi
 @ParametersAreNonnullByDefault
 @ReturnValuesAreNonnullByDefault
public interface ApprovalService

Method Summary

Modifier and Type	Method and Description
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Approval>	answerApproval(com.atlassian.jira.user.ApplicationUser user, Approval approval, ApprovalDecisionType decision) Answer to an approval of a given approvalId The answer could be approve or decline Required permissions: - User is an approver of the approval - User can view the request that the approval belongs to
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean>	canAnswerApproval(com.atlassian.jira.user.ApplicationUser user, Approval approval) Return true if user can answer this approval or false if: - user is not approver of the passed in approval - the approval is not pending anymore - the issue that the approval belong to does not have the same current status as the approval configured - user already made decision
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Approval>	getApprovalById(com.atlassian.jira.user.ApplicationUser user, int approvalId) Return an Approval for a given approvalId or AnError if: - user does not have permission to view issue in customer portal context - Approval was not found for the given approvalId
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,PagedResponse<Approval>>	getApprovals(com.atlassian.jira.user.ApplicationUser user, ApprovalQuery approvalQuery) Retrieve a page of Approval of a particular ApprovalQuery
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,List<Approver>>	getApprovers(com.atlassian.jira.user.ApplicationUser user, Approval approval) Return a list of Approver for a given approval
ApprovalQuery.Builder	newQueryBuilder()

Method Detail

newQueryBuilder

ApprovalQuery.Builder newQueryBuilder()

Returns:

a new ApprovalQuery.Builder to build approval query

getApprovals

com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,PagedResponse<Approval>> getApprovals(com.atlassian.jira.user.ApplicationUser user,
                                                                                                                     ApprovalQuery approvalQuery)

Retrieve a page of Approval of a particular ApprovalQuery

Parameters:

user - the user executing the query

approvalQuery - the query to retrieve approval

Returns:

an AnError if failure, or a paged collection of Approval

getApprovalById

com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Approval> getApprovalById(com.atlassian.jira.user.ApplicationUser user,
                                                                                                         int approvalId)

Return an Approval for a given approvalId or AnError if: - user does not have permission to view issue in customer portal context - Approval was not found for the given approvalId

Parameters:

user - the user who is executing the action

Returns:

An Either containing Approval associated with the given approval id or AnError.

getApprovers

com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,List<Approver>> getApprovers(com.atlassian.jira.user.ApplicationUser user,
                                                                                                            Approval approval)

Return a list of Approver for a given approval

Parameters:

approval - the Approval that we want to retrieve Approver from

Returns:

An Either containing a list of Approver associated with the given approval or AnError.

canAnswerApproval

com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean> canAnswerApproval(com.atlassian.jira.user.ApplicationUser user,
                                                                                                          Approval approval)

Return true if user can answer this approval or false if: - user is not approver of the passed in approval - the approval is not pending anymore - the issue that the approval belong to does not have the same current status as the approval configured - user already made decision

Parameters:

approval - the Approval that we want to check

Returns:

An Either containing boolean to indicate whether user can answer the given approval or AnError

answerApproval

com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Approval> answerApproval(com.atlassian.jira.user.ApplicationUser user,
                                                                                                        Approval approval,
                                                                                                        ApprovalDecisionType decision)

Answer to an approval of a given approvalId The answer could be approve or decline Required permissions: - User is an approver of the approval - User can view the request that the approval belongs to

Returns:

An Either containing the updated Approval or AnError.