Conversion Maps

You can use this integration to create maps comprised of key-value pairs in the form of name:alias. The maps work with the convertField Workflow Engine function to look up the "name" and update the value of a field with the "alias".

The conversion map configuration follows a similar pattern as the configuration for LAM Mapping,

Before You Begin

Before you start to set up your integration, ensure you know the following about your conversion map:

  1. The map name.

  2. The keys and values you want create mappings for.

Configure the Conversion Map Integration

You can use this integration to configure multiple conversion maps. To complete the configuration, you must provide a unique integration name and have at least one conversion map that contains at least one mapping.

Integration Name

Name of the conversion map integration instance.

Type

String

Required

Yes

Default

MyMap

Conversion Name

Specifies the name of your conversion map.

Type

String

Required

No

Default

conversionName

Enable this Conversion

Enable the conversion for use in mapping.

Type

Boolean

Required

Yes

Default

Unchecked

Match Names with Case Sensitivity

Set the match type to case sensitive. Defaults to case insensitive.

Type

Boolean

Required

Yes

Default

Unchecked

Either Retain the Original Value, Set a Default, or Exclude

Specifies the behavior to perform if there is no match.

Type

One of

retain: leave the original value unchanged

default: return the default value

exclude: actions using this map fail

Required

Yes

Default

retain

Name

Specifies the keys you wish to lookup.

Type

String

Required

Yes

Default

<item name>

Alias

Specifies the values you wish to return.

Type

String

Required

Yes

Default

<item alias>

Use a Conversion Map in a Workflow

You can use the conversion maps you configure in your workflows. For example, you can use the convertField function to lookup and update a field in an alert or Situation. Remember to use the map name you specified the configuration for the map name in the Workflow Engine Action.

Learn more

Watch the following video to learn more about Conversion Maps: