Item Creation

Use this widget to create an item using a hierarchy-based template item from your homepage or workspace.

This widget receives information from hierarchy-based template items and prerequisite data must be defined first before using the widget. Perform the prerequisite tasks based on the required data definition as follows:
  1. Define the hierarchy ID with appropriate levels, such as Lvl1, Lvl2, Lvl3 etc., in 'Item Hierarchy: Open' (MMS021).
  2. Specify a template item in 'Item. Open' (MMS001) that should be similar with the code of the hierarchy ID provided in (MMS021). Take note that if a template item is defined at Lvl1, the widget will load only the Lv1 information even though further levels are available in the hierarchy master. We recommend that you always define the template item in (MMS001) similar to the hierarchy ID defined for the lowest hierarchy level.

    For example, if H1 is Lvl1 as hierarchy code in the (MMS021) program, then this ID should also be mapped to lower levels like H1H2 as Level 2, and H1H2H3 as Level 3. If the template item exist for H1 being Lvl1 hierarchy ID, H1H2 or H1H2H3 will not be loaded in the widget. In this case, you can define the template item in (MMS001) at the lowest level in the hierarchy, that is, H1H2H3 being the level 3 in the hierarchy ID defined in (MMS021).

Prerequisite

Before using the widget, you must activate these tables in the M3 Function Search administration:
  • MITHRY
  • MITMAS

See information about updating table indexes in the M3 Core User and Administration Library (Cloud).

Using the Item Creation widget

  1. On the Item Creation widget, click New Item.
  2. Specify this information:
    Hierarchy 1
    Select a level 1 hierarchy ID from the options defined in (MMS021).
    Hierarchy 2
    Select a level 2 hierarchy ID from the options defined in (MMS021) that is mapped under Hierarchy 1.
    Hierarchy 3
    Select a level 3 hierarchy ID from the options defined in (MMS021) that is mapped under Hierarchy 2.
    Hierarchy 4
    Select a level 4 hierarchy ID from the options defined in (MMS021) that is mapped under Hierarchy 3.
    Hierarchy 5
    Select a level 5 hierarchy ID from the options defined in (MMS021) that is mapped under Hierarchy 4.
    Item number
    Specify a unique ID to assign to the item.
    Item Image Upload (optional)
    Browse to the image and upload an image that you can associate with the item.
    Item name
    Specify a name for the item.
    Description
    Specify a description for the item.
    Unit of measure
    Select the applicable unit of measure for the item.
    Supplier
    Specify a keyword to help return search results for available suppliers.
    Sales price
    Specify the sales price for the item.
    Note: The currency for the price is automatically populated from the hierarchy-based template item.
    Purchase price
    Specify the purchase price for the item.
    Note: The currency for the price is automatically populated from the hierarchy-based template item.
    Alt U/M 1
    Select the alternative unit of measure for the item.
    Note: You can only use this field if the Alt U/M in use setting is set to 2-Item U/M for the item in 'Item. Open' (MMS001/E).
    Alt U/M type 1
    Select the type of your alternative unit of measure. When you select a value, this field triggers the 2nd set of alternative measurements for the item.
    Conversion form 1
    Select the operation to apply for the conversion value of the item.
    Dec places 1
    Select the decimal place where to apply the operation.
    Conversion factor 1
    Select the extent of conversion to be made for the conversion value.
  3. Click Save. If you save the item successfully, a message is displayed on the widget containing a link to the M3 program where the item is recorded.
    Note: Items that are created from this widget can be accessed through 'Item. Open' (MMS001).

APIs used in the widget

The Item Creation widget requires application program interfaces (APIs) that retrieve and display the appropriate data.

This table shows details about M3 APIs available in this widget:
Program Transaction
CMS100MI Lst_WD_ItemHier
MDBREADMI LstMITMAS00M3C1
MMS200MI CpyItmBasic
MMS200MI UpdItmPrice
MMS200MI LstItmWhsByItm
MMS200MI CpyItmWhs
CRS620MI SearchSupplier
CRS050MI List
MMS015MI Add
CRS040MI LstItmTypes

See information about testing and running an API and its corresponding transaction in the M3 Core User and Administration Library (Cloud).