As with device objects in other a few other drivers, each ObixClient device has a Histories extension that serves as the container for history import descriptors. The default view for any Histories extension is the History Import Manager (and in this case, the “Obix History Manager”). You use it to add history imports, which create histories in the local station with data imported from the oBIX server.
For general information, see the “History Import Manager” section in the Drivers Guide. Also see ObixHistoryManager.
Like the history import managers in other drivers, the Obix History Manager offers a “Learn mode” with a button and pane. Learned oBIX histories are found in the expandable “lobby” after a discover.
To import oBIX histories
Once an ObixClient is added, you can import its histories into the history space of the station.
-
In the Client Manager, in the Exts column, double-click the Histories icon
in the row representing the device from which you want to import histories.This brings up the Obix History Manager.
-
Click the button in the history manger.
This launches an Obix History Discovery job, after which an expandable “lobby” node appears in the discovered pane.
-
In the discovered pane of the Obix History Manager, expand the root “lobby” to see the tree organization. Items of practical interest for histories are typically under a “histories” branch, and appear with a History icon
. -
Double-click a history to add a history import descriptor.
The Add dialog appears, in which you select its “Name” and “History Id”, as well as its execution schedule and (local) collection parameters. For more details, see ObixHistoryImport.
-
Click .
This adds the import descriptor to the database, where it is visible in the database pane of the view, showing “null” as last success. To archive locally (create the local history), click to select one or more import descriptors, then click the button.
-
Continue to add history import descriptors as needed under the Histories extension of each ObixClient device.
As needed, double-click one or more existing import descriptors for the Edit dialog, similar to the New dialog used to create the points. This is commonly done for re-editing items like execution times.
Additional device extensions Alarms and Schedules also exist under an ObixClient. Related “quick start” procedures for these extensions may be added in a later version of this document. See more details in sections ObixAlarmDeviceExt, ObixScheduleDeviceExt, ObixAlarmManager, and ObixScheduleManager.