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 | Unit | 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 | none | mandatory |
| 2 | Base path or base item ID | Specifies the source Item ID or the base path for searching within the item tree when multiple items shall be selected. | string | none | mandatory |
| 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 | none | empty |
| 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 | none | 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 | none | R |
| 6 | Description | The description of the virtual item that is created. If left empty, the description of the source item is used. | string | none | 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 | none | 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 | none | 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 | none | 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 | none | empty |
| 11 | In processing type | If incoming data shall be processed, the incoming data type is specified here. | Nothing, JSON, XML | none | 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 | none | empty |
| 13 | Out processing type | If outgoing data shall be processed, the outgoing data type is specified here. | Nothing, JSON, XML | none | 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 | none | 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 | none | empty |