ReportRunner loadfilter Command and Examples

Use the loadfilter command in ReportRunner to load a named filter or the default filter. Typically, you use the loadfilter command to specify which filter to use, then use the runreport to run the report.

Parameters for the loadfilter Command and Examples

The parameters you can use with the loadfilter command are as follows:

  • --server: The report server name. You can either use the DNS server name or the server IP address.
  • --filter: The filter name.
  • --nofilter: To select a default filter to run a report.

Example: Use the Default Filter

 The following command starts ReportRunner and loads the default filter. (The default filter includes all users, machines, and license units, and all events for the past 30 days.)

ReportRunner loadfilter --server=reportservername --nofilter

Where:

  • ReportRunner is the name of the application.
  • loadfilter is the command for loading a filter.
  • ‐‐server provides the name of the server that hosts the report generation application.
  • ‐‐nofilter specifies the default filter.

Example: Use a Filter You Created

The following command starts ReportRunner and loads a specific filter:

ReportRunner loadfilter --server=reportservername --filter=MyFavoriteFilter

 Where:

  • ReportRunner is the name of the application.
  • loadfilter is the command for loading a filter.  
  • --server is the name of the server that hosts the report generation application.
  • --filter identifies the data filter the report generation process should use when generating reports.

Example: Use a Filter Created by Another User

There are two circumstances in which you can use a report data filter created by another user:

  • You are a report administrator.
  • The person who created the filter chose to "share" the filter.

In these cases, you can add the filter owner's name before the filter name to identify the filter you want to use.

The following command starts ReportRunner and loads a specific filter owned by the reports user whose login name is "fred":

ReportRunner loadfilter --server=reportservername --filter=mydomain\fred:SpecialFilter

Where:

  • ReportRunner is the name of the application.
  • loadfilter is the command for loading a filter.
  •  ‐‐server provides the name of the server that hosts the report generation application.
  • ‐‐filter identifies the filter owner, "mydomain\fred", and the filter name, "SpecialFilter", (created by Fred) that you want to use to when running reports.