a!map() Function
This function may not be compatible with all features of Appian. For details, see the Feature Compatibility section below.

Function

a!map( key1, keyN )

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.

See also: Appian Data Types

Parameters

Keyword Type Description

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

Usage consideration

Function requirements

  • Keywords must be unique.
  • Keywords are not case sensitive.

Maps vs. dictionaries

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.

Casting a map

  • 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")
}

Feature compatibility

The table below lists this function's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Custom Record Field Expressions Compatible
Open in Github Built: Fri, Aug 12, 2022 (10:01:45 AM)

On This Page

FEEDBACK