Set Material Substrate Map#

Material.SetSubstrateMap

Overview#

This operation is used to associate a Material with a Substrate Map.

Setup#

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

Preconditions#

• The Mapping module must be properly licensed in the system.
• The Material must be Active and Non-Template.
• The Material must not already have a Substrate Map.

Sequence of Steps#

The Set Substrate Map wizard is called from the Details page of the selected Material. Depending on the current system status, the Set Substrate Map button may be visible on the top ribbon or under the More actions button.

Step 1: General Data#

1. Select the Material you need.
2. Under Mapping, select Set Substrate Map to open the wizard.

3. You have the following options to set the Material with:

   • Substrate Map – you must specify an existing Substrate Map.
   • Product Substrate Map Template – if the associated Product Version has a Substrate Map set, it will use the current Material Product template.
   • File – you must specify an existing file, which must be a well-formed E142 file containing a single reference to the current Material as a substrate in the Substrates section of the file.

4. Optionally, Synchronize Quantity – when enabled, the quantity of the Material is synchronized to match the total number of units defined in the selected Substrate Map.

5. Optionally, enter a comment.

6. Select Set to complete the operation.

   

Step 2: Synchronization#

1. Depending on your previous configurations, and if you chose to synchronize the Material with the Substrate Map, the following may apply:

   • If more than one Layout Specifier exists for the provided Substrate in the collection of Substrate Maps of the selected Substrate Map Payload, you must specify which Layout Specifier to use.
   • If for the specified Layout Specifier (or the single Layout Specifier if there is only one), there are more than one possible Overlay Maps, you must specify the Overlay Map to use by providing the Map Name.
   • If the Material has Secondary Units, you must specify which Substrate Map Units to synchronize: the Primary Units or Secondary Units – always by name of the units.
   • The GUI should present the quantity of units that exist in the Map as well as the delta to the Material Quantity matching units to synchronize.

   • Optionally, specify a Loss/Bonus Reason to account for negative/positive delta(s).

     Note

     The Synchronize option must be set according to the GUI Default Element Value with Context= Material.SetSubstrateMap; Element=Synchronize.

2. Optionally, enter a comment.

3. Select Set to complete the operation.