Converters

Use converters to transform the source value and then assign the value to the parent node.
TIP: If you intend to use a converter and its properties in several complex dynamic links, create a converter type and then use the converter type instances in multiple complex dynamic links. If you intend to use a converter and its properties in a single complex dynamic link, create a local converter.

This section includes

  • Converter types, converter instances, and local converters for complex dynamic links.
  • Predefined converters, including conditional, engineering unit, expression evaluator, key-value, linear, and string formatter converters.
  • Expression evaluator literals, operators, data types, and functions.
  • Key-value editing, string formatter data types, and SQL query examples.
  • Creating a converter type and understanding converter structure in the complex dynamic link editor.

Converter types and converter instances

Create converter types and then use instances of converter types in multiple complex dynamic links. See Create a converter type and Create a complex dynamic link.

Local converters

A local converter is specific to a singular complex dynamic link that you cannot reuse in other complex dynamic links. See Create a complex dynamic link.

Converter example

An example converter in the complex dynamic link editor may contain:
Complex dynamic link editor with labeled callouts for variable name, dynamic link direction, add converter, converter name, converter properties (raw min, raw max, scaled min, scaled max), and source dynamic link.
Item
Name
Description
1
Parent variable
The variable value, which value is the converter output.
2
Dynamic link direction
The direction between the converter output and the converter logic. The direction changes as you select the icon:
  • Read direction for dynamic link icon
     Read from the source node to the parent.
  • Write direction for dynamic link icon
     Write from the parent to the source node.
  • Read and write direction for dynamic link icon
     Read from the source node to the parent and write from the parent to the source node.
3
Add icon in blue
Insert
Inserts another converter block.
4
Converter name
The name of the converter object.
5
Converter properties
You can set the properties values to:
  • Static values
  • A dynamic link
  • Multiple converters
6
Source dynamic link
Either a dynamic link to a variable or tag value or another converter.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal