PCF - SIL User Picker
Configure the PCF - SIL User Picker custom field
The PCF - SIL User Picker custom field lets you select users from a dropdown list. The available users are filtered based on your SIL script.
Prerequisites:
Ensure you understand Simple Issue Language (SIL) basics and capabilities.
You have Jira Administrator role and permissions.
You have already created a Power custom field of the PCF - SIL Script Custom Field type.
Locate your PCF - SIL Script Custom Field on the Custom fields page and click Configure contexts. The configuration section will look like the one illustrated below:
Click Edit Field data settings. This opens the configuration tabs for the custom field.
In the Scripts tab, enter a SIL script that returns users. For example,
return getAllUsers().
Contents: See also: |
|---|
Click Save. The script you provided is associated with the current custom field. The values returned by the script are the values available for the custom field.
(Optional) In the Filtering Strategy tab, enable filtering and configure filters based on your requirements. You can create filters based on users' group or role.
In this example, the PCF - SIL User Picker custom field is configured to filter only users that are members of the jira-software-users group and have Administrator role.
In the General tab, set a default value for the field.
Click Save.
How the field displays
After configuring the field, go to an issue and open it for editing. This is an example of how the PCF - SIL User Picker field displays on the edit issue screen:
Type at least two characters in the field to display matching users.
Select a user from the dropdown list.
Update the issue.
View your selection in the People section of the View Issue screen
To edit the field on the View issue screen, click the inline edit icon next to the field. A dropdown list will show filtered users based on your SIL script.
Examples
Example | Sample script | Sample display output |
|---|---|---|
Display all issue assignees Age | This script retrieves all users who have been assigned to an issue, including both current and previous assignees. string[] assignees;
assignees = addElementIfNotExist(assignees, assignee);
string[] assigneeHistory = fieldHistory(key, "assignee");
for(number i = 1; i < size(assigneeHistory); i = i + 2) {
string assigneeName = getElement(assigneeHistory, i);
assignees = addElementIfNotExist(assignees, assigneeName);
}
return assignees;
| "gsmith, mjohnson, awhite" |
Display users in a specific project role | This script returns all users who have the "Developers" role in the current project. return usersInRole(project, "Developers");
| "jsmith, bjones, mwilson" |
Display users in group | This script returns all users belonging to a specified group. return usersInGroups("jira-developers");
| "tdoe, rjohnson" |
Configure search settings for your PCF - SIL User Picker custom field
When created, the PCF - SIL User Picker custom field comes with two default searchers: SIL User Picker and Group Searcher. Together, they filter users according to your configured SIL script.
When using the SIL User Picker and Group Searcher in the search interface (issue navigator), the available user options are determined by the SIL script defined in your field's global configuration.
If your SIL script uses issue-specific variables (such as project, key, assignee, or reporter), you must use the standard User Picker and Group Searcher instead. Otherwise, you won't be able to select values for filtering.
Locate your PCF - SIL Script Custom Field on the Custom fields page and click Edit details.
Select a Search Template compatible with your field's return value type.
Click Update.
After the update, reindex your Jira instance to ensure search functionality works correctly.
Test the search functionality by performing a search for all issues containing the value you want for that custom field.
To learn more about the search functionality, see the Jira Searching for Issues tutorial.
Need support? Create a request with our support team.
Copyright © 2005 - 2025 Appfire | All rights reserved.