# 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 ofretain: leave the original value unchangeddefault: return the default valueexclude: actions using this map fail Required Yes Default retain

### Name

Specifies the keys you wish to lookup.

 Type String Required Yes Default

### Alias

Specifies the values you wish to return.

 Type String Required Yes Default

## 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.