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 |
---|---|---|---|---|
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