| Info |
|---|
Before using SIL using SIL™ User Picker Custom Field custom field check out the Simple Issue Language Language™ documentation for a better grasp of SIL SIL™ usage and capabilities. |
How to configure
Adding a new SIL SIL™ User Picker Custom Field custom field is as easy as adding any other custom field.
...
- Log into your Jira as Admin.
- Go to Administration > Custom Fields > Add Custom Field, and select SIL SIL™ User Picker Custom Field from custom field from the list.
- Follow the on-screen instructions.
- Go to the Configure link.
Click , and click the Edit SIL SIL™ Script link link to define the SIL a SIL™ script.
Click the Save button and the script is - Write a SIL™ script.
Click Save, and the script will get associated with the current custom field. The values returned by the script are the values available for the custom field.
In our example, the SIL User picker Picker custom field is configured to filter only users that are members of group the jira-developers or jiraJira-administrators group.
To set the number of characters that user autocomplete feature is triggered for the field use the global autocomplete threshold parameter from the User Group Picker PRO configuration page. The default value for the autocomplete threshold is set to 2.
For example, if you choose value select "3" for the autocomplete threshold in on the configuration page as shown in the example above example, the list of suggested users matching the criteria in the user group picker are will be shown after introducing the third character in the input :is entered.
| Note |
|---|
| Note that this is a global configuration parameter, that will be applied for all user picker custom fields. |
How to use it
- Go to an issue and check the users available for selection by clicking the user picker icon or by typing something in the input.
Only users retrieved from the SIL SIL™ script will be available for selection (in this case administrators and developers).
...
- Select the necessary user and save it on the current issue. The field value appears on the right side of the view issue screen, in the
...
- People section
...
- :
3. Edit the field on a view issue screen by clicking on the inline edit icon next to the field to see suggested users filtered accordingly to the SIL SIL™ script.
That's it.
Other
...
examples
Here are certain SIL more SIL™ scripts examples that you can use to configure your SIL SIL™ user picker fields. Basically, by means of SIL SIL™ you can restrict the users selection to whatever any criteria you want.
Issue Assignees
| Code Block |
|---|
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; |
Users in specific role
| Code Block |
|---|
return usersInRole(project, "Developers"); |
Users in specific group
| Code Block |
|---|
return usersInGroups("jira-developers"); |
...
Searching issues
When creating you create a new SIL User Picker custom field, the default searcher set is SIL SIL™ User Picker and Group Searcher. This filters the available users for the custom field in issue navigator accordingly to the configured SIL SIL™ script.
However, when using SIL SIL™ issue specific variables in the script (for instance project, key, assignee, reporter), you have to use Jira's standard searcher User Picker and Group Searcher for that field, or otherwise you will not be able to select any value for filtering.
| Note |
|---|
When using the SIL SIL™ User Picker & Group Searcher, user suggestions in issue navigator will be retrieved based on the SIL SIL™ script from the field's global configuration. |
- Go to Administration ->Custom > Custom fields
- Click Edit for the desired custom field
- Choose the proper Search Template for your custom field.
...
- Perform a re-index
...
- — After
...
- the Search Templates are changed for all the custom field that you want, perform a re-index in Jira for the search to work fine.
...
- After a searcher has been set for the
...
- SIL™ User Picker custom field, you can perform a search for all issues containing the desired value for that custom field
For a detailed explanation on searching issues more details about searching tickets in Jira, you can check the Searching for Issues tutorial from the Jira documentation.