My Custom Fields

The My custom fields page (Figure 1, right) displays a paginated table listing all custom fields created using JMCF for Jira Cloud. The page includes, from top to bottom:

• Page Toolbar - The upper right corner of the page includes a menu with several commands:

  • Documentation - Open the JMCF for Jira Cloud documentation.

  • Support request - Open the Appfire Support portal to submit a support request.

  • Feedback - Open the Appfire Support portal to submit an enhancement or feature request.

  • Atlassian Community - Open the Atlassian Community page for JMCF.

• Refresh - Refresh the list of custom fields.

• Search - Search for custom fields by field name, field ID, description, or field type.

• New custom field - Click this button to add a new custom field and open the Create Custom Field Wizard.

• Custom Field Table - The table listing all JMCF custom fields created in your instance.

  • Pagination - For instances with many custom fields, the table will be paginated with navigation controls under the table itself.

The table of fields includes the following:

• Enable/Disable - Use this toggle to enable or disable a custom field entirely. Disabled custom fields will still be displayed on issue screens, but they will not be recalculated until they are enabled (including scheduled recalculations).

• Field name - The name of the custom field.
  Note: Newly created or edited custom fields will show at the top of the list of custom fields for a short time; after that, fields are listed alphabetically.

• Description - Description of field; this is entered during field creation and can be edited.

• Field Type - The type of custom field and its icon, such as Last Field Change Time, Parent Status, and Status Entered by User, among others. See Custom Fields for more information.

• Formatter - An icon will display for any custom field that has been styled using Formatters.

• Screens - The number of screens to which the custom field has been added. Click the link to open the Edit custom field window where screens can be added or removed. See Screens and Contexts, below, for more information.

• Context - The number of projects in which the field is active, and the issue types for which the field is currently active. Click either badge to open the native Jira Configure Custom Field screen to edit the context(s) to which the custom field belongs. See Screens and Contexts, below, for more information.

• Schedule - The recalculation schedule for the custom field (if any). See Scheduled recalculations for more information.

• Errors - A badge indicating the number of Errors for a custom field. Clicking the badge will open the Error Logs page where you can view more details.

• Calculations - A badge indicating the calculation status of for the custom field (e.g. complete, in-progress, suspended, or the percent completed); click the calculation percentage to open the Calculations page. See Calculations for more information.
  Note: Completed and inactive calculations will be automatically removed from the Calculations page after 24 hours.

• Action Button - A set of shortcut buttons to numerous actions related to the custom field. See Working with custom fields, below, for more information.

Working with custom fields

Each custom field listed includes an Action button in the last column to the right; this menu includes options to perform standard actions for each field.

• Edit ( ) - Open the custom field editor to update the name and description; add or remove screens where the field will appear; or update the specific configuration for the field.

• Duplicate ( ) - Copy the custom field configuration to a new JMCF custom field; this opens the Create Custom Field Wizard where the current configuration of the custom field can be modified for the new copy.

• Formatters- Open the Formatters configuration dialog for the selected custom field. See Formatters for more information.

• Recalculate ( ) - Start a recalculation of the custom field.

• Schedule Recalculation ( ) - Schedule the field for recalculation on an interval. See Scheduled recalculations for more information.

• Delete ( ) - Move the custom field to the Trash; the custom field will remain in the Trash for 60 days, after which it will be deleted. JMCF custom fields can be recovered the same as native custom fields - through the Trash tab in the Jira Custom fields screen.

Edit a custom field

Open

Figure 2 - Edit custom field

When you select Edit, the Edit custom field window (Figure 2, right) will open.

This window includes two steps to update a custom field:

1. Edit name and associate screens - Update the name of the custom field, check the box next to a screen to add the field to that screen or, alternately, uncheck the box to remove the field from that screen. Use the Search box to find specific screens.
   Note: Currently selected screens will display at the top of the list!

2. Edit configuration - Depending on the custom field type, the configuration screen will be different. Refer to each types specific documentation for details on its configuration options.

Screens and Contexts

A custom field is added to a screen by configuring the field, not by configuring the screen! The My custom fields page lists each of the JMCF-created custom fields along with details on the number of screens to which the field has been added. After a field has been added to a screen, its location on the screen can be updated by opening the Jira screen editor.

In addition to the details on screens, the table lists the Contexts to which the field has been added; the context, or custom field configuration scheme, is a set of general configurations that can be applied to custom fields. A context includes the localization and default value settings as well as the type of issues and specific projects in which the field is available.