# Class MappingMgr

- [TopLevel.Object](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md)
  - [dw.util.MappingMgr](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingMgr.md)

Used to manage and interface with mappings loaded into the system via the ImportKeyValueMapping job step. Class can be
used to retrieve values for known keys, iterate over all keys known in a mapping or list all known mappings.

Mappings are read into the system using the ImportKeyValueMapping job step.

Generic mapping capability enables you to map keys to values, with the mapping stored in a high-performance data
store that is independent of the database. This supports large datasets, with high performance for lookup. An example
of using this feature is to map SKUs from a backend system to Commerce Cloud Digital SKUs on-the-fly in Digital script, so
that interaction with the backend system is transparent and does not require adding Digital SKUs to the third
party system.

## Property Summary

| Property                                                                                                                               | Description              |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| [mappingNames](#mappingnames): [Collection](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Collection.md) `(read-only)` | List all known mappings. |

## Constructor Summary

This class does not have a constructor, so you cannot create it directly.

## Method Summary

| Method                                                                                                                                                                                                                                                                                                  | Description                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| static [get](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingMgr.md#getstring-mappingkey)([String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md), [MappingKey](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingKey.md))           | Returns a map containing value(s) associated to the specified key for the specified mapping. |
| static [getFirst](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingMgr.md#getfirststring-mappingkey)([String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md), [MappingKey](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingKey.md)) | Gets the first string value of a mapping by name and key.                                    |
| static [getMappingNames](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingMgr.md#getmappingnames)()                                                                                                                                                                                 | List all known mappings.                                                                     |
| static [keyIterator](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingMgr.md#keyiteratorstring)([String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md))                                                                                                 | Key iterator over known mapping keys by mapping name.                                        |

### Methods inherited from class Object

[assign](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#assignobject-object), [create](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#createobject), [create](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#createobject-object), [defineProperties](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#definepropertiesobject-object), [defineProperty](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#definepropertyobject-object-object), [entries](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#entriesobject), [freeze](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#freezeobject), [fromEntries](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#hasownpropertystring), [is](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isobject-object), [isExtensible](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isextensibleobject), [isFrozen](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isfrozenobject), [isPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isprototypeofobject), [isSealed](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#issealedobject), [keys](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#keysobject), [preventExtensions](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#propertyisenumerablestring), [seal](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#sealobject), [setPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#tolocalestring), [toString](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#tostring), [valueOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#valueof), [values](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#valuesobject)

## Property Details

### mappingNames

- mappingNames: [Collection](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Collection.md) `(read-only)`
  - : List all known mappings.

***

## Method Details

### get(String, MappingKey)

- static get(mappingName: [String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md), key: [MappingKey](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingKey.md)): [Map](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Map.md)
  - : Returns a map containing value(s) associated to the specified key for the specified mapping.

    **Parameters:**

    - mappingName - the mapping name
    - key - the key

    **Throws:**

    - IllegalArgumentException - if mappingName is unknown

***

### getFirst(String, MappingKey)

- static getFirst(mappingName: [String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md), key: [MappingKey](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.MappingKey.md)): [String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md)
  - : Gets the first string value of a mapping by name and key. Ordering is determined by the input CSV file. Throws an
    exception if mappingName does not exist.

    **Parameters:**

    - mappingName - the mapping name
    - key - the key

    **Returns:**

    - the value if a single value. The first value sequentially if a compound value.

    **Throws:**

    - IllegalArgumentException - if mappingName is unknown

***

### getMappingNames()

- static getMappingNames(): [Collection](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Collection.md)
  - : List all known mappings.

    **Returns:**

    - the collection of mapping names

***

### keyIterator(String)

- static keyIterator(mappingName: [String](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.String.md)): [SeekableIterator](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.SeekableIterator.md)
  - : Key iterator over known mapping keys by mapping name. Throws an exception if mappingName does not exist.

    **Parameters:**

    - mappingName - the mapping name

    **Returns:**

    - the seekable iterator

    **Throws:**

    - IllegalArgumentException - if mappingName is unknown

***