History Import Manager

The History Import Manager is the default view for a device’s Histories extension. Like other managers, it is a table-based view. Each row is a history import descriptor. Each descriptor specifies how log data are imported (pulled) from the device into the Supervisor station as a history.

You use these views to create, edit, and delete history import descriptors. Each import descriptor you add results in the creation of a local history-regardless if the source log data came from a BACnet Trend Log, history, or other type of data log (depending on driver type, and parent device’s component type).

This view provides a status summary for collecting imported histories. You can also use it to issue manual Archive commands to one or more history descriptors. This causes an immediate import request to pull logged data from the remote device.

Note: Only history import descriptors appear in the History Import Manager view. Other components that may also reside under Histories do not appear. For example, you do not see the default Retry Trigger component. However, you can use the Histories Property Sheet to access these items.

Figure 1. History Import Manager under a BacnetDevice (Trend Logs)

To open this view, expand Config > Drivers, expand the driver and double-click the histories node (Trend Logs in the example above).

Columns

The information in this view depends on the specific driver. These columns are available in the NiagaraNetwork’s History Import Manager.


Column	Description
Name	Reports the name of the descriptor (file, import or export).
History Id	Reports the history ID.
Execution Time	Reports when the import of this history occurs.
Enabled	Indicates if history import is enabled (`true`) or disabled (`false`).
Status	Reports the condition of the import descriptor. Usually `{ok}` unless Enabled is false, in which case it reports `{disabled}`. If there is a problem it reports `{false}` with a reason in the Fault Cause.
State	Reports the current state of the data transfer as: `Idle`, `Pending` or `In Progress`.
Last Attempt	Reports the date and time of the last attempted import.
Last Success	Reports the date and time of the last successful import.
Last Failure	Reports the date and time of the last time the import job failed.
Fault Cause	Reports the reason for a failure.
Capacity	Reports the total number of history records allowed in the table.
Full Policy	Reports what happens when the table reaches capacity.
On Demand Poll Enabled	Reports the on-demand polling rate: `Fast`, `Normal` or `Slow`.
On Demand Poll Frequency	Indicates how frequently the station polls for history data.
System Tag Patterns	Reports one or more tag text strings used to filter imported records.

Buttons

New Folder creates a new folder for devices. Each such folder provides its own set of manager views.
New creates a new device record in the database.
Edit opens the device’s database record for updating.
Discover runs a discover job to locate installed devices, which appear in the Discovered pane. This view has a standard appearance that is similar to all Device Manager views.
Add inserts into the database a record for the discovered and selected object.
Match associates a discovered device with a record that is already in the database.
Archive imports (pulls data) into one or more selected histories.
TagIt associates metadata, such as location or unique configuration with the object.