"connectDirectly"

Synopsis

setValue(string shape, "connectDirectly", string Name, string dp);

shape.connectDirectly(string Name, string dp);

Parameters

Description

This attribute is used to connect data points with a curve.

You cannot use "connectDirectly" if you are going to perform a mathematical operation on the variable value for the trend display. In this case, use a dpConnect() instead. However, the trend display is faster with "connectDirectly" than with a work function dpConnect(). It is not necessary to indicate the "curveHistory" of the variable.

Data point element names have to be defined with the complete string including "Config+Detail+Attribut", for example, "dp.e:_online.._value".

When passing an alias to "connectDirectly" it must end with the _value attribute. The RDB direct query will then pass the alias string as given and in addition a second string where the _value attribute is replaced with _status64, so that the database will get these two attributes.

1. Disconnect the momentarily connected value: TREND.disconnectDirectly("Value");

2. Remove the currently existing data from the trend: TREND.curveRemoveData("Value", getCurrentTime());

3. Now connect the new value with the trend: TREND.connectDirectly("Value", "<datapoint.element>:_online.._value");

To connect a curve with a new data point even though it is already connected, the correct order has to considered. Otherwise display errors inside the trend will occur.

Example

The following example connects the "curve1" of the trend display "TREND1" with the original value of the DP "Number_1.".

 main()
{
  TREND1.connectDirectly("curve1", "Number_1.:_original.._value");
}

Assignment

Trend