Configuration of filtered tour lists for PI Manual Logger Web

You can associate tours with tour list filters. By loading a list of tours that match specific filters, you can reduce the space used in your browser's local storage.

In the Tour Configuration window, enter a filter in the Notes field using the following format:

#FilterListName1 #FilterListName2

You can enter multiple filters, but the format must include:

• A space between filter names.

• A # (hashtag) character at the beginning of each filter name.

• Have no spaces within a filter name.

Syntax

The tour list feature in PI Manual Logger Web uses the following syntax:

Note: Filter list names are not case sensitive when used in the URLs, as shown below.

• Tours that match a single tour list filter:

  http://webserver/Piml.Web/#/tours?list=FilterList1

• Tours that match multiple tour list filters:

  http://webserver/Piml.Web/#/tours?list=FilterList1;FilterList2;FilterList3

• Tours that match a single tour list filter, with a tour name provided:

  http://webserver/Piml.Web/#/tours?list=FilterList1&name=TourName

• Tours that match multiple tour list filters, with a tour name provided:

  http://webserver/Piml.Web/#/tours?list=FilterList1;FilterList2&name=TourName

The tour list parameter can be used in the URL when data collectors create a new tour run:

http://webserver/Piml.Web/#/tours?list=FilterList1&tourrun=new&name=TourName

http://webserver/Piml.Web/#/tours?list=FilterList1;FilterList2&tourrun=new&name=TourName

Example

To display all tours that are used for visual inspections, the Tour Notes in each tour that is used for visual inspections would define #VisualInspections and a browser shortcut would have the URL http://webserver/Piml.Web/#/tours?list=VisualInspections.

Web.config application setting

To control how PI Manual Logger behaves when users change tour list filters after initially loading another set of tour runs, you use the PromptForFilterListChangeWhenTourRunDataExists application setting in web.config. The default is false, so that PI Manual Logger Web automatically performs a refresh that sends all tour run data, removes tour run data from local storage, and updates the local tours and configuration. When set to true, a prompt is displayed to users, so they can decide themselves if they want to perform the refresh, send the tour run data and reload the tours and configuration. For more information, see Configure application-level settings.

If no tour run data exists, an automatic refresh of the tours and configuration occurs regardless of the web.config setting. If users are offline, a prompt states that the new tour configuration cannot be loaded for the new list parameter due to being offline.