Walkthrough: Item weight integration

Standard Measurements  •  Article  •  6/24/2026  • 

Overview

Use this walkthrough to verify that changes to weight fields on the Item Card page update the correct values and that the Calculate Weights action correctly updates the corresponding Unit of Measure (UOM) lines in all four supported scenarios. The following two setup options control this behavior:

FlagPageValues
Automatic Gross WeightStandard Measurement SetupON / OFF
Sync Weight to Item UOMFoundation Setup (Drink-IT)Net / Gross

These two flags combine into four scenarios:

ScenarioAuto GrossSync WeightExpected result
1aOFFNetNet Weight
1bOFFGrossGross Weight
2aONNetNet + auto-computed Gross + Tare
2bONGrossGross + recalculated Tare

Prerequisites

Before you start any scenario, ensure the following:

  1. Extensions installed: Standard Measurements (MEA), Foundation Management (FND), Drink-IT base.
  2. Test item: An item with at least one base UOM and one alternate UOM configured (e.g., PCS as base, BOX as alternate with conversion factor = 6).
  3. Item card weight values pre-set:
    • Net Weight = e.g., 1.000
    • Gross Weight = e.g., 1.200
    • Tare = Gross - Net = 0.200 (derived, not manually entered)
  4. The flag UpdateItemUOMWithItemChange is FALSE (default in all DIT deployments - no action needed).

Setup Steps

Step 1 - Configure Standard Measurement Setup

  1. Select the Search icon , enter Standard Measurement Setup, and then choose the related link.
  2. In the Automatic Gross Weight field, select OFF (for Scenarios 1a and 1b) or ON (for Scenarios 2a and 2b).
  3. Close the page.

Step 2 - Configure Foundation Setup (Drink-IT)

  1. Select the Search icon , enter Foundation Setup, and then choose the related link.
  2. In the Sync Weight to Item UOM field, select Net (for Scenarios 1a and 2a) or Gross (for Scenarios 1b and 2b).
  3. Close the page.

Scenario 1a - Auto Gross OFF, Sync Weight = Net

Setup: Automatic Gross Weight = OFF | Sync Weight to Item UOM = Net

Part A: Update Net Weight on Item Card

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Net Weight field, enter 1.000, and then press Tab to confirm.
  4. In the Gross Weight field, enter 1.200, and then press Tab to confirm.
  5. Choose the Units of Measure action.

  6. Verify the Net Weight and Gross Weight fields on the base UOM line (e.g., PCS):

  7. Net Weight = 1.000

  8. Gross Weight = 1.200

Part B: Calculate Weights Reads Tare from Item Card

  1. Choose the Units of Measure action.
  2. On the Items Units of Measure page, choose the Calculate Weights action.
  3. Verify the values on the base UOM line (PCS):
FieldExpected ValueDerivation
Net1.000Item card Net Weight
Tare0.200Item card Gross (1.200) - Item card Net (1.000)
Gross1.200Item card Gross Weight

Part C: Calculate Weights Scales Alternate UOM Lines

Prerequisite: Alternate UOM line BOX exists with conversion factor = 6.

Continuing from Part B, verify the values on the alternate UOM line (BOX):

FieldExpected ValueDerivation
Net6.000Base Net (1.000) x 6
Tare1.200Base Tare (0.200) x 6
Gross7.200Base Gross (1.200) x 6

Scenario 1b - Auto Gross OFF, Sync Weight = Gross

Setup: Automatic Gross Weight = OFF | Sync Weight to Item UOM = Gross

Part A: Update Gross Weight on Item Card

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Gross Weight field, enter 1.200, and then press Tab to confirm.
  4. In the Net Weight field, enter 1.000, and then press Tab to confirm.
  5. Choose the Units of Measure action.

  6. Verify the Net Weight and Gross Weight fields on the base UOM line (e.g., PCS):

  7. Net Weight = 1.000

  8. Gross Weight = 1.200

Part B: Calculate Weights - Correct Net, Tare, Gross

  1. Choose the Units of Measure action.
  2. On the Items Units of Measure page, choose the Calculate Weights action.
  3. Verify the values on the base UOM line (PCS):
FieldExpected Value
Gross1.200
Net1.000
Tare0.200
  1. Verify the values on the alternate UOM line (BOX, conversion = 6):
FieldExpected Value
Gross7.200
Net6.000
Tare1.200

Scenario 2a - Auto Gross ON, Sync Weight = Net

Setup: Automatic Gross Weight = ON | Sync Weight to Item UOM = Net

Part A: Update Net Weight on Item Card - Auto Gross Computed

Prerequisite: Item card has an existing Tare Weight, e.g., 0.200 (= stored Gross 1.200 - Net 1.000).

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Net Weight field, enter 1.500, and then press Tab to confirm.
  4. Verify the values on the Item card:
FieldExpected ValueDerivation
Net Weight1.500Entered value
Gross Weight1.700Net (1.500) + Tare (0.200) - auto-computed
Tare0.200Unchanged
  1. Choose the Units of Measure action.

  2. Verify the Net Weight and Gross Weight fields on the base UOM line (e.g., PCS):

  3. Net Weight = 1.500

  4. Gross Weight = 1.700

Part B: Calculate Weights Scales UOM Lines Correctly

  1. Choose the Units of Measure action.
  2. Choose the Calculate Weights action.
  3. Verify the values on the base UOM line (PCS):
FieldExpected Value
Net1.500
Tare0.200
Gross1.700
  1. Verify the values on the alternate UOM line (BOX, factor = 6):
FieldExpected Value
Net9.000
Tare1.200
Gross10.200

Scenario 2b - Auto Gross ON, Sync Weight = Gross

Setup: Automatic Gross Weight = ON | Sync Weight to Item UOM = Gross

Part A: Update Gross Weight on Item Card - Tare Recalculated

Prerequisite: Item card Net Weight = 1.000, Gross Weight = 1.200.

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Gross Weight field, enter 1.300, and then press Tab to confirm.
  4. Verify the values on the Item card:
FieldExpected ValueDerivation
Gross Weight1.300Entered value
Net Weight1.000Unchanged
Tare0.300Gross (1.300) - Net (1.000) - recalculated

  • When the fix is applied, Tare = 0.300 (recalculated). Without the fix, Tare = 0.200 (stale value).

  • Choose the Units of Measure action.

  • Verify the Net Weight and Gross Weight fields on the base UOM line (e.g., PCS):

  • Net Weight = 1.000

  • Gross Weight = 1.300

Part B: Calculate Weights - No Tare = 0 Regression

  1. Choose the Units of Measure action.
  2. Choose the Calculate Weights action.
  3. Verify the values on the base UOM line (PCS):
FieldExpected Value
Gross1.300
Net1.000
Tare0.300
  1. Verify the values on the alternate UOM line (BOX, factor = 6):
FieldExpected ValueDerivation
Net6.0001.000 x 6
Tare1.8000.300 x 6
Gross7.8001.300 x 6
  • When the fix is applied, Tare = 1.800. Without the fix, Tare = 0.000 on alternate lines.

Non-Base UOM Weight Edit - All Scenarios

This behaviour applies in all four scenarios.

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. Choose the Units of Measure action.
  4. On the Items Units of Measure page, locate an alternate UOM line (e.g., BOX - not the base UOM).
  5. In the Weight field, enter any value, and then press Tab to confirm.

  6. Verify the result:

  7. A notification appears (e.g., "Item card update applies to the base UOM only.").

  8. The Net Weight and Gross Weight on the item card are unchanged.
  9. Only the UOM line's local Weight value is stored - no item card writeback occurs.

Summary of Fixes Verified

ScenarioDefect FixedVerification Step
1a / 1bP2 - Calculate Weights reads Tare from item cardScenario 1a Part B, 1b Part B
2aAuto Gross correctly computes Gross on Net Weight updateScenario 2a Part A
2bP3 - Tare recalculated on Gross Weight updateScenario 2b Part A
AllNon-base UOM: no item card writeback, notification shownNon-base UOM section
AllAlternate UOM lines scale Net, Tare, Gross proportionallyPart B in each scenario

Quick Reference: Setup Combinations

ScenarioStandard Measurement SetupFoundation Setup
1aAutomatic Gross Weight = OFFSync Weight to Item UOM = Net
1bAutomatic Gross Weight = OFFSync Weight to Item UOM = Gross
2aAutomatic Gross Weight = ONSync Weight to Item UOM = Net
2bAutomatic Gross Weight = ONSync Weight to Item UOM = Gross

Existing Item Walkthrough

This section covers the same four scenarios using an item that already exists in the system - no pre-set values required. Record the item's current weights first, then use those recorded values as your reference throughout.

Step 1 - Find a Suitable Existing Item

An item is suitable if it meets all of the following:

  • Has at least one base UOM and one alternate UOM (e.g., PCS base + BOX alternate).
  • Has Net Weight and Gross Weight already filled on the item card (both > 0).

  • Is not a production-critical item - weight edits will be made and should be reverted after testing.

  • Select the Search icon , enter Items, and then choose the related link.

  • Filter or browse to an item with UOM lines configured.
  • Select the item to open the item card.
  • Verify that Net Weight > 0 and Gross Weight > 0 on the item card.

Step 2 - Record Baseline Values

Before making any changes, record the item's current values:

FieldRecorded Value
Item No._______________
Base UOM_______________
Alternate UOM_______________
Alternate UOM conversion factor_______________
Item card - Net Weight_______________
Item card - Gross Weight_______________
Item card - Tare (= Gross - Net)_______________

Choose the Units of Measure action and record the current Net Weight and Gross Weight values on each UOM line before making any edits.

These recorded values replace the hardcoded example values (1.000 / 1.200 / 0.200) used in the new-item scenarios above. Substitute your recorded values wherever those appear in the steps below.

Step 3 - Configure Setup Flags

Follow the same Setup Steps defined earlier in the main walkthrough to set the two flags per the scenario you are testing.

Existing Item - Scenario 1a (Auto Gross OFF, Sync = Net)

Setup: Automatic Gross Weight = OFF | Sync Weight to Item UOM = Net

Part A: Update Net Weight on Item Card

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Net Weight field, enter a new value (e.g., your recorded Net Weight + 0.500), and then press Tab to confirm.
  4. Choose the Units of Measure action.
  5. Verify the Net Weight and Gross Weight fields on the base UOM line reflect the updated item card values.

Part B: Calculate Weights Uses Recorded Tare

  1. Choose the Calculate Weights action.
  2. Verify the values on the base UOM line:
FieldExpected Value
Netyour recorded Net Weight
Tareyour recorded Gross Weight - your recorded Net Weight
Grossyour recorded Gross Weight
  1. Verify the values on the alternate UOM line:
FieldExpected Value
Netrecorded Net x conversion factor
Tarerecorded Tare x conversion factor
Grossrecorded Gross x conversion factor

Existing Item - Scenario 1b (Auto Gross OFF, Sync = Gross)

Setup: Automatic Gross Weight = OFF | Sync Weight to Item UOM = Gross

Part A: Update Gross Weight on Item Card

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Gross Weight field, enter a new value (e.g., your recorded Gross Weight + 0.200), and then press Tab to confirm.
  4. Choose the Units of Measure action.
  5. Verify the Net Weight and Gross Weight fields on the base UOM line reflect the updated item card values.

Part B: Calculate Weights - Correct Net, Tare, Gross

  1. Choose the Calculate Weights action.
  2. Verify the values on the base UOM line:
FieldExpected Value
Grossyour recorded Gross Weight
Netyour recorded Net Weight
Tareyour recorded Gross Weight - your recorded Net Weight
  1. Verify the values on the alternate UOM line: all three fields scaled by the conversion factor.

Existing Item - Scenario 2a (Auto Gross ON, Sync = Net)

Setup: Automatic Gross Weight = ON | Sync Weight to Item UOM = Net

Part A: Update Net Weight on Item Card - Auto Gross Computed from Existing Tare

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Net Weight field, enter a new value (e.g., your recorded Net Weight + 0.500). Note this as NewNet, and then press Tab to confirm.
  4. Verify the values on the Item card:
FieldExpected Value
Net WeightNewNet
Gross WeightNewNet + recorded Tare
Tarerecorded Tare (unchanged)
  1. Choose the Units of Measure action.

  2. Verify the Net Weight and Gross Weight fields on the base UOM line:

  3. Net Weight = NewNet

  4. Gross Weight = NewNet + recorded Tare

Part B: Calculate Weights Scales Correctly

  1. Choose the Calculate Weights action.
  2. Verify the values on the alternate UOM line are scaled by the conversion factor using the updated base values.

Existing Item - Scenario 2b (Auto Gross ON, Sync = Gross)

Setup: Automatic Gross Weight = ON | Sync Weight to Item UOM = Gross

Part A: Update Gross Weight on Item Card - Tare Recalculated from Existing Net

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Gross Weight field, enter a new value (e.g., your recorded Gross Weight + 0.100). Note this as NewGross, and then press Tab to confirm.
  4. Verify the values on the Item card:
FieldExpected Value
Gross WeightNewGross
Net Weightrecorded Net Weight (unchanged)
TareNewGross - recorded Net Weight

  • When the fix is applied, Tare is recalculated. Without the fix, Tare remains unchanged from the recorded value.

  • Choose the Units of Measure action.

  • Verify the Net Weight and Gross Weight fields on the base UOM line:

  • Net Weight = recorded Net Weight

  • Gross Weight = NewGross

Part B: Calculate Weights - No Tare = 0 Regression

  1. Choose the Calculate Weights action.
  2. Verify the values on the alternate UOM lines show Tare > 0 and correctly scaled by the conversion factor.

Existing Item - Non-Base UOM Weight Edit

This behaviour applies in all four scenarios.

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. Choose the Units of Measure action.
  4. On the Items Units of Measure page, locate an alternate UOM line (e.g., BOX - not the base UOM).
  5. In the Weight field, enter any value, and then press Tab to confirm.

  6. Verify the result:

  7. A notification appears (e.g., "Item card update applies to the base UOM only.").

  8. The Net Weight and Gross Weight on the item card are unchanged.

Restore After Testing

After completing the scenarios, restore the item to its original state:

  1. Select the Search icon , enter Items, and then choose the related link.
  2. Select the test item to open the item card.
  3. In the Net Weight field, enter your recorded Net Weight value, and then press Tab to confirm.
  4. In the Gross Weight field, enter your recorded Gross Weight value, and then press Tab to confirm.
  5. Choose the Units of Measure action.
  6. Choose the Calculate Weights action to propagate the restored values to all UOM lines.
  7. Choose Back to return to the Item card and verify that Net Weight, Gross Weight, and Tare match your Step 2 baseline.