Index | Prev | Next

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 76.   Trend Log Multiple Import properties
Image

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 Indicates when the last attempt at an import was executed.
Last Success read-only Indicates the last time the station failed to perform this function.
Last Failure read-only timestamp Indicates the last time the station failed to perform this function.
History Id read-only Displays a combination of the station name and history name.
On Demand Poll Enabled true (default) or false Enables and disables polling of both local history sources and history imports for live data. The reported data appear on history charts and in history table views.
On Demand Poll Frequency drop-down list Configures how often this type of poll occurs.
Config Overrides additional properties Defines the maximum number of history records allowed in the associated table (capacity) and what happens if Capacity is set to Record Count and the specified record count is reached.
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 name of the local history component.
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 name that describes the event or function.

Related Links

  • Trending (Parent Topic)

    • Index | Prev | Next