Function

internalize( externalizedText, default )

Converts the given externalized string representation of a value to the original value.

See also: externalize()

Parameters

Returns

Text

Usage considerations

This function cannot be used with record data. If you use a!toJson() to create a text representation of record data, that JSON can then be cast to a record data type with a!fromJson().

This example shows how to cast a JSON string to the Address record type. When casting JSON data to a record type, Appian automatically matches the keys to the record type's fields. Any non-matching key names are ignored.

1
2
3
4
5
6
7
cast(
  recordType!Address,
  a!fromJson(
      "{""addressId"":301,""addressLine"":""7950 Jones Branch Dr"",
      ""city"":""McLean"",""stateProvinceId"":75,""postalCode"":""22102""}"
  )
)

Examples

Deserialize text

1
internalize("000000010000003000000000000000030000000448656C6C6F20576F726C6421000000000000000000000001000000030000000100000002")

Returns Hello World!.

Deserialize a map

1
internalize("000000010000009000000000000000030000000000000004FFFFFFFC000000026B657931006B657932000000000000000000000600000000000000000000000200000000000000020000000476616C756531000000000000000000010000000300000000000000020000000476616C7565320000000000000000000100000003000000060000000000000001000000FC0000000100000002")

Returns a!map(key1: "value1", key2: "value2").

Deserialize a value of type User

internalize(externalize(pv!user)) returns user3 when pv!user is User Mike Smith whose username is user3.

Feature compatibility