Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

Col#Parameter DescriptionScopeUnitMandatory / default value
1NameThe name of the data point. In combination with the Path, it must be uniqueItem suffixThe 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.stringnonemandatory
2PathThe structure that is used to represent the data point. In combination with the Name, it must be uniqueBase path or base item ID

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

stringnoneempty
3SelectorIf 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.stringnoneemptymandatory
34Data typeThe type of the data pointvirtual item that is createdBOOL, STR, BYTE, CHAR, INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64, FLOAT, DOUBLE, DATE, TIMEnoneSTRR
45Access modeThe access rights of the data point. virtual item that is created.  Allowed values are R (read-only), W (write-only), RW (read and writable).R, W, RWnoneR
56Polling UrlDescriptionThe URL which is used to retrieve the data point value. The server polls by HTTP GET requests to this URL. If empty, polling is not availabledescription of the virtual item that is created. If left empty, the description of the source item is used.stringnoneempty
6Polling intervalThe polling interval in milliseconds.50 – 65535ms5000
7Polling ResourceThe resource that is used for polling. It has to match the name that is used in the HTTP resource definition.Reference to HTTP resource definitionnoneempty
8Polling ParametersA comma-separated list of parameters that are used to replace the placeholders within the polling resource ({0}, {1}, ...).stringmsempty
9Update UrlThe URL which is used to update the data point values. The server issues HTTP PUT, POST or GET requests to this URL. If empty, updating of the values is not possible(source item description is used)
7PersistentThe persistent flag of the virtual item that is created. If left empty, the flag of the source item is used.empty/true/falsenoneempty (source item setting is used)
8SynchronizeThe synchronize flag of the virtual item that is created. If left empty, the flag of the source item is used.empty/true/falsenoneempty (source item setting is used)
9In calculation functionThe 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.stringnoneempty
10Update MethodThe web update request method. POST, PUT, GETnonePOST
11Update ResourceThe resource that is used for updating. It has to match the name that is used in the HTTP resource definition.Reference to HTTP resource definitionnoneempty
12Update ParametersA comma-separated list of parameters that are used to replace the placeholders within the update resource ({0}, {1}, ...)Out calculation functionThe 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.stringnoneempty
1311PersistentIn processing typeIf enabledincoming data shall be processed, the last known incoming data point value is restored after server start up.true/falsetype is specified here. Nothing, JSON, XMLnonefalseNothing
1412Synchronize In processing resourceIf enabled, the value is synchronized with the backup server if used.true/falsenonetrue15Authentication UserUsername for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used.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. stringnoneempty
16Authentication Password

Password for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used.

stringnoneempty
17Additional HTTP HeadersA list of additional HTTP headers which is included in each HTTP request, e.g. for authentication purposes. Additional headers must have the following form: "<key1>: <value1>\r\n<key2>: <value2>\r\n<key3>: <value3>..."13Out processing typeIf outgoing data shall be processed, the outgoing data type is specified here. Nothing, JSON, XMLnoneNothing
14Out processing resourceIf 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.stringnoneempty18Authentication MethodThe authentication method (Basic or Digest) if required by the HTTP server.Basic, Digestnone
Basic15Linked 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.

stringnoneempty