---
title: "MES Material Manager | Perspective"
id: "mes-material-manager-perspective"
project: "MES User Manual"
url: "https://docs.sepasoft.com/articles/user-manual/mes-material-manager-perspective"
updated: 2026-07-31T14:53:52Z
---

# MES Material Manager \| Perspective

**Sepasoft MES Module Suite**
 ## MES Material Manager

Use Material Manager to add materials to an MES system.  There can only be one Material Root to an Ignition Gateway.

You can add, edit, delete, copy, paste, import and export Material Definitions and Material Classes in Material Manager.

![](/resources/Storage/user-manual/mes-material-manager-perspective/image2022-12-14_14-8-51.png)

 * * *
 ## Importing and Exporting Materials in XML Format

Import or export materials at the **Material Class** level. Use the icons in the toolbar.

![](/resources/Storage/user-manual/mes-material-manager-perspective/image2022-12-14_14-29-58.png)

Material List Export

Code

```
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<MaterialRoot>
  <MaterialClass>
    <Name>Chocolate</Name>
    <MaterialDef>
      <Name>Chocolate 77</Name>
    </MaterialDef>
    <MaterialDef>
      <Name>White Chocolate</Name>
    </MaterialDef>
  </MaterialClass>
</MaterialRoot>
```

 * * *
 ## Material Manager User Interface

| Icon | Name | Functionality |
| --- | --- | --- |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-31-15.png) | **Add** | Adds a new Material Class or Material Definition. Clicking this icon while a Material Class is selected brings up the options of adding either a new Material Class or a new Material Definition.<br><br>![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Icons%20-%20Add.PNG) |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-31-41.png) | **Edit** | Edits the selected material. |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-32-14.png) | **Delete** | Deletes the selected material. |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-32-34.png) | **Copy** | Copies the selected material. |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-33-4.png) | **Paste** | Paste in place under the selected Material Class the copied Material Class or Material Definition. |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-33-23.png) | **Import** | Import a Material Class (and all of the child elements under it when exported) from a file on the server. |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-33-53.png) | **Export** | Export the selected Material Class (and all of the child elements under it) to an .xml file stored to a location on the server. |
| ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-36-10.png) | **Toggle Column Visibility** | Individually select the visibility of the **Name** and **Description** columns in the hierarchy tree under Material Root.<br><br><br>
<br><br>| ![Information](/resources/Storage/user-manual/user-manual/Info.png) | A column with its visibility toggled  ***off*** is not removed. Its text is merely hidden. Therefore, if the **Description** column is toggled to  ***off*** , users still need to slide the column boundary between the **Name** and **Description** columns over to the right manually to make more room for the text in the **Names** column. |<br>| --- | --- |<br><br><br>![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Icons%20-%20Col%20Vis.PNG) |

There is also a **Search** field for users to filter and find Material Classes and Material Definitions from their long lists. Search wildcards, such as asterisks ("\*"), are allowed.

![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_10-38-4.png)
 * * *
 ## Adding a New Material Class

Material Classes can be added either to an existing Material Class or to the Material Root.

1. Select either an existing Material Class where the new Material Class is to be created as a child, or the Material Root.
2. Click **Add** and select **Create Material Class** from the drop-down menu. The following editor appears:
 ![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Icons%20-%20Add%20Material%20Class.PNG)
3. Type in the new Material Definition name (in the example above, the  **Name**  is set to   ***Yeast***  ).
4. Add a Description (optional).
5. Click ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_19-1-47.png)to save the new Material Class.

## Adding a New Material Definition

1. Select the existing Material Class where the new Material Definition is to be created (as a child to it).
2. Click **Add** and select **Create Material Definition** from the drop-down menu. The following editor appears:
 ![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Icons%20-%20Add%20Dialog%20Box.PNG)
3. Type in the new Material Definition name (in the example above, the  **Name**  is set to   ***Bread Flour***  ).
4. Add a Description (optional).
5. Click  ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_19-1-47.png)to save the new Material Definition  .
6. In the **Settings** section, click **Production**.
![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Material%20Configuration%202_1x.png)
7. The settings appear as shown to right. Complete the configuration.
8. Click ![](/resources/Storage/user-manual/mes-material-manager-perspective/image2020-9-9_19-1-47.png)to save the settings.

### Characters Not Allowed in Names

These characters are reserved by the Sepasoft modules.

**Production Equipment**

. ? ! # % ^ \* ~ [ ] { } + = ` \ @ & ( ) &lt; &gt;,

**MES Person**

. ? ! # % ^ \* ~ [ ] { } + = ` \/ " $ | &lt; &gt;

**Other MES Objects**

. ? ! # % ^ \* ~ [ ] { } + = ` \/ " $ | ,

**Machine Recipe Name in Settings & Changeover Module**

Follows the same convention as **Other MES Objects**

****Full-stop period . is allowed as of **3.81.10 SP2**

**Batch Names in Batch Procedure Module**

. ? ! # % ^ \* ~ [ ] { } + = ` \/ " $ | ,

![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Material%20Configuration.PNG)
 * * *
 ## Component Properties

Properties are provided that can be set to affect the operation and look of the component. They can be set through the **Perspective Property Editor** in the **Designer** or through scripting. Note that the section prefix is included before the property name (props, position, custom or meta).
 PROPS
### Component Properties

![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20PROPS%201.PNG)

| Name | Scripting | Property Type | Description |
| --- | --- | --- | --- |
| Search Enabled | searchEnabled | Boolean | Allows for searching text within columns from the toolbar. |

* * *

There are also numerous styling properties available:

Version Specific

| ![Warning](/resources/Storage/user-manual/user-manual/Warning.png) | Improvements made in:<br><br>**3.81.8 SP4**<br><br>Improvements made for customizing these styling properties: checkboxStyle, dialogButtonUserStyle, dialogDividerStyle, and dialogTitleStyle. |
| --- | --- |

![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20PROPS%202.PNG)

Each property above can be edited for text, background, margins and padding, border, shape, as well as opacity, cursor and overflow characteristics:

![](/resources/Storage/user-manual/mes-material-manager-perspective/Edit%20PROPS%20-%20styles.PNG)

Ignition Style Editor

| ![Information](/resources/Storage/user-manual/user-manual/Info.png) | Refer to the **Ignition 8** docs page [Style Reference](https://docs.inductiveautomation.com/display/DOC81/Style-Reference) for information on modifying the properties listed below. |
| --- | --- |

POSITION
### Position Properties

The component position properties aren't usually changed by users during runtime, but they can be written and read in the same manner as other properties, if ever needed. Refer to [Ignition Perspective Component Properties](https://docs.inductiveautomation.com/display/DOC81/Perspective-Component-Properties) for details on POSITION properties.

New user-defined position properties can be created in this section.

User-defined Properties

| ![Information](/resources/Storage/user-manual/user-manual/Info.png) | Best practice: If user-defined properties are required, create them in the CUSTOM section instead of here. |
| --- | --- |

![](/resources/Storage/user-manual/mes-material-manager-perspective/POSITION%20-%20table.PNG)

CUSTOM
### Custom Properties

New user-defined custom properties can be created in this section.

![](/resources/Storage/user-manual/mes-material-manager-perspective/CUSTOM.PNG)

META
### Meta Properties

This section contains the name and visibility properties for the component.

New user-defined meta properties can be created in this section.

User-defined Properties

| ![Information](/resources/Storage/user-manual/user-manual/Info.png) | Best practice: If user-defined properties are required, create them in the CUSTOM section instead of here. |
| --- | --- |

![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20META.PNG)
 * * *
 ## Event Handlers

Event handlers provide the ability to add custom script when a user interacts with a component.

Refer to the [Ignition 8.1 User Manual](https://docs.inductiveautomation.com/display/DOC81/Welcome) for details on using the available event handlers:

* [Ignition: Component Events and Actions](https://docs.inductiveautomation.com/display/DOC80/Component-Events-and-Actions)
* [Ignition: Perspective Event Types Reference](https://docs.inductiveautomation.com/display/DOC80/Perspective-Event-Types-Reference)

![](/resources/Storage/user-manual/mes-material-manager-perspective/OEE%20Material%20Manager%20-%20Event%20Handlers.PNG)
 * * *
 ## Component Functions

This component has no Component Functions.

**Sepasoft MES Module Suite**