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:
The map name.
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: