Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Safety considerations and limited access to some of the data necessitated the introduction of additional features to the search engine.
The Secure Field plugin adds "issue in search" function to the JQL. This function takes from 2 to 4 arguments rounded by quotation marks.

Performance note

Please note that using the secureFieldSearch() function on large instances may cause performance issues. We strongly recommend using secureFieldSeachJQL() or secureFieldSearchFilter() functions instead. Please be aware that these functions have a parameter to enter the JQL Query/filter and we recommend using selective filters. It's not recommended to search for secure fields on a large dataset (more than 1000 issues).

 

issue in secureFieldSearch("", "", "")

1 - custom field's name

2 - operator's name

3 - custom field's value
Note: the custom field's value is not required in the case of using operators such as isEmpty or isNotEmpty.

4 - case sensitive/insensitive
Note: the argument valid for operators = and != for fields: Secure Text, Secure Free Text, Secure List, Secure Multi Select List, Secure Single User Picker, Secure Multi User Picker, Secure Single Group Picker, Secure Multi Group Picker.

Operators that are defined for the particular field types are listed below:

 Secure TextSecure Free TextSecure NumberSecure ListSecure Multi Select ListSecure Single User PickerSecure Multi User PickerSecure Single Group PickerSecure Multi Group PickerSecure DateSecure Date Time
=xxxxxxxxxxx
!=xxxxxxxxxxx
>  x      xx
>=  x      xx
<  x      xx
<=  x      xx
isEmptyxxxxxxxxxxx
isNotEmptyxxxxxxxxxxx
startsWithxx xxxxxx  
endsWithxx xxxxxx  
containsxx xxxxxx  

 

In large instances ,due to better performance, please refer to functions described below as they allow to search within secure fields in a limited range of issues.

Secure Field Search with JQL

issue in secureFieldSearchJQL("", "", "", "")

This function allows to search within the result of other JQLs. It takes from 3 to 5 arguments rounded by quotation marks. 

1 - Any JQL - like project = test, issuetype = Task etc...
Please keep in mind that if your JQL contains any double quotation marks " please escape them - change to \" - or change to single quotation marks '
Fore example for a JQL like project = "Some Project" change it to project = \"Some Project\"

2 - custom field's name

3 - operator's name

4 - custom field's value

5 - case sensitive/insensitiv


Secure Field Search with Filter

issue in secureFieldSearchFilter("", "", "", "")

This function allows to search within the result of a search filter. It takes from 3 to 5 arguments rounded by quotation marks. 

1 - Filter id - to obtain a filter id (the filter id it is NOT a filter name. We are using filter ids because of the fact that the id filter name is not unique within an instance of JIRA) please execute a filter and check your web browser address bar. The number after filter= will be your filter id. 

2 - custom field's name

3 - operator's name

4 - custom field's value

5 - case sensitive/insensitiv

 

 

  • No labels