Manipulating Report Data

From any Report Results page, you can use the tools to manipulate report data for your specific needs. Table 28 describes each tool.

Table 28: Report Tools

Tool

Name

Description

Image invrep_sort_button.gif


Sort

Arranges inventory records in ascending sort order from small to big (where string 123 appears first, followed by string abc, then followed by string ABC); with the exception of event time in descending order (where the latest event appears first). For example, a sort by type will display ADD first, followed by CREATE, DELETE, and UNKNOWN. To sort a report, see Sorting Report Data .

Image invrep_adv_query_button.gif


Advanced Query

Queries report records to display only those based on the criteria that you specify. You can show the query as columns or rows. To filter a report, see Querying Report Data .

Image invrep_config_column_button.gif


Configure Column

Changes the order in which columns appear in an inventory report. To configure report columns, see Configuring Report Columns .

Image invrep_reset_button.gif


Reset

Clears all previously set customized controls such as sort, advanced query, and configure column, then regenerates the report with the default controls.

Image invrep_save_custom_rep_button.gif


Save Custom Report

Saves a report with the customizations that you specified in a file with a unique name that you specify.

Image invrep_xml_button.gif


XML

Displays a report in XML format. To view a report in XML format, see XML.

Image invrep_excel_button.gif


Excel

Displays a report in Microsoft Excel. To view a report in Excel, see Microsoft Excel.

Image invrep_pdf_button.gif


PDF

Displays a report in an Adobe Acrobat viewer. To view a report in Adobe Acrobat in PDF format, see Adobe Acrobat PDF.

Image invrep_text_button.gif


Text

Displays a report in text format. To view a report in text format, see Text.

Sorting Report Data

You can customize a report using predefined or user-defined column sort orders.

To sort a report, follow these steps:

  1. Select and run the report that you want.
  2. In the Report Result window, click the Sort tool. The Sort window appears.
  3. Do one of the following:

Sorting by a Predefined Order

To sort a report by a predefined column sort order, follow these steps:

  1. In the Select a Predefined Sort Order drop-down list box, select the predefined column sort option that you want. The column sort order options differ depending on the type of report you have selected—events, hardware inventory, licensing inventory, or software inventory.

    If you have selected a user-defined sort order, that option displays at the bottom of the Select a Predefined Sort Order drop-down list box.

    Image s001471.gif
  2. Click Submit Query.

Sorting by User-Defined Order

You can sort the records in the columns in primary, secondary, and tertiary order. For example, if two rows have the same values for the primary sort criteria, they will be sorted based on their values for the secondary sort criteria. Records are sorted alphabetically, numerically, or by time (the latest time is the largest value).

To sort by a user-defined column sort order, follow these steps:

  1. Select the primary column item that you want sort. Click the down arrow to view the column selections.
    Image s001472.gif
  2. Select the column sort order: ascending or descending.
  3. Select the secondary and tertiary column items, then select the sort order. Click the down arrow to see the selections.
  4. Click Submit Query.

    Note: If you leave a column sort level blank, sorting stops at the last level you specify.

    Contradicting sorts are ignored. Sort performs the primary sort level, while the secondary contradicting sort level is suppressed.

Querying Report Data

You can specify to display only specific report information in which you are particularly interested. You can show a query as either columns or rows. You can then specify the query criteria.

To perform an advanced query, follow these steps:

  1. Select the report that you want. To run a report, see Viewing a Report.
  2. In the Report Result window, click the Advanced Query tool. The Advanced Query dialog box appears.
    Image s001470.gif
  3. Do one of the following:
    • For events reports, specify the query criteria for the device name, event type, item name, description, event details, serial number, Routing Engine, or time.
    • For hardware inventory reports, specify the query criteria for the device name, model, hardware name, hardware version, part number, serial number, hardware description, chassis ID, module, submodule, sub-submodule, time created. or time last scanned.
    • For licensing inventory reports, specify the query criteria for the device, model, feature name, feature description, free ports used, licenses used, licenses installed, licenses needed, time created, or time last scanned.
    • For software inventory reports, specify the query criteria for the device name, model number, Routing Engine on which the software package is installed, software version, package name, package description, time created, or time last scanned.
    • Select an Device query operator. Table 29 provides a reference for the query operators you can select.

      Table 29: Advanced Query Operators

      Operator

      Description

      =

      (The default operator) Searches for records that exactly equal the search criteria.

      not =

      Searches for records that do not match the search criteria.

      between

      Searches for records that fall between a specified range.

      not between

      Searches for records that do not fall between a specified range.

      in

      Searches for records that match any of the specified values (up to four).

      not in

      Searches for records that match none of the specified values (up to four).

      <

      Searches for records that are less than the search criteria.

      <=

      Searches for records that are less than or equal to the search criteria.

      >

      Searches for records that are greater than the search criteria.

      >=

      Searches for records that are greater than or equal to the search criteria.

      empty

      Searches for records that have an empty value in the specified column/field. For example, perform an advance query for events inventory with "serial number is not empty" and do one with "serial number is empty".

      not empty

      Searches for records that have a non-empty value in the specified column/field.

      like

      Searches for records that match the search criteria.

      not like

      Searches for records that do not match the search criteria.

      Note: For the like and not like operators, use % as the wildcard for the matching target. For example, bad % would match badlands but not toobadlands. To match toobadlands, use %bAd%. The match is case insensitive.

  4. In the Device search text box, type a device name in the Device search text box. You can also click the device name in the report to view all records for
    that report.
  5. Select an event Type search operator.
  6. In the Type search text box, type the event type that you want to see in the Type search text box.
  7. Select a Time search operator.
  8. In the Time search text box, type a time. For this procedure, type the current date and time. You can copy a specific date and time from a report and paste it into the search text box.

    Note: The format for Time is EEE MMM dd HH:mm:ss z yyyy , where:

    EEE = Day in week (for example, Tue.)

    MMM = Month in year (for example, Jan.)

    dd = Day in month (for example, 05)

    HH = Hour in day (for example, 23)

    mm = Minute in hour (for example, 20)

    ss = Second in minute (for example, 47)

    z = Time zone (for example, GMT)

    yyyy = Year (for example, 2004)

  9. Click Submit Query. The criteria you specified is displayed in the Report Result page.

    For example, the following is an all events report advanced query.

    Image s001469.gif

    The query produces the following report.

The like operator applies to columns with a string value such as device, type, item, description, event details, serial number, and Routing Engine in any Events Inventory reports. The like operator does not apply to Time, which has a type of Date.

For more information about using the like operator, see Using the Like Device Query Operator.

To search for all items created on or after 3-5-2004 8pm PST 2004, type the following in the search field: >= Fri Mar 05 20:00:00 PST 2004.

Using the Like Device Query Operator

The like operator uses% as the wildcard character. The following are several examples of how to use the like operator wildcard to display specific information.

Example 1

To search for all Gigabit Ethernet cards on the network, follow these steps:

  1. On the Select a Reports page, select Hardware Inventory > All. The Report Result page appears.
  2. Click Advanced Query. The Advanced Query dialog box appears.
  3. In the And Description drop-down list box, select like.
  4. In the text box next to the And Description drop-down list box, type %G/E%.
  5. Click Submit Query. The Report Result page displays all of the Gigabit Ethernet cards by device.

Example 2

To search for all Gigabit Ethernet PICs on the network, follow these steps:

  1. On the Select a Reports page, select Hardware Inventory > All. The Report Result page appears.
  2. Click Advanced Query. The Advanced Query dialog box appears.
  3. In the And Description drop-down list box, select like.
  4. In the text box next to the And Description drop-down list box, type %G/E%.
  5. In the And Sub Module drop-down list box, select like.
  6. In the text box next to the And Sub Module drop-down list box, type %PIC%.
  7. Click Submit Query. The Report Result page displays all of the Gigabit Ethernet PICs by device.

Example 3

To search for all 4X Gigabit Ethernet PICs on the network, follow these steps.

  1. On the Select a Reports page, select Hardware Inventory > All. The Report Result page appears.
  2. Click Advanced Query. The Advanced Query dialog box appears.
  3. In the And Description drop-down list box, select like.
  4. In the text box next to the And Description drop-down list box, type %4X G/E%.
  5. Click Submit Query. The Report Result page displays all of the 4X Gigabit Ethernet cards by device.

Example 4

To search for a particular PIC, such as an 4X G/E, 1000Base-SX PIC on the network, follow these steps:

  1. On the Select a Reports page, select Hardware Inventory > Search. The Specify Parameters page appears.
  2. In the Description drop-down list box, select 4X G/E, 1000 BASE-SX. The drop-down list box includes a description of all hardware available on the network.
  3. Click Submit Query. The Report Result page displays all of the 4X G/E, 1000Base-SX PICs by device name.

Configuring Report Columns

You can change the order in which columns appear in a displayed report.

To change the column order in a report, follow these steps:

  1. Select the report that you want. To run a report, see Viewing a Report.
  2. In the Report Result window, click Configure Column. The Configure Columns dialog box appears.
    Image s001473.gif
  3. Configure the order of the columns as you want them to appear in your report by selecting a name for each column number. Use the drop-down text boxes to select column names.

    The column options differ depending on the type of report you have selected:

  • For event reports, the default column display order is device, type, item, description, event details, serial number, and time.
    • For hardware inventory reports, the default column display order is device, model, name, version, part number, serial number, description, chassis ID, module, submodule, sub-submodule, created, and last scanned.
    • For licensing inventory reports, the default column display order is device, model, feature name, description, free ports used, licenses used, licenses installed, licenses needed, created, and last scanned.
    • For software inventory reports, the default sort order is device name, model number, Routing Engine on which the software image is installed, software version, software package name, package description, date when the software inventory record was created, and the date when the software inventory record was last scanned.

      Note: The report column sort order you specify remains in effect until you change it again.

      If you leave a column name empty, that column and subsequent columns will not appear in the report.

Resetting Report Customizations

Use Reset to clear all customized controls previously set, such as sort, advanced query, and configure column, and regenerate the report with default controls.

Saving a Custom Report

Use Save Custom Report to save any customization you make on a report, such as sort, advanced query, or configure columns. Saved reports are shared among all users. All saved reports are identified by their unique filenames.

Note: Users with superuser and read-write privileges can save custom inventory reports.

To save a report, follow these steps:

  1. Select and run the report that you want.
  2. Once you have a customized report (for example, sort, advance query, or configure columns), click Save. The Save Report dialog box appears.
    Image s001476.gif
  3. Type a filename in the text box. The report name must always start with a letter, and can contain letters, numbers, and the characters . (period), - (dash), and _ (underscore). You can select a previously saved report to overwrite it.
  4. Click Save or press Enter.

Deleting a Report

Users with superuser or read-only privileges can delete custom inventory reports.

To delete a report, follow these steps:

  1. In the Report Results page, click Custom in the left command pane. The Save Custom Report dialog box appears.
  2. Find the filename of the report you want to open.
  3. Click the Delete [X] icon to the right of the report name.