Bacnet History Import (bacnet-BacnetHistoryImport)

This component configures the retrieval of data from the station database for the purpose of archiving data in a trend log (history).
Figure 77.   Bacnet History Import properties
Image

To access this property sheet, double-click the BacnetHistoryImport component in the Nav side bar.

You add BacnetHistoryImports (import trend logs) using the Bacnet History Import Manager view of the parent BacnetHistoryDeviceExt.

In addition to the common properties (Status, Enabled and Fault Cause), this component has these properties.

Property Value Description
State read-only
Indicates the condition of the BACnet schedule.
Execution time multiple properties
Configures the frequency with which data are imported from a remote trend log (or trend log multiple) into a history (or histories). Data import may occur at regular intervals (Interval), Daily or when manually requested (Manual).

Time Of Day specifies a specific daily time.

Randomization configures an import based on time.

Days Of Week specifies on which days to apply the import time.

Last Attempt read-only
Reports the date and time of the last attempted execution.
Last Success read-only
Reports the last time the station successfully performed this function.
Last Failure read-only timestamp
Reports the last time the system failed to perform this function. Refer to Fault Cause for details.
History Id read-only
Displays a combination of the station name and history name.
On Demand Poll Enabled true (default) or false
Determines user control over polling.

true enables a system user to use the Live Updates (play) button in History views to poll for live data for the associated imported history(ies).

false renders this button unavailable in history views for the associated imported history(ies).

On Demand Poll Frequency drop-down list
References the On Demand Poll Scheduler rates under the NiagaraNetwork’s History Policies container slot.

Configures how often this type of poll occurs.

Config Overrides, capacity drop-down list (defaults to Unlimited)
Defines the maximum number of history records allowed in the associated table.

Unlimited enforces no limitation on the number of records.

Record Count opens an additional property for defining the table limit.

Config Overrides, fullPolicy drop-down list (defaults to Roll)
Defines what happens if Capacity is set to Record Count and the specified record count is reached.

Roll overwrites the oldest records with the newest ones. This ensures that the latest data are recorded.

Stop terminates recording when the number of stored records reaches the specified capacity.

Full policy has no effect if Capacity is Unlimited.

Object Id drop-down list and number (from 0 to 4194302)
Identifies each device and component by the type of entity (Object Id) combined with a unique Instance Number.

For devices (controllers, instruments, meters, etc.), Instance Number must be unique within the BACnet internetwork. For components (points, schedules, analog inputs, files, groups, multi state inputs, etc.), it must be unique within the device.

Local History Name read-only
Reports the names of local trend logs.
Local History Name Format text, BFormat (Baja Format) syntax (defaults to %name%, which recreates the BACnet name of the trend log object) or a combination of text and BFormat.
Defines the format string script for returning a local history. This is the name of the history initially created and populated by the trend log data and includes, typically, the name of the BACnet device component and the BACnet trend log object.

For example: %parent.parent.displayName% %name% could define the name of a VAV fan: J7Bnet BldgA_VAV1_Fan.

You can modify the default BFormat with other BFormat scripting. You could enter static text for the history name—or, some combination of static text and valid BFormat scripting text.

In the case of trend log multiples (BacnetTrendLogMultipleImport), the default %name% value results in histories named using the BACnet name of the trend log multiple object, with underscore delimiters between the BACnet names of each _object_property record.

Reference Time hours, minutes, seconds
Defines the timestamp the system uses to include records in the trend log.
Max Records Per Request 0 (default) to max
Defines the maximum number of records that can be archived in this trend log. The Framework asks for 10 records per request.
Always Request By Reference Time true or false (default)
Configures if the driver should always use the Reference Time to request records.
Last Sequence Number Processed number
Defines a maximum record number to process.