Bacnet Trend Log Multiple Import (bacnet-BacnetTrendLogMultipleImport)

This component defines the archive action to retrieve data from a BACnet trend log multiple object into a history created by the addition of this component.

This component monitors and records values for one or more properties of one or more referenced objects, either in the same device or in an external device. A key feature is that the extension records all values using the same timestamp. One import descriptor typically results in multiple histories in a station—one history per object/property value in the record.

You add BacnetTrendLogMultipleImports (import Trend Log Multiples) using the Bacnet History Import Manager view of the device’s parent trend logs extension. This import descriptor also has its own special Bacnet Trend Multiple View.

You can also copy a ClientTrending component from the bacnet palette. This component contains a BacnetTrendLogMultipleImport component.

A BACnet device must contain trend log objects (and/or trend log multiple objects) to make use of histories. A discover command determines this. If it finds no such objects, the Trend Logs extension has no practical application.

Figure 78. Trend Log Multiple Import properties

To access these properties, expand Config > Drivers > BacnetNetwork > BacnetDevice > Trend Logs > ClientTrending and double-click a trend log descriptor.

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	additional properties	Configures the facets to use when converting values from device facets to point facets.
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.
Local History Names	read-only	Reports the names of local trend logs.

Bacnet Trend Log Multiple Import (bacnet-BacnetTrendLogMultipleImport)

Figure 78. Trend Log Multiple Import properties

Related Links