org.everit.atlassian.restclient.jiracloud.v3.api

Class GroupPickerApi

java.lang.Object

org.everit.atlassian.restclient.jiracloud.v3.api.GroupPickerApi

public class GroupPickerApi
extends Object

Constructor Summary

Constructors

Constructor and Description
GroupPickerApi(org.everit.http.restclient.RestClient restClient)

Method Summary

Modifier and Type	Method and Description
io.reactivex.Single<FoundGroups>	findGroups(Optional<String> accountId, Optional<String> query, Optional<List<String>> exclude, Optional<Integer> maxResults, Optional<String> userName, Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer) Find groups Returns a list of groups whose names contain a query string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GroupPickerApi

public GroupPickerApi(org.everit.http.restclient.RestClient restClient)

Method Detail

findGroups

public io.reactivex.Single<FoundGroups> findGroups(Optional<String> accountId,
                                                   Optional<String> query,
                                                   Optional<List<String>> exclude,
                                                   Optional<Integer> maxResults,
                                                   Optional<String> userName,
                                                   Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer)

Find groups

Returns a list of groups whose names contain a query string. A list of group names can be provided to exclude groups from the results.

The primary use case for this resource is to populate a group picker suggestions list. To this end, the returned object includes the html field where the matched query term is highlighted in the group name with the HTML strong tag. Also, the groups list is wrapped in a response object that contains a header for use in the picker, specifically Showing X of Y matching groups.

The list returns with the groups sorted. If no groups match the list criteria, an empty list is returned.

This operation can be accessed anonymously.

Permissions required: Browse projects project permission. Anonymous calls and calls by users without the required permission return an empty list.

Parameters:

accountId -

This parameter is deprecated, setting it does not affect the results. To find groups containing a particular user, use Get user groups.

(optional)

query -

The string to find in group names.

(optional)

exclude -

A group to exclude from the result. To exclude multiple groups, provide multiple copies of this parameter. For example, exclude=group1&exclude=group2.

(optional, default to new ArrayList<>())

maxResults -

The maximum number of groups to return. The maximum number of groups that can be returned is limited by the system property jira.ajax.autocomplete.limit.

(optional)

userName -

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

(optional)

restRequestEnhancer -

Adds the possibility to modify the rest request before sending out. This can be useful to add authorizations tokens for example.

Returns:

Single<FoundGroups>