Configuring Message Texts

You can configure message texts received from IC Transliner. There are two attributes in the OIS Tools, which allow you to display the name of data points and to map IC Transliner event attributes to Siveillance Control attributes:

Attribute Name

Description

Default

Required

text_assign_transliner_vudp

Defines the text assignment of the Vu data point list.

{'instanceName':'{point_type_name} {vector} {text_1_or_2'}

No

text_assign_transliner

Defines the text assignment of the event transmitted to the Vu-Handler.

{'#eventSubtype':'{state_def_text}','#eventCategory':'{text_3} {text_4}', '#eventDetails':'{text_1} {text_2}'}

No

 

Configuring the Text Assignment of the Vu Data Point List

The attributes provided in the Vu data point list can be configured by the text_assign_transliner_vudp attribute of the Vu-Handler. The assignment to the attributes can be configured in the json format. In general, only the name displayed in Siveillance Control is configured.

Connector

Default Value

vualoxerv

{'instanceName':'{point_type_name} {vector} {text_1_or_2'}

  • instanceName: The instanceName attribute defines the data point name which is displayed in Siveillance Control.
  • {point_type_name} {vector} {text_1_or_2}: Defines the string format which is used to create the value of the instanceName attribute. The point_type_name and vector attributes are attributes of the OIS data point. The OIS data point list can be found in the etc directory of the Cu-Handler unit, for example ois_dp-*.*.

The following attributes can be used in the string format:

Attribute Name

Description

text_1

The text 1 of the data point, for example "Deckelkontakt".

For merged data points, the value will always be an empty string "".

text_2

The text 2 of the data point, for example "Verwaltung EG B 03 Büroflächen".

text_3

The text 3 of the data point, for example "Z 101 MEE 1 Kanal 1 AE 3 Port 7" or "Bewegungsmelder 17".

text_4

The text 4 of the data point, for example "Z 101 MEE 1 Kanal 1 AE 3 Port 7" or undefined.

text_1_or_2

The text 1 or text 2 for merged data points, where the text_1 attribute is empty. In case, there is a data point of the Meldebereich type, use text_1 + text_2. The text_1 attribute is defined, if an IC Transliner element of this type has only one data point. The text_2 attributeis the data point name of the Meldebereich type.

vector

The vector of the data point, for example "01/03/003/0005/0286".

point_type_name

The name of the IC Transliner element where the event comes from, for example "AE-NM100/IF160-TR".

 

Configuring the Text Assignment of Events

The attributes provided in the event to the Vu handler can be configured by the text_assign_transliner attribute of the Vu handler. The assignment to the attributes can be configured in the json format. The event texts displayed in Siveillance Control can be configured.

Connector

Default Value

vualoxerv

{'#eventSubtype':'{state_def_text}','#eventCategory':'{text_3} {text_4}', '#eventDetails':'{text_1} {text_2}'}

The attributes available for the event can be viewed in the traces. The following attributes can be used in the string format:

Attribute Name

Description

state_def_text

This is the resulting text defined by the state definition rule in the IC Transliner export file, for example "Einbruch in Ruhe".

text_1

The text 1 of the data point, for example "Deckelkontakt".

For merged data points, the value will always be an empty string "".

text_2

The text 2 of the data point, for example "Verwaltung EG B 03 Büroflächen".

text_3

The text 3 of the data point, for example "Z 101 MEE 1 Kanal 1 AE 3 Port 7" or "Bewegungsmelder 17".

text_4

The text 4 of the data point, for example "Z 101 MEE 1 Kanal 1 AE 3 Port 7" or undefined.

vector

The vector of the data point, for example "01/03/003/0005/0286".

point_type_name

The name of the IC Transliner element where the event comes from, for example "AE-NM100/IF160-TR".