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.
Info |
---|
File location<WorkspaceDirectory>\DataFiles\xio.Logic.Parsing.dat |
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