Niagara History Import Manager

This 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 histories.

You use this view 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 Niagara 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. Example of a 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.

ColumnDescription
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.

  • Cancel ends the current discovery job.

  • Add inserts into the database a record for the discovered and selected object.

  • Archive archives the imported history.

  • Match associates a discovered device with a record that is already in the database.

  • TagIt associates metadata, such as location or unique configuration with the object.