Map Application Server data types to InTouch data types
- Last UpdatedJul 17, 2024
- 2 minute read
Application Server includes some attributes and data types that do not map directly to the four primary data types supported by InTouch tags.
The following table shows how the client abstraction layer maps data types for read and write operations. It also shows the data types that the Galaxy dictionary exposes to InTouch.
|
Attribute Property Data Type |
InTouch Data Type |
Notes |
|---|---|---|
|
Float |
Real - 32 bit |
Pass through. |
|
Double |
Real - 32 bit |
If double is IEEE NAN, then convert to float IEEE NAN. If this overflows, set Quality to Bad and pass float IEEE NAN. If the double fractional value is a smaller fraction that the smallest float fraction of 1.17549E-38, treat it as 0.0 float and set Quality to Good. |
|
Boolean |
Discrete |
False = 0, True = 1. |
|
Integer |
Integer - 32 bit |
Pass through. |
|
String (always Unicode) |
Message - MBCS (multi-byte character set encoded) |
Truncate the string if it is too long for InTouch and set the quality to uncertain. Retain both bytes of each Unicode character. |
|
Time |
Message - MBCS |
Format as an appropriate string for the locale. Use MxValue to convert the string. |
|
ElapsedTime |
Real |
Pass as float seconds. MxValue supports coercion to this type. |
|
MxDataType |
Message - MBCS |
Pass the string. |
|
MxSecurityClassification |
Message - MBCS |
Pass the string. |
|
MxQuality |
Message - MBCS |
Pass the string. |
|
MxReference |
Message - MBCS |
Pass the reference string only as Unicode. |
|
MxCategorizedStatus |
Message - MBCS |
Pass the string. |
|
MxQualifiedStruct |
Not supported |
Not supported. |
|
MxQualifiedEnum |
Message - MBCS |
Pass the Enum string. The integer ordinal value can be accessed by applications by referencing #EnumOrdinal. For example, "Pump1.PV.#EnumOrdinal". |
|
Array of Strings |
Message - MBCS (Read-only) |
Put each element of the array into a comma-separated string such as: "String1,String2,String3" up to the maximum limit of an InTouch string value. If this is truncated, the associated quality sent to the InTouch HMI is uncertain. You cannot write to an entire array of strings, but you can write to individual elements of an array. |
|
All arrays |
Integer, Real, Message, or Discrete |
Only supports a subscription to a single element of an array. In this case, the conversions described above are applicable. Otherwise, the return is an empty string with Bad quality. |
|
MxInternationalizedText |
Message |
This is accessed as a string type at run time. |