obixDriver-ObixHistoryManager

Use the ObixHistoryManager to discover, add, and managing history imports under the Histories extension (ObixHistoryDeviceExt) of a selected ObixClient or R2ObixClient. The ObixHistoryManager is the default view on the Histories extension. To view, double-click the Histories extension, or right-click and select Views->Obix History Manager.

There is a Discovered table (if in Learn mode) and a Database table. In the discovery pane, objects that have values in the “Start,” “End,” “Count,” and “Query” columns are valid histories, and can be added as ObixHistoryImports.

During discovery, results are cached. Therefore if the server database is modified after a discovery has occurred (or while a discovery is in progress), the discovery pane may be inaccurate. Click the Discover button again to clear the cache.

For details specific to an Niagara R2 to AX application, see the “R2ObixClient Histories (logs and archives)” section in the engineering notes document Niagara R2 to NiagaraAX via oBIX.

Discovered table

The Discovered table in the ObixHistoryManager view has the following available columns:

Obix Name

Name of the history on the oBIX server.
Href

The URI of the history on the oBIX server.
Start

Timestamp of the first record in the oBIX history.
End

Timestamp of the last record in the oBIX history.
Count

Total number of records in the oBIX history.
Query

Similar to Href but with “.log” or “query” suffix to describe history query.

Database table

By default, the following columns appear in the Discovered table of the ObixHistoryManager view:

History Id

Niagara History Id for the history created by the import descriptor, which defaults to:

<name of ObixClient or R2ObixClient> / <oBIX history name>
Status

Status of the history import descriptor.
State

Current state of history import descriptor, as either Idle or In Progress.
Last Success

Timestamp of when the last successful history import occurred.
Href

The URI of the query to the history on the oBIX server.

In addition (using the table options control), the following additional data columns are available:

Name

Niagara name of the history import descriptor, defaulting to the name of the oBIX history.
Execution Time

Reflects the configured time to execute (re-import history).
Enabled

Reflects whether history import descriptor is enabled (true) or disabled (false).
Last Attempt

Timestamp of last attempted history import.
Last Failure

Timestamp of when last attempted history import failed (could not complete).
Fault Cause

Reason why last history import failed.
Full Policy

Full Policy of import descriptor (Roll or Stop).
Capacity

Configured record capacity of import descriptor (Unlimited, or some specific count).