com.atlassian.jira.issue
Interface CustomFieldManager

All Known Implementing Classes:

DefaultCustomFieldManager

public interface CustomFieldManager

Functions for working with CustomFields.

Field Summary

static String

PLUGIN_KEY

Method Summary

CustomField	createCustomField(String fieldName, String description, CustomFieldType fieldType, CustomFieldSearcher customFieldSearcher, List contexts, List issueTypes) Creates a custom field with the given name and description of the given CustomFieldType using the given CustomFieldSearcher that is displayed in the given list of contexts available to the given list of issueTypes.
CustomField	getCustomFieldInstance(org.ofbiz.core.entity.GenericValue customFieldGv) Converts a customfield GenericValue to a CustomField instance.
CustomField	getCustomFieldObject(Long id) Get a CustomField by ID.
CustomField	getCustomFieldObject(String id) Get a CustomField by its text key (eg 'customfield_10000').
CustomField	getCustomFieldObjectByName(String customFieldName) Retrieve the first custom field object with the specified name.
List	getCustomFieldObjects() Returns all custom fields.
List	getCustomFieldObjects(org.ofbiz.core.entity.GenericValue issue) Returns a list of CustomFields that apply to a particular issue.
List	getCustomFieldObjects(Issue issue) Returns a list of CustomFields that apply to a particular issue.
List	getCustomFieldObjects(Long projectId, List issueTypes) Returns the same as getCustomFieldObjects(Long, String) but allows to specify a list of issueTypes.
List	getCustomFieldObjects(Long projectId, String issueType) Gets a list of custom fields for a particular project and issue type.
List	getCustomFieldObjects(SearchContext searchContext) Returns all customfields in a particular SearchContext.
Collection	getCustomFieldObjectsByName(String customFieldName) Retrieve custom field(s) of a certain name.
CustomFieldSearcher	getCustomFieldSearcher(String key) Retrieve a custom field searcher by its type key.
Class	getCustomFieldSearcherClass(String key) Retrieve a custom field searcher by its type key.
List	getCustomFieldSearchers(CustomFieldType customFieldType) Retrieves all the searchers registered for a particular custom Field.
CustomFieldType	getCustomFieldType(String key) Retrieve a custom field type by its type key.
List	getCustomFieldTypes() Retrieve all customfieldtypes registered in the sytem.
List	getGlobalCustomFieldObjects() Returns a list of custom fields where the CustomField.isGlobal() is true.
void	refresh() reloads all customfields into the cache from the DB.
void	removeCustomField(CustomField customField) Removes the customfield supplied.
void	removeCustomFieldValues(org.ofbiz.core.entity.GenericValue issue) Removes the values stored by customfields for a particular Issue.
void	removeProjectAssociations(org.ofbiz.core.entity.GenericValue project) Used if a project is deleted to remove the project field associations.
void	removeProjectCategoryAssociations(org.ofbiz.core.entity.GenericValue projectCategory) Used if a project category is deleted to remove the field associations.

Field Detail

PLUGIN_KEY

static final String PLUGIN_KEY

See Also:

Constant Field Values

Method Detail

getCustomFieldObjectsByName

Collection getCustomFieldObjectsByName(String customFieldName)

Retrieve custom field(s) of a certain name.

Parameters:

customFieldName -

Returns:

A collection of CustomFields.

getCustomFieldObjectByName

CustomField getCustomFieldObjectByName(String customFieldName)

Retrieve the first custom field object with the specified name. WARNING: Custom Field names are no longer guaranteed to be unique. This method returns the first named custom field. Use getCustomFieldObjectsByName(String) to retrieve all custom fields.

Parameters:

customFieldName -

Returns:

The first named CustomField, or null if not found.

getCustomFieldObject

CustomField getCustomFieldObject(Long id)

Get a CustomField by ID.

Parameters:

id - ID of field, eg. 10000

Returns:

The CustomField or null.

getCustomFieldObject

CustomField getCustomFieldObject(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.

getCustomFieldObjects

List getCustomFieldObjects()

Returns all custom fields.

Returns:

A list of all CustomFields.

getGlobalCustomFieldObjects

List getGlobalCustomFieldObjects()

Returns a list of custom fields where the CustomField.isGlobal() is true.

Returns:

A list of CustomFields

getCustomFieldObjects

List getCustomFieldObjects(Long projectId,
                           String issueType)

Gets a list of custom fields for a particular project and issue type.

Parameters:

projectId - Id of the project

issueType - An issue type. See ConstantsManager.ALL_ISSUE_TYPES, ConstantsManager.ALL_STANDARD_ISSUE_TYPES and ConstantsManager.ALL_SUB_TASK_ISSUE_TYPES

Returns:

A list of CustomFields

getCustomFieldObjects

List getCustomFieldObjects(Long projectId,
                           List issueTypes)

Returns the same as getCustomFieldObjects(Long, String) but allows to specify a list of issueTypes.

Parameters:

projectId - Id of the project

issueTypes - A list of issue types. See ConstantsManager.ALL_ISSUE_TYPES, ConstantsManager.ALL_STANDARD_ISSUE_TYPES and ConstantsManager.ALL_SUB_TASK_ISSUE_TYPES

Returns:

A list of CustomFields

getCustomFieldObjects

List getCustomFieldObjects(SearchContext searchContext)

Returns all customfields in a particular SearchContext. Also see CustomField.isInScope(com.opensymphony.user.User, com.atlassian.jira.issue.search.SearchContext).

Parameters:

searchContext -

Returns:

A list of CustomFields

getCustomFieldObjects

List getCustomFieldObjects(org.ofbiz.core.entity.GenericValue issue)

Returns a list of CustomFields that apply to a particular issue.

Parameters:

issue - A GenericValue of the issue

Returns:

A list of CustomFields

getCustomFieldObjects

List getCustomFieldObjects(Issue issue)

Returns a list of CustomFields that apply to a particular issue.

Parameters:

issue - A Issue object

Returns:

A list of CustomFields

getCustomFieldTypes

List getCustomFieldTypes()

Retrieve all customfieldtypes registered in the sytem.

Returns:

a list og CustomFieldTypes

getCustomFieldType

CustomFieldType getCustomFieldType(String key)

Retrieve a custom field type by its type key.

Parameters:

key - Type identifier constructed from plugin XML. Eg. the system types are specified in system-customfiedltypes-plugin.xml:

                                                                   <atlassian-plugin key="com.atlassian.jira.plugin.system.customfieldtypes" name="Custom Field Types & Searchers">
                                                                     ...
                                                                     <customfield-type key="float" name="Number Field"
                                                                   ...
                                                                   

To access the 'Number Field' type, the key would then be 'com.atlassian.jira.plugin.system.customfieldtypes:float' (the first part can be referred to via CreateCustomField.FIELD_TYPE_PREFIX).

getCustomFieldSearchers

List getCustomFieldSearchers(CustomFieldType customFieldType)

Retrieves all the searchers registered for a particular custom Field. Searchers may be registred via:

   <customfield-searcher key="daterange" name="Date Range picker"
                     i18n-name-key="admin.customfield.searcher.daterange.name"
                     class="com.atlassian.jira.issue.customfields.searchers.DateRangeSearcher">
 

Parameters:

customFieldType -

Returns:

A list of CustomFieldSearchers

getCustomFieldSearcher

CustomFieldSearcher getCustomFieldSearcher(String key)

Retrieve a custom field searcher by its type key.

Parameters:

key - Type identifier constructed from plugin XML. Eg. the system types are specified in system-customfiedltypes-plugin.xml:

                                                                   <atlassian-plugin key="com.atlassian.jira.plugin.system.customfieldtypes" name="Custom Field Types & Searchers">
                                                                     ...
                                                                      <customfield-searcher key="exactnumber" name="Number Searcher"
            

                                                                   ...
                                                                   

To access the 'Number Searcher' searcher, the key would then be 'com.atlassian.jira.plugin.system.customfieldtypes:exactnumber' (the first part can be referred to via CreateCustomField.FIELD_TYPE_PREFIX).

createCustomField

CustomField createCustomField(String fieldName,
                              String description,
                              CustomFieldType fieldType,
                              CustomFieldSearcher customFieldSearcher,
                              List contexts,
                              List issueTypes)
                              throws org.ofbiz.core.entity.GenericEntityException

Creates a custom field with the given name and description of the given CustomFieldType using the given CustomFieldSearcher that is displayed in the given list of contexts available to the given list of issueTypes.

Returns:

the newly created CustomField.

Throws:

org.ofbiz.core.entity.GenericEntityException - if the CustomField could not be created.

removeCustomField

void removeCustomField(CustomField customField)
                       throws org.ofbiz.core.entity.GenericEntityException

Removes the customfield supplied.

Parameters:

customField - The CustomField to be removed.

Throws:

org.ofbiz.core.entity.GenericEntityException

removeCustomFieldValues

void removeCustomFieldValues(org.ofbiz.core.entity.GenericValue issue)
                             throws org.ofbiz.core.entity.GenericEntityException

Removes the values stored by customfields for a particular Issue.

Parameters:

issue - The issue GenericValue

Throws:

org.ofbiz.core.entity.GenericEntityException

removeProjectAssociations

void removeProjectAssociations(org.ofbiz.core.entity.GenericValue project)

Used if a project is deleted to remove the project field associations.

Parameters:

project - The project being deleted.

removeProjectCategoryAssociations

void removeProjectCategoryAssociations(org.ofbiz.core.entity.GenericValue projectCategory)

Used if a project category is deleted to remove the field associations.

Parameters:

projectCategory - The project category being deleted.

getCustomFieldInstance

CustomField getCustomFieldInstance(org.ofbiz.core.entity.GenericValue customFieldGv)

Converts a customfield GenericValue to a CustomField instance.

Parameters:

customFieldGv -

Returns:

a CustomField instance

refresh

void refresh()

reloads all customfields into the cache from the DB.

getCustomFieldSearcherClass

Class getCustomFieldSearcherClass(String key)

Retrieve a custom field searcher by its type key.

Parameters:

key - Type identifier constructed from plugin XML. Eg. the system types are specified in system-customfiedltypes-plugin.xml:

                                                                   <atlassian-plugin key="com.atlassian.jira.plugin.system.customfieldtypes" name="Custom Field Types & Searchers">
                                                                     ...
                                                                     <customfield-type key="float" name="Number Field"
                                                                   ...
                                                                   

To access the 'Number Field' type, the key would then be 'com.atlassian.jira.plugin.system.customfieldtypes:float' (the first part can be referred to via CreateCustomField.FIELD_TYPE_PREFIX).