Selfdocconsistency – Echelon OpenLNS User Manual

Page 320

Advertising
background image

OpenLNS Programmer's Reference

283

Each DeviceTemplate object in an OpenLNS database may have a

single device control registered for it. A null value in this

property indicates that there is no registered device control for

this DeviceTemplate object.
To support device controls, a director application must follow

these steps when creating a new device:
1. Examine the RegisteredComponent property of the

DeviceTemplate object for the new device. If a device control

is registered, create an instance of the control using the

ActiveX name in the RegisteredComponent property.

2. Assign the instance of the control created to the deprecated

ActiveXComponent property of the new AppDevice object.

3. Invoke the deprecated OpenComponent method of the new

AppDevice object.

Availability

Local, full, and lightweight clients.

Syntax

regComp = dtObject.RegisteredComponent

Element

Description

regComp

The registered component for this

device template.

dtObject

The

DeviceTemplate

object to be acted

on.

Data Type

String.

Read/Write

Read/write.

Added to API

Prior to LNS Release 3.0.

SelfDocConsistency

Summary

Determines how much OpenLNS will assume about the self

documentation of devices that are using this template. This affects

how OpenLNS will read the self-documentation data of those

devices, and what level of program interface validation OpenLNS

will perform when commissioning those devices.
All Neuron hosted devices and host-based devices contain

self-documentation data. Some of this data appears in a device’s

external interface file. OpenLNS uses a device’s

self-documentation data to communicate with it. The setting of

this property affects how OpenLNS will read the

self-identification data of devices using this template, and what

level of program interface validation OpenLNS will perform when

commissioning those devices.

Availability

Local, full, and lightweight clients.

Syntax

consistencyValue = devTemplateObject.SelfDocConsistency

Element

Description

consistencyValue

The self-documentation consistency flag

assigned to devices using this device

Advertising