beautypg.com

Methods, Getdatapoint, Getdatapoint m – Echelon OpenLNS User Manual

Page 182

background image

OpenLNS Programmer's Reference

145

Methods

The ConfigProperties

object contains the following methods:

GetDataPoint

GetRawValuesEx

SetRawValuesEx

SetValueToUnknown

GetDataPoint

Summary

Returns a

DataPoint

object that can be used to read or write

the configuration property value.
Use this method to read and write configuration property

values instead of the deprecated

ValueFromDevice

,

RawValueFromDevice

,

Value

and

RawValue

properties.

If the data point created applies to an element in an array,

the element’s index will be stored in the data point’s

SourceIndex

property. You can write to this property to apply

the data point to another element of the array later (see the

SourceIndex

property for more information). To read or write

to an entire configuration property array at once, you can use

the

GetRawValuesEx

and

SetRawValuesEx

methods.

Availability

Local, full, and lightweight clients.

Syntax

dpObject=configProp.DataPoint index, options

Element

Description

dpObject

The

DataPoint

object returned.

configProp

The

ConfigProperty

object being acted upon.

index

Specify which element in the configuration

property array to which the data point

applies.
Configuration properties may be stored in

array. In this case, you need to create a

separate data point to read and write to

each element in the array. If the

ConfigProperty

is not a configuration

property array, specify 0 as the index

element.

options

Specify how LNS reconciles differences

between the value of the

ConfigProperty

in

the OpenLNS database and the physical

application device when you read or write

to the

DataPoint

.

The possible values for this element, which

are stored in the

ConstDataSourceOptions

constant, are as follows:
0 lcaDataSourceOptionsNormal