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

Class IssueFieldsApi

java.lang.Object

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

public class IssueFieldsApi
extends Object

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
io.reactivex.Single<FieldDetails>	createCustomField(CustomFieldDefinitionJsonBean customFieldDefinitionJsonBean, Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer) Create custom field Creates a custom field.
io.reactivex.Single<PageBeanContext>	getContextsForField(String fieldId, Optional<Long> startAt, Optional<Integer> maxResults, Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer) Get contexts for a field Returns a [paginated](#pagination) list of the contexts a field is used in.
io.reactivex.Single<List<FieldDetails>>	getFields(Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer) Get fields Returns system and custom issue fields according to the following rules: * Fields that cannot be added to the issue navigator are always returned
io.reactivex.Single<PageBeanField>	getFieldsPaginated(Optional<Long> startAt, Optional<Integer> maxResults, Optional<List<String>> type, Optional<List<String>> id, Optional<String> query, Optional<String> orderBy, Optional<String> expand, Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer) Get fields paginated Returns a [paginated](#pagination) list of fields for Classic Jira projects.

Methods inherited from class java.lang.Object

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

Constructor Detail

IssueFieldsApi

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

Method Detail

createCustomField

public io.reactivex.Single<FieldDetails> createCustomField(CustomFieldDefinitionJsonBean customFieldDefinitionJsonBean,
                                                           Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer)

Create custom field Creates a custom field. **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

Parameters:

customFieldDefinitionJsonBean - Definition of the custom field to be created (required)

restRequestEnhancer -

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

Returns:

Single<FieldDetails>

getContextsForField

public io.reactivex.Single<PageBeanContext> getContextsForField(String fieldId,
                                                                Optional<Long> startAt,
                                                                Optional<Integer> maxResults,
                                                                Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer)

Get contexts for a field Returns a [paginated](#pagination) list of the contexts a field is used in. **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

Parameters:

fieldId - The ID of the field to return contexts for. (required)

startAt - The index of the first item to return in a page of results (page offset). (optional, default to 0l)

maxResults - The maximum number of items to return per page. (optional, default to 20)

restRequestEnhancer -

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

Returns:

Single<PageBeanContext>

getFields

public io.reactivex.Single<List<FieldDetails>> getFields(Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer)

Get fields Returns system and custom issue fields according to the following rules: * Fields that cannot be added to the issue navigator are always returned. * Fields that cannot be placed on an issue screen are always returned. * Fields that depend on global Jira settings are only returned if the setting is enabled. That is, timetracking fields, subtasks, votes, and watches. * For all other fields, this operation only returns the fields that the user has permission to view (that is, the field is used in at least one project that the user has *Browse Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for.) This operation can be accessed anonymously. **[Permissions](#permissions) required:** None.

Parameters:

restRequestEnhancer -

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

Returns:

Single<List<FieldDetails>>

getFieldsPaginated

public io.reactivex.Single<PageBeanField> getFieldsPaginated(Optional<Long> startAt,
                                                             Optional<Integer> maxResults,
                                                             Optional<List<String>> type,
                                                             Optional<List<String>> id,
                                                             Optional<String> query,
                                                             Optional<String> orderBy,
                                                             Optional<String> expand,
                                                             Optional<org.everit.http.restclient.RestRequestEnhancer> restRequestEnhancer)

Get fields paginated Returns a [paginated](#pagination) list of fields for Classic Jira projects. The list can include: * all fields. * specific fields, by defining `id`. * fields that contain a string in the field name or description, by defining `query`. * specific fields that contain a string in the field name or description, by defining `id` and `query`. Only custom fields can be queried, `type` must be set to `custom`. **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

Parameters:

startAt - The index of the first item to return in a page of results (page offset). (optional, default to 0l)

maxResults - The maximum number of items to return per page. (optional, default to 50)

type - The type of fields to search. (optional, default to new ArrayList<>())

id - The IDs of the custom fields to return or, where`query is specified, filter. IDs should be provided in the format customfield_XXXXX.` (optional, default to new ArrayList<>())

query - String used to perform a case-insensitive partial match with field names or descriptions. (optional)

orderBy - [Order](#ordering) the results by a field: * `contextsCount` Sorts by the number of contexts related to a field. * `lastUsed` Sorts by the date when the value of the field last changed. * `name` Sorts by the field name. * `screensCount` Sorts by the number of screens related to a field. (optional)

expand - Use [expand](#expansion) to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: * `key` Returns the key for each field. * `lastUsed` Returns the date when the value of the field last changed. * `screensCount` Returns the number of screens related to a field. * `contextsCount` Returns the number of contexts related to a field. * `isLocked` Returns information about whether the field is [locked](https://confluence.atlassian.com/x/ZSN7Og). (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<PageBeanField>