a!map() Function

Creates a map of values (Any Type) with each value stored at the corresponding string key. Values stored in maps are not wrapped in variants.

Syntax

a!map( key1: value1, … , keyN: valueN )

key1: (Any Type) A key value pair to store in the map. The value is not wrapped in a variant.

keyN: (Any Type) Any additional key value pairs, as needed.

Returns

Map

Notes

While similar to a dictionary, which uses curly braces {}, the values stored in a map are not wrapped in variants. This makes it much easier to get values back out of maps by indexing, without having to worry about type casting. There are no advantages to using dictionaries; prefer using maps over dictionaries where possible. See Appian Data Types.

Keywords must be unique.

Keywords are not case sensitive.

Casting:

  • A map can be cast to a dictionary, CDT, record, or text.
  • A dictionary, CDT, or record can be cast to a map.

Examples

Single map:

1
a!map(id: 1, name: "Jane Doe")

List of maps:

1
2
3
4
{
   a!map(id: 1, name: "Jane Doe"),
   a!map(id: 2, name: "John Doe")
}
Open in Github Built: Thu, Feb 23, 2023 (02:59:22 PM)

On This Page

FEEDBACK