About history nav shortcuts

Starting in AX-3.5, history nav shortcuts provide convenience navigation links to histories. You can place these shortcuts anywhere in a station to provide a filtered list of individual history shortcuts . The default property values of this component are set to display links to all histories that are under the nav shortcut ancestor device’s name. You can edit properties in the property sheet view to display only the histories you want. History nav shortcuts have a Nav Container view and a History Chart Builder view.

The history shortcuts are not actual histories but links that provide convenient access to a history when you double-click on the shortcut. You cannot drag and drop the history shortcuts onto a Px page and relativize them.

The history shortcut has the following properties:

History Query Predicate

This property allows you to filter the histories by entering a value as a BQL query predicate value. For example, you could enter the following text string: where state=’Georgia’ (note the single quotes) to filter for all histories that have a state property with the value set to “Georgia”. This property works in conjunction with the Only Display Parent Device Histories property.
Only Display Parent Device Histories

This property allows you to restrict the history shortcut filtering to those histories that match the ancestor device of the history nav shortcut component. If set to true, only shortcuts to histories that are identified with the history shortcuts parent device name are displayed. If set to false, shortcuts to all valid (those that match the “BQL query predicate value”) are displayed. In cases where the parent device name is not a valid history device name, you can add a dynamic “historyDeviceName” property, as described below. This property works in conjunction with the History Query Predicate property.

Figure 184. Example History Nav Shortcut property values
historyDeviceName (optional)

Using the History Nav Shortcuts component slot sheet view, you can add a “historyDeviceName” string property to the History Nav Shortcuts property sheet. This additional property allows you to filter for an alternate history device name (in case the History Nav Shortcuts parent device’s name is not a valid history device).

For example, if you place a History Nav Shortcut under a device that has a name “SqlServerDatabase” and a history ID from that RDBMS device are named “/myStation/currentTemp”, then a shortcut for this history is not displayed when the Only Display Parent Device Histories is set to true. However, if you add a historyDeviceName property to the component and set a value of “myStation” in that property, a shortcut for that history displays under the History Nav Shortcuts component.