Logic parsing definitions

The Logic module can be used to process incoming and outgoing data point values. The calculation and processing functions can be defined within this definition file.

File location

<WorkspaceDirectory>\DataFiles\xio.Logic.Parsing.dat

 

Col#

Parameter 

Description

Scope

Mandatory / default value

Col#

Parameter 

Description

Scope

Mandatory / default value

1

Item suffix

The new item ID used for the virtual item that is created by the module consists of the item ID of the source item + the specified suffix. Original item ID and suffix are separated by a dot. E.g. if suffix is calculated and the source item is NETx\XIO\KNX\IP_Router\01/0/000, the ID of virtual item that is created by the module is NETx\XIO\KNX\IP_Router\01/0/000.calculated.

string

mandatory

2

Base path or base item ID

Specifies the base path for searching within the item tree when multiple items shall be selected.

string

empty

3

Selector

If multiple items shall be selected, the selector specifies the matching pattern for the items below the base path. The selector itself is a regular expression. E.g. if the base path is NETx\VAR\Numeric and the selector is the regular expression .*Item00.*, the items NETx\VAR\Numeric\Item001 toNETx\VAR\Numeric\Item009 are selected.

string

mandatory

4

Data type

The type of the virtual item that is created. 

BOOL, STR, BYTE, CHAR, INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64, FLOAT, DOUBLE, DATE, TIME

R

5

Access mode

The access rights of the virtual item that is created.  Allowed values are R (read-only), W (write-only), RW (read and writable).

R, W, RW

R

6

Description

The description of the virtual item that is created. If left empty, the description of the source item is used.

string

empty (source item description is used)

7

Persistent

The persistent flag of the virtual item that is created. If left empty, the flag of the source item is used.

empty/true/false

empty (source item setting is used)

8

Synchronize

The synchronize flag of the virtual item that is created. If left empty, the flag of the source item is used.

empty/true/false

empty (source item setting is used)

9

In calculation function

The mathematical expression that is used to recalculate incoming data changes. it must contain the placeholder for the value (default value). An example of a valid expression is value * 10 + 5.

string

empty

10

Out calculation function

The mathematical expression that is used to recalculate outgoing data changes. it must contain the placeholder for the value (default value). An example of a valid expression is value * 10 + 5.

string

empty

11

In processing type

If incoming data shall be processed, the incoming data type is specified here. 

Nothing, JSON, XML

Nothing

12

In processing resource

If incoming data shall be processed, the parsing function must be defined here. For JSON, a JPATH expression is required here – for XML an XPATH expression. 

string

empty

13

Out processing type

If outgoing data shall be processed, the outgoing data type is specified here. 

Nothing, JSON, XML

Nothing

14

Out processing resource

If outgoing data shall be processed, the text template must specified here. For JSON, a valid JSON object is required – for XML an XML object. The text template must contain the value tag (default @value@) which is replaced by the current value of the virtual item.

string

empty

15

Linked item(s)

The virtual item(s) that are created by the module can directly be linked to other item(s). Depending on the access rights, this link is uni- or bidirectional. If multiple items are selected, the target item ID must contain regular expression groups for selected the correct target items.

string

empty

The syntax of the calculation function is defined here: https://learn.microsoft.com/en-us/dotnet/fundamentals/runtime-libraries/system-data-datacolumn-expression