● Built-in Filters
● Filter Manager and Editor
● Filtering On Special Column Types
You can use filters to limit the content of any device list based on specific criteria. You can also apply filters to other features, such as automatic device groups.
Characteristics of filters are:
● Multiple layers of filtering can be created by using AND/OR operators.
● Filters can be stored and also shared with other users.
● Some built-in filters are available when HP Web Jetadmin is installed.
● Filters can be added as filtered lists in the left navigation pane.
Available actions for filters listed on the Filters menu (accessible from the toolbar) are:
● Built-in: Apply a built-in filter, such as Color Devices or Error Devices, to the displayed device list.
● Shared: Apply a filter that is designated as Shared in the Filter Editor.
● Private: Apply a filter that is not designated as Shared in the Filter Editor.
● Clear: Clear the filter from the selected devices in the device list.
● New: Use the Filter Editor to create a filter.
● Edit: Use the Filter Editor to edit a filter.
● Save As: Save a filter with another name.
● Manage: Use the Filter Manager to create, edit, and delete filters.
Built-in Filters
The following built-in filters are available from the Filter menu:
● Color Devices: Any devices with color capability.
● Error Devices: Any devices with a severity of "Error".
● Information Devices: Any devices with a severity of "Information".
● New (Last Discovery): Any devices that were added to the All Devices list since last discovery.
● Non-Unique Devices: Any devices that do not have a unique serial number.
● PC-Connected Devices: Any devices that were discovered through PC-Connected device discoveries.
● Ready Devices: Any devices that are in a ready state.
● Ungrouped Devices: Any devices that are not a member of a group.
● Warning Devices: Any devices with a severity of "Warning".
Filter Manager and Editor
● Building a Compound Filter
● Steps for Creating (or Adding) Filters
ENWW Device Lists 101
● Steps for Editing Existing Filters
● “Save As” Filters
● Managing Filters
● Steps for Applying Filters for Device Lists
The Filter Manager and the Filter Editor are two filtering features in Device Lists that work together to help you add and manage filters:
● Filter Manager: Displays all filters in HP Web Jetadmin; through the Filter Manager you can add a new filter, edit an existing filter, or delete a filter.
● Filter Editor: Invoked when you choose to add or edit any filter; you can also delete filters using this tool.
HP Web Jetadmin supports Microsoft's Global Input Method Editors (IMEs). An IME is a program that allows computer users to enter complex characters and symbols, such as Japanese characters, using a standard keyboard. For more information, see Microsoft's technical documentation.
Building a Compound Filter
If you create a basic filter and do not get the results you need, you can create a compound filter. After you create a basic filter in the Filter Editor, you can select Advanced to view its layers. For example:
GT([IP Address], [192.168.40.0]) AND LT([IP Address], [192.168.47.255]) AND EQ([Device Name], [HP LaserJet 4100 MFP]) OR EQ([Device Model], [HP Color LaserJet 4730 MFP])
The Advanced feature can be used to change the filter into two sub-filters that are compounded. Use the AND function and add some open and closed parentheses:
(GT([IP Address], [192.168.40.0]) AND LT([IP Address], [192.168.47.255])) AND (EQ([Device Name], [HP LaserJet 4100 MFP]) OR EQ([Device Model], [HP Color LaserJet 4730 MFP]))
NOTE: For backward compatibility with previous releases, HP Web Jetadmin still supports alternate symbols, such as quotes (") and apostrophes ('), to enclose parameters for filter functions. HP Web Jetadmin automatically changes alternate symbols to brackets when you exit the Advanced editor.
After this compound filter is added to the Specify filter criteria page, the Basic feature can no longer be used (you will receive an error message).
Steps for Creating (or Adding) Filters
1. Access a device list. In the toolbar, click Filters, and then click Manage. The Filter Manager page is displayed.
2. Click New. The Filter Editor page is displayed.
3. Type the name for this new filter in Name.
4. To make this filter visible to other users, select Shared. If the filter is not shared, it is only visible to the user who created it.
5. If the filter is shared, you can choose to have it display in the left navigation pane under the All Devices list by selecting Available Under All Devices.
6. If you select Advanced, a text field is displayed where you can manipulate filter attributes that are expressed in explicit text rather than through a graphical interface. An example of this content is show
102 Chapter 3 Device Management ENWW
here: Contains([Asset Number], [2]) AND Contains([Asset Number], [1], [Match Case])
An invalid string should be blocked from being applied to settings. An Insert feature is provided to place operators and functions into the advanced filter content. A Validate feature is provided to report problems with the advanced filter content if any exist.
7. If you select Basic, click Add. Now you can specify:
● Category: Specifies the columns that are displayed in the Device Property drop-down list.
● Device Property: Device and system attributes, which are the same as HP Web Jetadmin columns.
● Not: Check box that invokes “not” filtering. When an attribute matches the filter functions, the device will NOT be shown in the list.
● Filter Function: A set of standard operators that give flexibility to the device property definition.
These operators will change depending on the Device Property selected.
Once multiple selections are chosen and displayed in Filter Function, you can choose “AND” or
“OR” (the default is “AND”).
● Value: Provides an entry point to define the Filter Function and Device Property value. This can either be a free text field or a pre-populated drop-down menu depending on the Device Property selected.
● Options: Contains features that further describe the content of free text. Examples are “Match Case” and “Ignore Case”. This feature is only active when free text fields are available.
8. When done, click OK. The Filter Editor is displayed with your selections.
9. When done, click Close. The device list is displayed.
Steps for Editing Existing Filters
1. Access a device list. In the toolbar click Filters and then click Manage. The Filter Manager is displayed.
NOTE: You can also edit filters through the top menu bar View > Filters.
2. Select the filter you want to edit, and then click Edit. The Filter Editor page is displayed.
3. Make the changes to the existing filter.
4. When done, click OK. The Filter Manager page is displayed.
5. When done, click Close. The device list is displayed.
“Save As” Filters
1. Access a device list. In the toolbar click Filters and then select Save As. The Save Filter As is displayed.
2. Apply the filter you want to copy to the new filter.
3. In the toolbar, click Filters, and then select Save As. The Save Filter As page is displayed.
4. Specify the name of the new filter, and then click OK. You can now edit the filter definitions of the new filter.
Managing Filters
1. Access a device list. In the toolbar click Filters and then select Manage. The Filter Manager is displayed.
2. Select the filter and then click:
ENWW Device Lists 103
● New: Create a filter.
● Edit: Edit a filter.
● Copy: Copy an existing filter to create a new filter.
● Remove: Delete a filter.
3. Follow the steps for the action requested.
Steps for Applying Filters for Device Lists
1. Display the device list on which you want to apply the filter.
2. In the toolbar click Filters and then click one of the following:
● Built-in: Apply a built-in filter, such as Color Devices or Error Devices, to the displayed device list.
● Shared: (If there are shared filters); Lists any filter that has been designated as “shared” in the Filter Editor.
● Private: Access all filters that are not shared (as specified in the Filter Editor).
3. Select the filter from the list. The device list will automatically display only those devices that match the criteria in the selected filter.
4. To view all devices again, click Filters and then select Clear.
Filtering On Special Column Types
Some device list columns show a summary value rather than the actual data stored on the device or in the HP Web Jetadmin database. This is because the actual data is too complex to be represented in a column cell.
These columns are treated differently for the display and filter features. The display feature shows an indicator in the column cell. The filter feature can act on the actual underlying data. Examples of columns like these are the Device Groups column and the SNMP Trap Destination Table column.
Two examples of how these columns work and how filtering can be used are:
● The Device Groups column for a device belonging to just one group shows the actual name of that group. The Device Groups column for a device belonging to more than one device group shows the indicator value <Multiple>. The Device Groups column for a device belonging to no device groups will show the indicator value <None>.
Filtering can be used to filter devices that belong to a particular device group by using the Device Groups filter property and the value of the device group name. An example taken from the Advanced edit mode of HP Web Jetadmin filtering is shown here:
Contains([Device Groups], [Test])
● The SNMP Trap Destination Table column always uses the summary rather than the actual data from the device’s trap destination table. This is because the data on the device trap destination table is too complex to be displayed properly within a column cell. The summary used in the SNMP Trap Destination Table column cell is <number1> of <number2>, where number1 is the actual number of entries in the trap destination table and number2 is the maximum number of possible entries in the trap destination table.
For example, a device having a potential for three trap destination table entries with only one of those being used will appear 1 of 3 in the SNMP Trap Destination Table column. Tooltip functionality (which is a text message resulting by hovering your mouse over the column cell) can be used to reveal the contents of a device trap destination table. For example, the following tooltip could appear when activated for a cell:
104 Chapter 3 Device Management ENWW
2 of 3
Slot,Trap Destination,Port,Version,Community 1,192.168.0.254,27892,v2c,wja
2,192.168.0.6,27892,v2c,wja
Further, HP Web Jetadmin filtering features can be utilized to find devices that do or don’t have specific trap table entries. For example, filtering can be used to see if a list of devices has a certain IP address present in any of their trap destination tables. Here is an example take from the Advanced edit mode of
HP Web Jetadmin:
AnyItem([SNMP Trap Destination Table (obsolete).Trap Table Entries], [EQ(\
[Trap Table Entry.IP Address\], \[192.168.0.254\])])
Another example of using HP Web Jetadmin filter features on the SNMP Trap Destination Table uses regular expression. Taken from the Advanced edit mode of HP Web Jetadmin:
RegEx([SNMP Trap Destination Table (obsolete)], [(?<entries>[0-9]+) of
\k<entries>\r])
This example shows a filter that will filter the list to only devices with full trap destination tables.
NOTE: Some complex columns do not support filtering on the individual subitems. For these columns, the filter compares the filter value to the export text for the item that represents the subitems as nested XML tags. For more information about filtering in complex columns, see the white papers that are available from the HP Web Jetadmin support page.