Run a PI Manual Logger Web tour

You run a tour from the PI Manual Logger Web home page or by entering a new tour run URL in a browser.

1. Choose from the following actions.

   To...	Do this...
   Run a new tour from the home page	Perform one of the following actions: Double-click a tour in the tour list, or tap and hold the selected tour. Select a tour from the list, and tap or click .
   Update tour list	When a tour configuration is updated, an Updates Available message is displayed under the button. Click . In the Confirmation window, click Yes.
   Enter a URL for a new tour run	Enter a tour run URL in one of the following formats: http://webserver/Piml.Web/#/tourrun?id=new&name=TourName http://webserver/Piml.Web/#/tourrun?id=new&tourname=TourName http://webserver/Piml.Web/#/tourrun?name=TourName&id=new http://webserver/Piml.Web/#/tourrun?tourname=TourName&id=new http://webserver/Piml.Web/#/tours?name=TourName&tourrun=new http://webserver/Piml.Web/#/tours?tourrun=new&name=TourName http://webserver/Piml.Web/#/tours?tourname=TourName&tourrun=new http://webserver/Piml.Web/#/tours?tourrun=new&tourname=TourName Where TourName is the name of the tour. For example, PIMLServerName/piml.web/#/tourrun?name=Pump+Vibrations+and+Temperatures&id=new Note: You cannot use the following characters in tour names: < > " ' &
   Enter a URL for a tour list Note: A tour list is a subset of all your tours. Use when local storage on your mobile device is limited.	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 Note: A PI ML administrator needs to update tour configurations to support the tour list feature. For more information on this feature, see Configuration of filtered tour lists for PI Manual Logger Web in the PI Manual Logger Administration Guide .
   Sort the tour list	Choose from the following actions: To sort the tour list in descending order, click . To reset the tour list in ascending order, click .
   Search for a specific tour	Tap or click the Search Tour Names field. Type the first few letters of the tour name. The list displays only tours with names that match those letters. Select the tour you want and tap or click .
   Continue a recent tour run	Tap or click one of the incomplete tour runs listed in the Recent Tour Runs list.

2. Choose from the following actions.

   To...	Do this...
   Enter data in a single data entry form	For more information, see Data entry for individual tags.
   Enter data in a grid	Tap or click the Switch to grid data entry view link. For more information, see Data entry for tag lists.
   Enter data only for empty tags in an incomplete tour Note: Individual data entry page only.	Select the Navigate to remaining items only check box. Tap or click to go to the next tag in the tour.
   Scan or enter a barcode	For any tag and/or tag group in the tour with which a barcode is associated, tap or click . In the Scan or enter a barcode field, scan or enter a barcode. A Barcode not found message is displayed if you enter an invalid barcode. For more information regarding barcode scanning support, refer to Barcode scanning support.
   Review previous values	Expand See historical values and review the tag history on the individual data entry page. To expand the row details, click , then review the previous value along with the tag history in a trend on the grid page. Trends do not show historical data for strings and time stamps. Note: PI Manual Logger Web now displays the latest historical values from Data Archive instead of the PI ML database.
   View tag attributes Note: Individual data entry page only.	Expand See attributes.
   Modify a tour or tag timestamp	See Change timestamps.

3. In the Value field, enter a valid value for the tag.

   If...	Then...
   A digital tag or SYSTEM digital states are associated with the tour configuration	Click or tap and select a value.
   A value violates a limit	If the limit is configured to: Accept the value, the value is highlighted in yellow. Reject the value, the value is highlighted in red. Require a comment, the Comment field is highlighted and a Required message is displayed.
   Limits have been violated and you attempt to navigate to a different field	A Limit violation occurred error message is displayed. Choose one of the following actions: Click Re-enter to enter a valid value. Click Accept and Continue to confirm that the value is correct.

   Note: If you enter an invalid value, an error message is displayed and you cannot move to another tag before you resolve the issue.

4. In the Comment field, you can enter a comment on the tag. This is usually optional, unless a comment is required after a limit violation has occurred.

   If a comment is entered for a tag that has a value, the comment is written to Annotations in the PI system. The comment is also written to a Comment tag if configured for a tag in Tour Configuration (in PI Manual Logger PC).

5. When you have completed a tag, choose one of the following actions:

   To...	Do this...
   Move to the next tag in the tour	On individual data entry page, press Enter, or tap or click . On grid data entry page, press Enter, or tap or click the Value field on the next row. Note: To enable automatic saving of data to local browser storage, administrators can add an AutoSaveLocally setting in web.config.
   Move to the previous tag in the tour	On individual data entry page, tap or click . On grid data entry page, tap or click the Value field on the previous row.

6. To end a tour, choose one of the following actions:

   To...	Do this...
   Save during a tour run	Tap or click . A Data was saved successfully message is briefly displayed as the tour run is saved to the local browser storage. If wireless connectivity is available, the tour run is also sent to the PI Manual Logger Web Application Server.
   Save and exit a tour run	Tap or click . If the tour run is complete, a Data was saved successfully message is briefly displayed. If the tour run is incomplete, a warning is displayed. Note: This warning is only displayed if the Warn if tour run is incomplete tour option is enabled. Choose one of the following actions: To save the data to the local browser storage, click Yes. The tour run is saved to the local browser storage. If wireless connectivity is available, the tour run is also sent to the PI Manual Logger Web Application Server. To discard the tour run, click No.
   Discard a tour run	Tap or click . Choose one of the following actions: To confirm you wish to cancel the tour run, click Yes. No changes are saved and the tour list is displayed. To return to the tour run, click No. Note: You can also tap or click to discard a tour run.

If the tour run was saved or exited in an offline mode and wireless connectivity is available later, tap or click to send the tour run to the PI Manual Logger Web Application. Tour configurations and historical data for all tags in the local browser storage are refreshed.

Note: OSIsoft recommends you do not close your browser or the PI Manual Logger Web tab during a tour without first saving your existing data. Click the Stay button in your browser and then click .