Some of the content described in this article is available in meshIQ Manage versions 11.1.1 and later. See meshIQ platform Highlights v11.1 for an overview of feature changes.
The Attribute filter feature allows you to narrow down the number of records in a viewlet to display more relevant results. Attribute filters can be valuable when searching for specific use cases, such as queues that get disabled, queues with more than 1000 messages, or objects that do not have specific settings (default persistence). Filters can be applied when creating or editing viewlets. Users can specify multiple attributes for each filter. In versions 10.4.2 and earlier, attribute filters are applied to data that the workgroup server has already returned. In versions 10.5 and later, the workgroup server applies any active attribute filters to data before it is passed to the application server to be displayed in the browser.
Once you create an attribute filter for a particular product and viewlet type, it becomes available for all viewlets for that product and type. For example, if an attribute filter is created for an IBM channel viewlet, it is available on other IBM channel viewlets.
The Active attribute filtering checkbox turns attribute filtering on and off for the viewlet. Select the checkbox to enable attribute filtering.
Whether attribute filtering is enabled or not, the specific attribute filters that you add will remain available for later use.
Search for a filter
You can search for a filter by entering part of its name in the Filter by field. The list is filtered automatically based on your entry.
Add attribute filters
You must have the Manage Private Attribute Filters right to add, edit, copy, or delete attribute filters.
- Click the add button
immediately to the right of the field. The Attribute filters dialog box opens. If you created any filters in the past, they are included in the Filter Name list.
About Sharing Attribute Filters:
-
- Any filters that you have shared have a green Shared Filter icon
on the Attribute Filters dialog. You can view and use filters that others have shared by turning on the Shared Filters slider. Filters that others have shared have a red Shared Filter
icon.
- To share a filter with one or more groups, you must have both Manage Private Attribute Filters and Manage Shared Attribute Filters rights. Turn on the Share Filter slider for the filter in the Attribute Filter Management dialog. From the popup menu, click the eye icon next to the groups you want to share the filter with. The eye icon changes to green
for selected groups.
- Any filters that you have shared have a green Shared Filter icon
- Click Add. The Attribute filter management dialog box opens. Enter a name for the filter within the Filter name field.
- Select one of the following radio buttons:
- Match All: Objects with all attributes specified by the user will be found.
- Match At Least One: Objects with at least one of the attributes specified by the user will be found.
- Click Add to add one or more attributes to the new filter. The Available attributes window appears.
- Click on an attribute to select it. Multiple attributes can be added. The background color of a selected attribute will appear green.
There are two filter methods to locate attributes more easily:
- Filter by name. Use the Enter filter value search box to search by attribute name (part of the name can be entered).
- Filter by category. Use the drop-down list to select the category for the attribute you are looking for. Categories are specific to the viewlet’s object type (for example, queue manager categories may include Cluster and Communication; channel categories may include Statistics and Monitoring).
- Click OK to return to the Attribute Filter Management dialog. The selected attributes will need to be configured. For each attribute, select an option from the Compare operation drop-down. (Options vary according to the data type. Numeric comparisons are is equal, is less than, is greater than, is not equal, is empty, and is not empty. Text comparisons are is equal, is not equal, starts with, ends with, contains, does not contain, is blank, is not blank, and matches pattern. For custom attributes, compare operations are as follows: key exists, key does not exist, is equal, is not equal, starts with, ends with, contains, does not contain, and matches pattern.) Then specify a Value. An example is provided below. (To learn how to set attribute filter criteria on the fly with variable values, see Attribute filter variables.) To remove an attribute, simply click on the red X at the end of the attribute row.
- Click OK after all attributes have been configured.
- The Attribute filters dialog box appears. The left side of the screen displays all created filters. Click on a filter to view that filter’s attributes within the content box on the right side of the screen.
If all attributes must be met, the text, Match ALL of the following, is displayed.
If at least one attribute must be met, the text, Match at least ONE of the following, is displayed. This is specified when adding a new filter, but can be updated when configuring attributes.
Edit a filter
Click Edit to open the Attribute Filter Management dialog, where you can add one or more new attributes, or modify or delete an existing attribute. Existing attributes can be deleted using the delete button.
Create a new attribute filter based on an existing filter
Select the filter that you want to start with and click Copy As…. The Attribute Management dialog opens. You can modify the filter that you copied, give it a new name, and click OK.
Delete a filter
Select the attribute filter that you want to delete and click Delete. Click Yes to delete the selected attribute filter or No to cancel.
Users who have the Manage Private Attribute Filters right can view and manage the filters they have created by going to the User Settings Attribute Filters tab. Likewise, users with the Manage Global Attribute Filters right can manage global filters through the Global User Settings Attribute Filters tab. See Attribute Filter Tab for more information.
No results found
If no attribute values are retrieved by the WGS, a warning symbol is displayed immediately next to the viewlet menu button. Click this button to view the error description.
Click the blue Description button to view the error details.