com.atlassian.jira.issue.fields
Interface FieldManager

All Superinterfaces:

FieldAccessor

All Known Implementing Classes:

DefaultFieldManager

public interface FieldManager
extends FieldAccessor

Field Summary

static String

CUSTOM_FIELD_PREFIX

Method Summary

Set<NavigableField>	getAllAvailableNavigableFields()
Set<SearchableField>	getAllSearchableFields() Return all the searchable fields in the system.
Set<CustomField>	getAvailableCustomFields(User remoteUser, org.ofbiz.core.entity.GenericValue issue) Deprecated. - use getAvailableCustomFields(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Deprecated since v4.0.
Set<CustomField>	getAvailableCustomFields(com.atlassian.crowd.embedded.api.User remoteUser, Issue issue) Retrieves custom fields in scope for the given issue
Set<CustomField>	getAvailableCustomFields(User remoteUser, Issue issue) Deprecated. Use getAvailableCustomFields(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v4.3
Set<NavigableField>	getAvailableNavigableFields(com.atlassian.crowd.embedded.api.User remoteUser)
Set<NavigableField>	getAvailableNavigableFields(User remoteUser) Deprecated. Use getAvailableNavigableFields(com.atlassian.crowd.embedded.api.User) instead. Since v4.3
Set<NavigableField>	getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User user) Gets all the available fields that the user can see, this is providing no context scope.
Set<NavigableField>	getAvailableNavigableFieldsWithScope(User user) Deprecated. Use getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User) instead. Since v4.3
Set<NavigableField>	getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User user, QueryContext queryContext) Gets all the available fields within the defined scope of the QueryContext.
Set<NavigableField>	getAvailableNavigableFieldsWithScope(User user, QueryContext queryContext) Deprecated. Use getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.jql.context.QueryContext) instead. Since v4.3
ColumnLayoutManager	getColumnLayoutManager() Deprecated. Declare your dependency and let PicoContainer resolve it instead
ConfigurableField	getConfigurableField(String id)
CustomField	getCustomField(String id) Get a CustomField by its text key (eg 'customfield_10000').
CustomFieldManager	getCustomFieldManager() Deprecated. Declare your dependency and let PicoContainer resolve it instead
Field	getField(String id) Get a field by its id.
FieldLayoutManager	getFieldLayoutManager() Deprecated. Declare your dependency and let PicoContainer resolve it instead
HideableField	getHideableField(String id)
IssueTypeField	getIssueTypeField() Retrieve the IssueType system Field.
IssueTypeSystemField	getIssueTypeSystemField() Deprecated. Use getIssueTypeField(). Since v4.3
NavigableField	getNavigableField(String id)
OrderableField	getOrderableField(String id)
Set<OrderableField>	getOrderableFields()
ProjectField	getProjectField() Retrieve the Project system Field.
ProjectSystemField	getProjectSystemField() Deprecated. Use getProjectField(). Since v4.3
RequirableField	getRequiredField(String id)
Set<SearchableField>	getSystemSearchableFields() Return all the searchable systems fields.
Set<Field>	getUnavailableFields()
boolean	isCustomField(Field field)
boolean	isCustomField(String id)
boolean	isFieldHidden(com.atlassian.crowd.embedded.api.User remoteUser, Field field)
boolean	isFieldHidden(User remoteUser, Field field) Deprecated. Use isFieldHidden(com.atlassian.crowd.embedded.api.User, String) instead. Since v4.3
boolean	isFieldHidden(com.atlassian.crowd.embedded.api.User remoteUser, String fieldId) Determines whether the field with id of fieldId is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).
boolean	isFieldHidden(User remoteUser, String fieldId) Deprecated. Use isFieldHidden(com.atlassian.crowd.embedded.api.User, String) instead. Since v4.3
boolean	isHideableField(Field field)
boolean	isHideableField(String id)
boolean	isMandatoryField(Field field)
boolean	isMandatoryField(String id)
boolean	isNavigableField(Field field)
boolean	isNavigableField(String id)
boolean	isOrderableField(Field field)
boolean	isOrderableField(String id)
boolean	isRenderableField(Field field)
boolean	isRenderableField(String id)
boolean	isRequirableField(Field field)
boolean	isRequirableField(String id)
boolean	isTimeTrackingOn()
boolean	isUnscreenableField(Field field)
boolean	isUnscreenableField(String id)
void	refresh()

Field Detail

CUSTOM_FIELD_PREFIX

static final String CUSTOM_FIELD_PREFIX

See Also:

Constant Field Values

Method Detail

getField

Field getField(String id)

Get a field by its id.

Parameters:

id - An IssueFieldConstants constant, or custom field key (eg. "customfield_10010")

Returns:

the Field

isCustomField

boolean isCustomField(String id)

isCustomField

boolean isCustomField(Field field)

getCustomField

CustomField getCustomField(String id)

Get a CustomField by its text key (eg 'customfield_10000').

Parameters:

id - Eg. 'customfield_10000'

Returns:

The CustomField or null if not found.

isHideableField

boolean isHideableField(String id)

isHideableField

boolean isHideableField(Field field)

getHideableField

HideableField getHideableField(String id)

isOrderableField

boolean isOrderableField(String id)

isOrderableField

boolean isOrderableField(Field field)

getOrderableField

OrderableField getOrderableField(String id)

getConfigurableField

ConfigurableField getConfigurableField(String id)

Specified by:

getConfigurableField in interface FieldAccessor

getOrderableFields

Set<OrderableField> getOrderableFields()

isNavigableField

boolean isNavigableField(String id)

isNavigableField

boolean isNavigableField(Field field)

getNavigableField

NavigableField getNavigableField(String id)

isRequirableField

boolean isRequirableField(String id)

isRequirableField

boolean isRequirableField(Field field)

isMandatoryField

boolean isMandatoryField(String id)

isMandatoryField

boolean isMandatoryField(Field field)

isRenderableField

boolean isRenderableField(String id)

isRenderableField

boolean isRenderableField(Field field)

isUnscreenableField

boolean isUnscreenableField(String id)

isUnscreenableField

boolean isUnscreenableField(Field field)

getRequiredField

RequirableField getRequiredField(String id)

getCustomFieldManager

@Deprecated
CustomFieldManager getCustomFieldManager()

Deprecated. Declare your dependency and let PicoContainer resolve it instead

Returns:

CustomFieldManager

getFieldLayoutManager

@Deprecated
FieldLayoutManager getFieldLayoutManager()

Deprecated. Declare your dependency and let PicoContainer resolve it instead

Returns:

FieldLayoutManager

getColumnLayoutManager

@Deprecated
ColumnLayoutManager getColumnLayoutManager()

Deprecated. Declare your dependency and let PicoContainer resolve it instead

Returns:

ColumnLayoutManager

refresh

void refresh()

getUnavailableFields

Set<Field> getUnavailableFields()

isFieldHidden

boolean isFieldHidden(com.atlassian.crowd.embedded.api.User remoteUser,
                      Field field)
                      throws FieldLayoutStorageException,
                             org.ofbiz.core.entity.GenericEntityException

Throws:

FieldLayoutStorageException

org.ofbiz.core.entity.GenericEntityException

isFieldHidden

boolean isFieldHidden(User remoteUser,
                      Field field)
                      throws FieldLayoutStorageException,
                             org.ofbiz.core.entity.GenericEntityException

Deprecated. Use isFieldHidden(com.atlassian.crowd.embedded.api.User, String) instead. Since v4.3

Determines whether the given Field is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).

Parameters:

remoteUser - the remote user.

field - The Field

Throws:

FieldLayoutStorageException

org.ofbiz.core.entity.GenericEntityException

isFieldHidden

boolean isFieldHidden(com.atlassian.crowd.embedded.api.User remoteUser,
                      String fieldId)
                      throws FieldLayoutStorageException

Determines whether the field with id of fieldId is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).

Parameters:

remoteUser - the remote user.

fieldId - The Field ID

Throws:

FieldLayoutStorageException

isFieldHidden

boolean isFieldHidden(User remoteUser,
                      String fieldId)
                      throws FieldLayoutStorageException

Deprecated. Use isFieldHidden(com.atlassian.crowd.embedded.api.User, String) instead. Since v4.3

Determines whether the field with id of fieldId is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).

Parameters:

remoteUser - the remote user.

fieldId - The Field ID

Throws:

FieldLayoutStorageException

getAvailableNavigableFieldsWithScope

Set<NavigableField> getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User user)
                                                         throws FieldException

Gets all the available fields that the user can see, this is providing no context scope.

Parameters:

user - the remote user.

Returns:

a set of NavigableFields that can be show because their visibility/configuration fall within what the user can see.

Throws:

FieldException - thrown if there is a problem looking up the fields

getAvailableNavigableFieldsWithScope

Set<NavigableField> getAvailableNavigableFieldsWithScope(User user)
                                                         throws FieldException

Deprecated. Use getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User) instead. Since v4.3

Gets all the available fields that the user can see, this is providing no context scope.

Parameters:

user - the remote user.

Returns:

a set of NavigableFields that can be show because their visibility/configuration fall within what the user can see.

Throws:

FieldException - thrown if there is a problem looking up the fields

getAvailableNavigableFieldsWithScope

Set<NavigableField> getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User user,
                                                         QueryContext queryContext)
                                                         throws FieldException

Gets all the available fields within the defined scope of the QueryContext.

Parameters:

user - the user making the request

queryContext - the context of the search request.

Returns:

a set of NavigableFields that can be show because their visibility/configuration fall within the specified context

Throws:

FieldException - thrown if there is a problem looking up the fields

getAvailableNavigableFieldsWithScope

Set<NavigableField> getAvailableNavigableFieldsWithScope(User user,
                                                         QueryContext queryContext)
                                                         throws FieldException

Deprecated. Use getAvailableNavigableFieldsWithScope(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.jql.context.QueryContext) instead. Since v4.3

Gets all the available fields within the defined scope of the QueryContext.

Parameters:

user - the user making the request

queryContext - the context of the search request.

Returns:

a set of NavigableFields that can be show because their visibility/configuration fall within the specified context

Throws:

FieldException - thrown if there is a problem looking up the fields

getAvailableCustomFields

Set<CustomField> getAvailableCustomFields(com.atlassian.crowd.embedded.api.User remoteUser,
                                          Issue issue)
                                          throws FieldException

Retrieves custom fields in scope for the given issue

Parameters:

remoteUser - Remote User

issue - Issue

Returns:

custom fields in scope for the given issue

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

getAvailableCustomFields

Set<CustomField> getAvailableCustomFields(User remoteUser,
                                          Issue issue)
                                          throws FieldException

Deprecated. Use getAvailableCustomFields(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Since v4.3

Retrieves custom fields in scope for the given issue

Parameters:

remoteUser - Remote User

issue - Issue

Returns:

custom fields in scope for the given issue

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

getAvailableCustomFields

Set<CustomField> getAvailableCustomFields(User remoteUser,
                                          org.ofbiz.core.entity.GenericValue issue)
                                          throws FieldException

Deprecated. - use getAvailableCustomFields(com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue) instead. Deprecated since v4.0.

Retrieves custom fields in scope for the given issue

Parameters:

remoteUser - Remote User

issue - Issue

Returns:

custom fields in scope for the given issue

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

getAllAvailableNavigableFields

Set<NavigableField> getAllAvailableNavigableFields()
                                                   throws FieldException

Throws:

FieldException

getAvailableNavigableFields

Set<NavigableField> getAvailableNavigableFields(com.atlassian.crowd.embedded.api.User remoteUser)
                                                throws FieldException

Throws:

FieldException

getAvailableNavigableFields

Set<NavigableField> getAvailableNavigableFields(User remoteUser)
                                                throws FieldException

Deprecated. Use getAvailableNavigableFields(com.atlassian.crowd.embedded.api.User) instead. Since v4.3

Throws:

FieldException

getAllSearchableFields

Set<SearchableField> getAllSearchableFields()

Return all the searchable fields in the system. This set will included all defined custom fields.

Returns:

the set of all searchable fields in the system.

getSystemSearchableFields

Set<SearchableField> getSystemSearchableFields()

Return all the searchable systems fields. This set will *NOT* include defined custom fields.

Returns:

the set of all searchable systems fields defined.

getIssueTypeField

IssueTypeField getIssueTypeField()

Retrieve the IssueType system Field.

Returns:

the IssueType system Field.

getIssueTypeSystemField

IssueTypeSystemField getIssueTypeSystemField()

Deprecated. Use getIssueTypeField(). Since v4.3

Retrieve the IssueType system Field.

Returns:

the IssueType system Field.

getProjectField

ProjectField getProjectField()

Retrieve the Project system Field.

Returns:

the Project system Field.

getProjectSystemField

ProjectSystemField getProjectSystemField()

Deprecated. Use getProjectField(). Since v4.3

Retrieve the Project system Field.

Returns:

the Project system Field.

isTimeTrackingOn

boolean isTimeTrackingOn()