Tour element

Tours are defined using the Tour element. Users must belong to the PIML Administrative group to import tour configurations. Additionally, any PI Manual Logger application security groups referenced in the DataEntryGroup or FullAccessGroup must already exist within the PI Manual Logger User Database Management.

Example:

<Tour SelectX="x" Operation="CreateOrUpdate">
<TourName>Pump Vibrations and Temperatures</TourName>
<Description>This tour collects temperature and vibration readings.</Description>
<TourSystemDigitalStates>Bad Data;Unit Down</TourSystemDigitalStates>
<DataEntryGroup>PIMLADMINS</DataEntryGroup>
<FullAccessGroup>SouthDataEntryOnlyGroup</FullAccessGroup>
</Tour>

At a minimum, the following attributes and fields must be defined for the Tour element:

• SelectX

• Operation

• TourName

If the FullAccessGroup or DataEntryGroup is not specified, then the PIML Administrative group is the default. Refer to the OSIsoft.PIML.xsd file for a complete list of fields. Only SYSTEM digital states need to be added to the tour. User-defined states are automatically included for tags in the tour.

System Digital States that are associated with a tour are separated by semi-colons, as shown in the above example, and must already reside in the System Digital State list in PI Data Archive.