---
alias: user-guide-create-substrate-map
tags:
  - mapping
entityname: Substrate Map
description: "This documentation outlines the process for creating a Substrate Map object"
---

# Create Substrate Map

{% include-markdown 'includes/pages/security_features.md' %}

## Overview

This operation is used to create a **Substrate Map**. A template can also be created using a similar procedure and there is also the possibility of using a template to create the new object as well. This selection can be done in the main entity menu.

## Setup

No specific setup is required other than to meet the preconditions of the transaction.  

## Preconditions

* The **Mapping** module must be properly licensed.
* The **Substrate Map** name must be unique.

## Sequence of Steps

### Step 1: General Data

1. Enter the **Name** (must be unique).
2. Enter the **Description**.
3. Enter the `xml` file with the map content:

    ![Screenshot showing a general data entry screen with an XML file input field labeled "create substrate map 01".](images/create_substrate_map_01.png)

    !!! info
        When creating a Substrate Map, the system validates that the uploaded file is compliant with SEMI E142.

4. Select **Next** to optionally select a Bin Converter:

    ![Screenshot showing an optional step for selecting a bin converter, with a filename hint "create substrate map 01a".](images/create_substrate_map_01a.png)

5. Select **Create** to complete the operation.

    ![Screenshot showing a UI with a filename "create substrate map 01b" and a button labeled "Create".](images/create_substrate_map_01b.png)

### Step 2: Bin Converters

1. Optionally, specify a **Default Bin Converter**.
2. Optionally, specify a list of **Overlay Converters**, and define the following for each:

      * Map Name
      * Bin Converter

3. Select **Create** to complete the operation:

![Screenshot showing the "Create Substrate Map" dialog box.](images/create_substrate_map_02.png)

After it is successfully created, the conversion will be automatically applied:

![Screenshot showing a UI with a filename hint "create substrate map 03" and an option labeled "Create".](images/sub_map_bin_con_01.png)

## After Creating a Substrate Map

The **Substrate Map** file can define several entities for each overlay. These entities provide contextual information that is used during import and processing.

The following entities can be associated with each overlay:

* Enterprise
* Facility
* Site
* Step
* Resource

When importing a **Substrate Map**, the system determines the value of each entity based on a predefined resolution logic, which is described in the diagram below.

![Diagram showing the Entity Resolution Logic for Substrate Map Import](diagrams/substrate_map_logic.drawio.svg)

After the **Substrate Map** is imported, all Overlay data is available in the Overlay Information section.

![Screenshot showing a list of overlays and their data](images/overlay_information.png)