# Search Materials

!!! info "Available from SMT Template version 3.3.0 onwards"

## Overview

The **Search Materials** page lists all **Materials** available in the system that match a given **Material** name, partial name or ID, filtered by one of the available **Material** queries. By pressing the camera button or scanning a barcode (mobile), users can read a barcode and automatically fill the Search field, displaying the scanned **Material**.

To interact with this page, head to the *Planning and Logistics* menu and click on the *Search Materials* button.

## Available Queries

All queries filter out any of the following **Materials**:

* Template **Materials**.
* Terminated **Materials**.

!!! info
    Although these are referred to as *queries*, they are not actual CM MES query definitions. Instead, they are implemented through a custom service [SearchMaterials](../artifacts/services.md#searchmaterials) which builds and executes search requests using query filters and relations.

The following queries are available:

### SMT Material Default Query

* This is the default query when users open the page.
* This query will not display any **Materials** until the name field is no longer empty.

### SMT Get Materials by Product

* This query will ask for a **Product**, and return all **Materials** associated with that **Product**.

### SMT Get Materials by Material Product

* If the name filter contains the exact name of a valid **Material**, this query returns any **Materials** that share the same **Product** as the given **Material**.

### SMT Get Materials by Area

* This query will ask for an **Area**, and return all **Materials** within that **Area**.

### SMT Get Materials by Resource

* This query will ask for a **Resource**, and return all **Materials** within that **Resource**.

### SMT Get Materials On Hold

* This query returns **Materials** with one or more Hold reasons.

## Actions

Selecting one or more **Materials** will present available actions for the selection. Not all actions support multiple selection, and not all of them are available for all **Materials**. This selection is kept when changing pages within *Search Materials*.

The following **Material** actions are present:

* Refresh  
* Terminate  
* Approve Material  
* Unapprove Material  
* Material Change Group  
* Transfer Sub-Materials  
* Material Combine  
* Material Compose  
* Material Collapse Group  
* Material Split Group  
* Perform Material Process  
* Evaluate Dispatch Rule  
* Material Merge  
* Material Attach Group  
* Material Detach Group  
* Material Release Group  
* Material Hold  
* Material Off-Flow Group  
* Material Record Group  
* Printing Group  
* Floor Life Group  
* Container Group  
* Store Group  
* Reports Group  
* Transaction Group  
* Undo Group  
* Exceptions Group  
* Data Collection Group  
* Documents Group  
* Perform Group  
* Material Logistics Group  
* Layout Group

## Displayed Information

In this page, the following information is displayed for each **Material**:

* Name  
* PrimaryUnits  
* PrimaryQuantity  
* Product  
* Manufacturer  
* Supplier
* ManufacturerPartNumber  
* MoistureSensitivityLevel  
* Facility  
* Table  
* Feeder  
* Division  
* Machine  
* Line  
* Storage  
* Bin/Position (Storage Bin / Storage Position, whichever applicable)
* HoldCount  
* CreatedBy  
* CreatedOn

Users can change the displayed information as well as their order by pressing ![column_options](./images/searchmaterials/column_options.png).

![search_materials_desktop](images/searchmaterials/search_materials_desktop.png)

On mobile, only the following can be seen, in list form:

* Name
* Quantity
* Product
* Storage
* Bin/Position (Storage Bin / Storage Position, whichever applicable)

Pressing an entry will expand and reveal the remaining fields from its the desktop counterpart.

![search_materials_mobile](images/searchmaterials/search_materials_mobile.png)

## Administration

To use this feature, the `SMT.SearchMaterialsView` security feature needs to be enabled to access their respective UI components.

The [Configuration Entries](../artifacts/configurationentries.md) page contains all the configs related to this feature.