com.atlassian.servicedesk.api.permission

Interface ServiceDeskPermissionService

@PublicApi
 @ExperimentalApi
public interface ServiceDeskPermissionService

An experimental interface for validating users against service desk permissions

WARNING: this interface is experimental and is subject to change between minor versions of Service Desk up to and including removal of this interface or parts thereof. It is not for consumption by non-Atlassian plugins and no consideration will be given to nor guarantees made for its compatibility between releases. Basically, don't use it unless you're a Service Desk developer.

Since:

2.3

Method Summary

Modifier and Type	Method and Description
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean>	isAdminAgent(com.atlassian.jira.user.ApplicationUser user, ServiceDesk serviceDesk) Checks whether the user is an agent with project admin permission.
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean>	isAgent(com.atlassian.jira.user.ApplicationUser user, ServiceDesk serviceDesk) Checks whether the user is an agent for the given service desk.
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean>	isCustomer(com.atlassian.jira.user.ApplicationUser user, CustomerRequest request) Checks whether the ApplicationUser is a customer for the given com.atlassian.servicedesk.api.request.
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean>	isCustomer(com.atlassian.jira.user.ApplicationUser user, com.atlassian.jira.issue.Issue issue) Checks whether the ApplicationUser is a customer for the given com.atlassian.servicedesk.api.request.

Method Detail

isAdminAgent

@Nonnull
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean> isAdminAgent(@Nonnull
                                                                                                              com.atlassian.jira.user.ApplicationUser user,
                                                                                                              @Nonnull
                                                                                                              ServiceDesk serviceDesk)

Checks whether the user is an agent with project admin permission. True if - valid licensed, - license count not overrun - required permissions on the project - is admin on project

Parameters:

user - the user who you want to check

serviceDesk - the service desk you want to check the agent status against.

Returns:

whether the user is an admin agent for the given service desk.

isAgent

@Nonnull
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean> isAgent(@Nonnull
                                                                                                         com.atlassian.jira.user.ApplicationUser user,
                                                                                                         @Nonnull
                                                                                                         ServiceDesk serviceDesk)

Checks whether the user is an agent for the given service desk. True if - valid licensed, - license count not overrun - required permissions on the project

Parameters:

user - the user who you want to check

serviceDesk - the service desk you want to check the agent status against.

Returns:

whether the user is an agent for the given service desk.

isCustomer

@Nonnull
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean> isCustomer(@Nonnull
                                                                                                            com.atlassian.jira.user.ApplicationUser user,
                                                                                                            @Nonnull
                                                                                                            CustomerRequest request)

Checks whether the ApplicationUser is a customer for the given com.atlassian.servicedesk.api.request.

Parameters:

user - the user who you want to check

request - the request you want to check customer status against.

Returns:

whether the user is a customer for the given request.

isCustomer

@Nonnull
com.atlassian.fugue.Either<com.atlassian.pocketknife.api.commons.error.AnError,Boolean> isCustomer(@Nonnull
                                                                                                            com.atlassian.jira.user.ApplicationUser user,
                                                                                                            @Nonnull
                                                                                                            com.atlassian.jira.issue.Issue issue)

Checks whether the ApplicationUser is a customer for the given com.atlassian.servicedesk.api.request.

Parameters:

user - the user who you want to check

issue - the jira issue you want to check customer status against.

Returns:

whether the user is a customer for the given request.