Skip to content

Search Materials#

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

search_materials_desktop

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

Administration#

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

The Configuration Entries page contains all the configs related to this feature.