Filter Management in Junos Space Platform User Interface

Understanding Filtering Options in Junos Space Platform User Interface

• Overview

• Benefits

• Pages and Columns that Support Filtering

Overview

On various Junos Space Platform pages, you can use the Filter menu to show or hide table entries based on the filtering criteria that you specify. Filters enable you to quickly find and evaluate the entries that are relevant to your specific needs.

Many of the columns in Junos Space page tables support filtering. To know whether or not a column supports filtering of data, click the down arrow next to the column name. If the Filter submenu appears, then that column supports filtering of data. The filtering criteria that are available for you depend on the selected column. You can create filters that combine criteria from more than one column.

From Release 17.2R1 onward, Junos Space Platform introduces the following enhancements to filtering options:

• Ability to save, modify, and delete filters

• Ability to share saved filters with other users

• Ability to mark filters as favorites

• Ability to manually enter filter conditions with autocomplete and suggestion support.

For a list of pages and columns that support filtering, see Pages and Columns that Support Filtering.

In releases earlier than 17.2R1, Junos Space Platform supports only basic filtering. In those releases, you can specify only one set of filter criteria at a time, and the filter setting is lost when you modify the criteria. From Junos Space Platform Release 17.2R1 onward, you can save multiple filters. You can also mark up to 10 filters as favorites in each of the pages that support enhanced filtering.

The Filter menu that appears when you click the filter icon lists up to 10 filters. The 10 filters that are listed in the Filter menu are arranged in the following order of filter categories: favorite filters, public filters, and private filters. If there are more than 10 filters, those filters are listed under the More Filters submenu.

If you have Filter Management permissions to create or modify filters, you can also choose to share the saved filters with other users by marking the filters as public.

For more information about creating, saving, modifying, and deleting filters, see Managing Filtering Options.

From Junos Space Platform Release 17.2R1, you can also manually enter filter criteria in the filter text box that appears when you click the Show/ Clear and Hide Filters option from the Filter menu. For more information about manually specifying filter criteria, see Creating Filters by Manually Entering the Filter Criteria.

Benefits

Filters enable you to quickly find and evaluate the entries that are relevant to your specific needs. Ability to save and share filters enables you to configure multiple filters for a page that can be preserved across sessions and shared with multiple users.

Pages and Columns that Support Filtering

• Pages and Columns that Support Enhanced Filtering

• Pages That Support Basic Filtering

Pages and Columns that Support Enhanced Filtering

The following table lists the pages and columns that support enhanced filtering and also the data types for each of the columns:

Pages That Support Basic Filtering

Junos Space Platform supports basic filtering options on the following pages:

• Role Based Access Control > Domains

• Administration > CA/CRL Certificates

• Administration > SMTP Servers

• Administration > DMI Schemas

  Note

  Filtering is supported only for the State and Schema Installed columns.

Managing Filtering Options

• Creating Filters by Manually Entering the Filter Criteria

• Creating Filters by Using the Filter Submenu Options

• Saving a Filter

• Modifying a Filter

• Creating a Public Filter

• Applying a Filter

• Clearing a Filter

• Deleting a Filter

Creating Filters by Manually Entering the Filter Criteria

From Junos Space Platform Release 17.2R1 onward, you can manually enter the filtering criteria to create the filters that meet your specific requirements.

1. From any of the pages that support Filter Management options, click the Filter icon.

   The Filter menu appears.

2. Click Show/ Clear and Hide Filters on the Filter menu.

   The Filter field appears.

3. Click inside the Filter field.

   A list showing the names of columns that support filtering and the following two options appears:

   • An opening parenthesis [ ( ] symbol. The bracket enables you to group conditions. A closing parenthesis [ ) ] symbol appears in the list after you specify a condition if you used an opening parenthesis before specifying the condition.

   • Not. The Not option enables you to specify conditions based on which you want to filter out entries.

4. From the list, select the columns for which you want to specify the filter conditions and specify the conditions by using any of the operators supported for the specified column. Table 1 lists various operators that you can use for each of the data types supported for filtering.

   You can specify multiple conditions by using an AND or an OR operator. The Filter field supports autocomplete and provides suggestions for column names, attributes, and operators even as you type inside the field.

   Note

   If the values you enter for any of the parameters contain spaces, enclose such values in single quotation marks. For example, Domain Contains 'test domain'. However, if the single quotation mark is part of the search string, use the backslash escape character (\) before the quotation mark. For example: Domain Contains '\'test domain\''.

   Table 1: Data Types and Supported Operators

   Data Type	Supported Operators
   String (Other than Domain Column)	Starts-with
   	Ends- with
   	Contains
   	=
   	!=
   String (Domain Column only)	Contains
   	Not-contains
   Numbers or Date	=
   	!=
   	>
   	<
   	<=
   	>=
   List	=
   	!=

   The following examples show samples of manually entered filter criteria:

   • ID > 2000000 AND 'Job Type' ends-with 'elements' AND Parameters contains '1.1.1.1' OR Parameters = 192.168.27.72 AND Owner = SUPER

     This filter on the Job page displays jobs that meet the following criteria: The job ID is a number greater than 2000000, the job type ends with the text elements, the Parameter field contains 1.1.1.1 or 192.168.27.72, and the owner is the superuser.

   • ( 'Connection Status' = 'down' ) AND ('Managed Status' = 'In Sync' OR 'Managed Status' = Synchronizing ) AND 'Device Family' starts-with 'junos'

     This filter on the Device page displays devices that have the connection status set to down, the managed status set to in sync or synchronizing, and device family name starts with Junos.,

5. After you enter the conditions, you can save or apply the filter. To save the filter, click the Save Filter icon and complete the steps as explained in Saving a Filter. To apply the filter without saving, click the Apply Filter icon. For more information about applying filters, see Applying a Filter.

   To clear the filter conditions you entered or the filter that you applied, click the Clear Filter icon. Alternatively, you can click the Clear and and Hide icon to clear the filters and hide the filter bar.

For a list of error messages, see Error Conditions and Error Messages for Filters.

Creating Filters by Using the Filter Submenu Options

Many of the columns in Junos Space user interface tables support filtering. To know whether or not a column supports filtering of data, click the down arrow next to the column name. If the Filter submenu appears, then that column supports filtering of data. The criteria that are available for you to filter on depend on the selected column. You can create filters that combine criteria from more than one column.

On Junos Space pages that support enhanced filtering options, the Filter field and the Save Filter, Apply Filter, and Clear Filter icons appear when you select any of the items from the Filter submenu. The selected criteria are displayed in the Filter field. You can choose to apply, save, or clear the filtering criteria by clicking the appropriate icon.

On Junos Space pages that do not support enhanced filtering options, when you select any of the items from the Filter submenu, Junos Space Platform displays the filter criteria, including the columns being filtered, above the table. Junos Space Platform displays a red X to the left of the filter criteria above the table. You can clear the filter and restore the table to its original view by clicking the X.

Figure 1 shows a typical Filter submenu for a date column.

Figure 1: Typical Submenu for a Date Column

The following procedures describe how to use the different types of available filters.

1. On the Junos Space Platform UI, click the down arrow on the column header and select Filters.

   The Filters submenu appears, displaying the list of operators or values that you can select, based on the type of values in the column.

2. Based on the submenu that appears, perform one of the following procedures.

   To specify filters for a date field:

   1. From the Filter submenu, select Before, After, or On.

      You can select both Before and After dates and times to filter the entries by a specific time period. You can also select On to view events recorded on a specific date.

   2. Click the calendar icon and select the date from the calendar.

      You can click Today to view the events that occurred today at the specified time.

   3. Click the arrow beside the time list and select the time.

   To specify filters for a text field:

   1. In the text box that appears, type the alphanumeric string based on which you want to filter entries.

   To specify filters for a field with discrete values such as Success or Failure, or True or False:

   1. From the list of values that appears, select the check boxes for one or more values based on which you want to filter entries.

   To specify filters for a numeric field:

   1. Enter values for each operator that you want to specify.
3. Click Go to view the entries filtered based on the criteria that you specified.
4. On pages that support enhanced filtering options, you can choose to save the filter after you specify the required criteria. To save the filter, click the Save Filter icon and complete the steps as explained in Saving a Filter. To apply the filter without saving, click the Apply Filter icon. For more information about applying filters, see Applying a Filter.

   To clear the filter conditions you entered or the filter that you applied, click the Clear Filter icon.

You can also filter entries based on combined filters with different criteria specified for different columns. For example, you can filter for all events on a certain date whose status was success. When you use multiple filters, the filters are joined using the logical AND operator.

To clear only the part of a filter that applies to a any of the columns, click the down arrow on the column header and clear the check box next to Filter.

Saving a Filter

You can create a filter either by using the filtering options that are available in the Junos Space Platform UI or by manually entering the filter criteria in the Filter field that appears when you click the Filter icon. After you specify the filtering criteria, you can save the filter.

1. Create a filter as explained in either of the following topics:

   • Creating Filters by Manually Entering the Filter Criteria

   • Creating Filters by Using the Filter Submenu Options

   The criteria you specified, either by typing in the Filter field or by using the Filter submenu options in the Junos Space Platform UI, appear in the Filter field.

2. Click the Save Filter icon next to the Filter field.

   The Save Filter page appears.

3. In the Name field, enter a name for the filter.
4. (Optional) In the Description field, enter a description for the filter.
5. (Optional)To share the filter with other users, select the Make Public check box.Note

   You cannot change a public filter to a private filter after you save the changes. However, you can change a private filter to a public filter from the Modify Filters page.

6. (Optional) If you want to mark the filter as a favorite, select the Mark as Favorite check box.

   Alternatively, you can add a filter to the list of favorites or remove a filter from the list of favorites from the Manage Filters page.

7. Click Save to save the filter. To close the page without saving the filter, click Cancel.

Modifying a Filter

From the Manage Filters page. you can modify saved filters.

1. From the Junos Space Platform UI, go to the page that contains the filter that you want to modify. For example, the Device Management or View Physical Devices page.
2. Click the Filter icon to view the Filter menu.
3. From the Filter menu, click Manage Filters.

   The Manage Filters page appears.

4. From the list of filters, click the filter entry that you want to modify.

   The selected filter entry appears highlighted.

5. Modify the following parameters as required:

   • Name–The name of the filter.

   • Description–Description for the filter.

   • Filter Criteria–Filter criteria to apply for the filter. For information about manually entering the filter criteria, see Creating Filters by Manually Entering the Filter Criteria.

   • Make Public–Specify whether the filter is a public filter. Public filters are available for all users. However, note that only users with Filter Management permissions to create or modify filters can create public filters. This check box is disabled if the selected filter is a Public filter. That is, you cannot clear this check box after you select this check box and save the filter.

     Note

     To create a public filter, you must have both Create Filter and Modify Filter roles assigned to your account.

   • Mark as Favorite–Specify whether the filter is a favorite or not. You can select this check box to mark the selected filter as favorite. To remove a filter from the list of favorites, clear this check box. Favorite filters are listed on top of the Filter menu options. If there are favorite filters and filters that are not marked as favorites, the filters that are not marked as favorites appear in the More Filters submenu.

6. Click Modify to save the changes. Click Reset if you want to discard the changes.

For a list of error messages, see Error Conditions and Error Messages for Filters.

Creating a Public Filter

Public filters are filters that are available to all users. To create a public filter, you must have both Create Filter and Modify Filter roles assigned to your account. Junos Space Platform adds the suffix (Public) to the names of filters that are made public.

1. When you save a filter, select the Make Public check box. For more information about saving filters, see Saving a Filter.
2. When you modify a filter, select the Make Public check box. For more information about modifying filters, see Modifying a Filter

Applying a Filter

Junos Space Platform provides you multiple options to apply a filter.

• From pages that support enhanced filtering, you can apply a filter by clicking the name of the filter from the Filter menu. Alternatively, while creating a filter, you can click the Apply Filter icon (the green tick mark) next to the Filter field.

• From pages that do not support enhanced filtering, you can apply a filter by selecting and specifying filter options from the Filter submenu available for columns that support filtering and then clicking Go.

Clearing a Filter

Junos Space Platform provides you the following options to clear a filter that is applied to a page.

• On Junos Space pages that support enhanced filtering options, if a filter is applied to the page, the filter criteria is displayed in the Filter field. You can click the Clear Filter icon to clear the applied filter. Alternatively, you can click the Clear and Hide Filters icon from the Filter bar or the Show/Clear and Hide item in the Filter menu.

• On Junos Space pages that do not support enhanced filtering options, when you select any of the items from the Filter submenu, Junos Space Platform displays the filter criteria, including the columns being filtered, above the table. Junos Space Platform displays a red X icon to the left of the filter criteria above the table. You can clear the filter and restore the table to its original view by clicking the X icon.

Deleting a Filter

From the Manage Filters page. you can delete saved filters.

1. From the Junos Space Platform UI, go to the page that contains the filter that you want to delete. For example, the Device Management or View Physical Devices page.
2. Click the Filter icon to view the Filter menu.
3. From the Filter menu, click Manage Filters.

   The Manage Filters page appears.

4. From the list of filters, click the filter entry that you want to delete.

   The selected filter entry appears highlighted.

5. Click the Delete icon above the top-left corner of the list of filters.

   The Delete Filter page appears.

6. On the Delete Filter page, click OK. Click Cancel if you do not want to delete the selected filter.

Error Conditions and Error Messages for Filters

The following table lists common error conditions you might encounter while saving or applying filters and the error messages for those conditions: