Add and configure a new Power custom field

Each Power custom field type provides configurable selection options for specific use cases. The table below provides a brief description of the available types.

6. Give your field a name and description, then click Next.

7. Configure the issue type context for the new Power custom field.
   
   

   Open

   

   Configure issue context

8. Click Create.

9. Associate the field with the required screens.

The new Power custom field has been created and appears on the Custom fields page.

General configuration settings for the new Power custom field

Once your Power custom field is created, you can start configuring its settings. It is recommended that you complete the configuration steps in the order they are presented.

To access the configuration settings, locate the field in the Custom fields page in Jira Administration console and select Configure contexts from its respective Actions () menu.

Open

Configure context menu

For each context (the combination of projects and issue types where that field can be used), you can set:

• Default values: what is pre-filled when the custom field is displayed.

• Data options: what users can choose from (if the custom field type uses options).

Open

Custom field configuration options

Set default value

To set the default pre-filled value for your Power custom field:

1. Click Edit Default value.

2. Start typing to select an option from the drop-down list.

3. Click Set Default.

Select a data option template

You can select a data option type for your Power custom field from a list of pre-configured templates. You can use any option type with any custom field type. To select a template for a newly created Power custom field:

1. In the contexts configuration page of the Power custom field, click Edit Field data settings.
   
   

   Open

   

   Templates for selecting a data option type

2. Click the option template you want to choose for your Power custom field. You can use any option type with any custom field type.

For additional information and examples, see Option types.

2. Click Choose Template.

You have now set the option type for your Power custom field. All required properties are set automatically and displayed in the Summary page as illustrated in the example below.

Open

Configuration summary page

3. Click Configure.

Change the option type

Once you choose the data option type template for your Power custom field, you can change it only to a string, which is the default option type. You can change a string option type to any supported option type.

1. Open the Power custom field configuration settings.

2. In the Option Type section of the page, expand the drop-down menu as shown in the screenshot below.
   
   

   Open

   

   Change option type drop-down menu

   
   
   

3. Select the new data option type.

4. Click Save.

5. You are prompted to synchronize the existing values of the Power custom field.

Open

Synchronize field data prompt

• To keep matching fields values and remove invalid values, click Save and sync.

• To save the configuration without synchronization, click Save. You can run a sync later from the Maintenance tab of the Power custom field configuration page.

Configure the data source

The data source populates the Power custom field with values. You select and configure the data source for your Power custom field in the Data Source section of the field configuration page.

Open

Data Source section on Power custom field configuration page

1. (Optional) Toggle on if you want to have “None” to display as a valid option for data sources in the custom field’s configuration summary.

2. Select a data source type and configure the required settings.

Data source type	Description

Data source type	Description
SIL Data Source	SIL data source lets you use a SIL script to populate Power custom fields. The SIL script runs each time you modify the custom field. The Select a SIL script as data source field displays the path to the generated SIL script location. To view the location of this automatically generated script or select another script, click the Edit () icon. Open Select SIL script as data source   You can write your own SIL scripts to retrieve and display data from databases (using the sql function), files, or legacy systems. To view or modify the SIL script, go to Manage apps > SIL Manager and locate the scrupt in the corresponding custom field folder/subfolder under silprograms.   Open Data source SIL script in SIL Manager   A script used as a data source can return either a string array or a KPOption array. For additional information, see Return types. When you modify a custom field's value (either through inline editing or the edit issue screen) and save your changes, the argv parameter in your SIL script is automatically updated to contain both the field's previous value and the newly set value. This parameter can be accessed in your script using: argv["oldValue"] for the previous value argv["newValue"] for the updated value
SQL Data Source	SQL data source uses database queries to populate custom fields with values.   Open SQL data source settings   To set up the database connection: Provide your database resource name in the Data source name or JNDI field. Use a JNDI lookup name (like 'jdbc/MyDatabase') or a direct data source name. To set up a new data source, click the Create new data source link. For detailed instructions, see the Configuring data sources page. To configure database filtering: In SQL Initial Script field, enter an SQL query for initial database filtering. The script runs with autocomplete or when minimum characters is set to 0. For Power custom fields with autocomplete, you can add your own script in the SQL Autocomplete Script field.

3. If applicable, add fields as dependent fields to use their values in your data source.
   When a dependent field's value changes, the current field automatically updates its options based on the new value.

4. Click Save.

Configure validation

Power custom field validation is a way to verify that values in your field match allowed options from your data source. You configure the validation settings of your Power custom field in the Validation settings section of the field configuration page.

Open

Validation settings section on the Power custom field configuration page

1. Select the type of validation you want to use for your Power custom field.
   
   

2. If you are using a data source, select a SIL script that validates values when this field changes.

3. Toggle Always run script on to run the script regardless of field value changes. When off, the script runs only if values change.

4. Click Save.

Configure autocomplete

1. On the Power custom field configuration page, select the Autocomplete settings tab.

Open

Autocomplete tab on the Power custom field configuration page

2. Adjust the required settings:

3. Click Save.

Select export format

Power Custom Fields offers multiple formats for exporting field data.

1. In the Export section of the Power custom field configuration page, choose an export format that best suits your needs for data analysis or integration.
   
   

   Open

   

   The Export section on the Power custom field configuration page

2. Click Save.

Additional information