When using Canned Search Gadget for the first time
...
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Add/Edit
...
Canned
...
Filters
...
- Navigate to Manage Canned Filters, from either of the methods below
From Filters page.
You can access the page from:Navigation Bar
- Issues > Manage Canned Filters
- Issues > Manage Canned Filters
- Navigate to Manage add-ons,
- Settings > Add-ons > Manage Add-ons
- Expand the Canned Search Gadget Section
- Click on Configure
Click on Add Canned Filter Button ( button to add a new filter ) / or Edit Filter button to edit the corresponding filter (to edit filter).
A dialog box will pop up,
Choose Filter for your canned filter
Adapt from existing:Select an existing filter under Saved Filter, or
Draft JQL: And enter your JQL in the field as shown below
Select Existing Filter
Refer
. Configure the canned filter and click on Save button to save the changes made.
There are 3 sections to the configuration:
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Choose Filter
Configure JQL of the Canned Filter.
Fields | Description | Default |
---|---|---|
Canned Filter Name | The name of the Canned Filter. | New Filter |
Select Filter Type | You can:
|
...
...
|
...
| Adapt From Existing Filter |
Select Variables
...
Select which variables to be displayed in the
...
gadget
...
. The underscore text demarcates that
...
a field will be created, and the variable will be filled in place of the underscore text.
...
...
Columns | Description | |||
---|---|---|---|---|
# |
Index of the variable. | |||
Checkbox | Click to select/de-select variables to be displayed in the canned search gadget. | |||
Context |
...
Context of the variable. | |
Alias |
...
Label for the input field |
...
to be displayed in the |
...
canned search gadget. | |
Type |
...
Type of input field to display in the canned search gadget. There are a total of |
...
4 types: | |
Text |
...
This will render a text field in the gadget. When clicked, an |
...
autocomplete list of possible values will appear |
...
, and will further refine as the user |
...
types. |
...
Dropdown |
...
This will render a dropdown field in the gadget |
...
. When clicked, the list of |
...
options will be |
...
displayed. | |
Date Picker | This will render a text field in the gadget. When clicked, a date picker will appear for |
...
user to conveniently select |
...
a date. |
...
Duplicate |
This will NOT render any field in the gadget. | |||
Options |
|
...
|
...
For Dropdown | Define the list of options to be displayed in the dropdown field, delimited by comma.
|
...
For example: Context: status = _____ Type: Dropdown Options input field: Open, To Do Options input field: empty |
...
For Duplicate | Select the index (#) of the field value to copy over. For example, as shown below, the value of the reporter field will copy the value of index #2 field, which is the assignee field. |
Access Rights
This will determine who is able to access
...
a particular filter through the
...
gadget.
...
Fields | Description |
---|---|
Restrict Access to List |
...
If checked, the access to the Canned Filter will be restricted to the list. Else, access will NOT be restricted. | |
Add | Fill in username or group name, select the corresponding type, and click on Add to add to the access list. Click on Delete to remove a particular user or group from the access list. |
Edit Access Rights: Allowing Other Users to Create/Edit Canned Filters
...
- Navigate to Manage Canned Filters, from either of the methods below
From Navigation Bar
- Issues > Manage Canned Filters
- Navigate to Manage add-ons,
- Expand the Canned Search Gadget Section
- Click on Configure
- Edit the access control, click on the Access Control Button on the top right hand corner of the page.
A dialog box will pop up, allowing you to add/edit particular users/groups and set their access type.
The various access types are further explained below:Access TypeDescriptionAdministrator The particular user/group has full access to all the functionalities of the canned filter page, and is able to edit records in the Access Control page. Can View/Edit All Canned Filters The particular user/group is able to have access to all the canned filters that were created, and is able to edit every one of them. Can View/Edit Own Canned Fitlers The particular user/group is able to create/edit their own canned filter, but is unable to edit canned filters created by others. - Users who are in the access control list, or are in groups residing in the access control list, will be able to view the Manage Canned Filters link under the Issues menu.
...
Fill in the preferences for the particular gadget. Select which canned filter you want to be displayed in the gadget. The different configurations available are illustrated below.
Live Preview Open in Issue Navigator PreferenceDescriptionCanned Filter The canned filter, the defined fields of which will be displayed as a form in the gadget view. Title Title of the canned search gadget window
Instructions When filled, the text will be shown on top of the gadget, in bold, as instructions for how to fill up the fields of the canned search form. Navigator Method Select what happens when a link to the Issue Navigator is clicked on.
- Open the Issue Navigator in a new tab (Open in New Tab)
- Refresh the current page that the gadget is in, and load the issue navigator (Open in Current Page)
Action
Select what happens when the search button is clicked
- Open the Issue Navigator in a new tab (Live Preview)
- The user will be redirected to the issue navigator, with the shortlisted issues displayed inside depending on the field variables that were filled (Open in Issue Navigator)
Number of Results
(For Live Preview Option)
Number of results that will be displayed per page in the issues table. Fields to Display
(For Live Preview Option)
Customise which fields you want to display in the issues table.
- Click on the Save button to save the preferences associated with the particular instance of the canned search gadget.
...