Converting UoM Values

Prev Next

A Catalog has multiple nodes and each Node can have multiple SKUs. Similarly, a SKU has multiple attributes and each of these attributes can have multiple UoMs. If you need to convert an existing UoM value to a different UoM value for a single Attribute, you can still go ahead and change it manually. However, in most cases, due to any customer requirements, you might need to make bulk updates to UoM values across 1 or all SKUs in a node which will be tedious.  

For example, you need to change a UoM from inches to cm. If you need to change it manually, you first need to know the conversion formula, that is, cm = 2.54* in. You then need to find out the correct value for the UoM based on the entries which will be very tedious, especially for multiple updates.

Thus, using this feature, you can directly convert UoM values for selected or all SKUs in a node as the formulas are stored in the database.

Let us understand how to convert UoM values.

To convert UoM values:

  1. Select the node containing the SKUs and then click the Convert UoM Values icon. The following options are displayed.

Graphical user interface, application  Description automatically generated

  1. Select a SKU and then click Convert Values to Different UoM For Selected SKUs to convert values for selected SKUs.

OR

Click Convert Values to Different UoM For All SKUs to convert values for all SKUs of the selected node.

 For example, let us consider the first option for selected SKUs.

The following screen appears.

Graphical user interface, application, Teams  Description automatically generated

Figure 153: Convert values to different UoMs for selected SKUs

NOTE

Only those attributes that have been defined in the Schema for the selected SKU having UoM values, that is, common schema attributes are displayed on the left-hand side of the screen. If the attributes are not defined in the schema, they will not be displayed here.

Also, it is possible that a schema attribute defined does not consist of UoM values. However, it will still be displayed in the list as it is defined in the schema. However, if you select those attributes for conversion, a message is displayed as shown below.

Also, if the SKU attribute selected for UoM conversion has been locked as explained in section Locking Attribute Values for a SKU, you cannot change the values of such attributes.

Graphical user interface, application, Teams  Description automatically generated

  1. Select the attribute. For example, let us select Strap Width. The following screen is displayed on the right-side of the screen.

Graphical user interface, text, application  Description automatically generated

Figure 154: Select attribute for value conversion

  1. Enter the Base UoM, that is, the UoM that needs to be converted. Let us say for Strap Width. we need to change the value from mm to cm. So, the Base UoM will be mm.

NOTE

If you select an invalid UoM for conversion such as year to month which does not exist, that is, there is no such conversion, an error is displayed as follows.

A close up of a logo  Description automatically generated


Based on the base UoM selected, the Target UoM will automatically populate a list of UoMs that can be converted based on the UoMs defined in the schema as shown below.

Graphical user interface, application  Description automatically generated

Figure 155: Select base UoM

Let us select cm as the Target UoM. As soon as you select the Target UoM, the following fields are populated as shown below.

Graphical user interface, application  Description automatically generated

Figure 156: Select target UoM

  1. Enter the No. of Decimal Places After Conversion, that is, the number of decimal places needed in the value derived after conversion.

The Conversion Rule that will be applied while converting the UoM value from mm to cm is displayed.

There are a couple of scenarios for UoM conversion. If the target UoM, that is, cm already exists as a UoM for Strap Width, then there could be duplicate UoM values. Hence, while converting, you can choose whether you want to overwrite the existing value / ignore existing value / add new values.

Similarly, you can decide whether you want to keep/delete the base UoM after successful conversion, that is, mm in this case.

The following table describes the various scenarios available while converting UoM values and the resulting values that will be saved based on the combination chosen. As mentioned already, let us consider Base UoM as mm and Target UoM as cm.

Table 16: UoM Conversion Scenario

Scenario

Target UoM

Base UoM

Existing value

Resultant Value

Comments

1

Overwrite

Keep

20 mm

20 mm, 2 cm

No existing value with "cm" is found, so the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is kept.

2

Overwrite

Keep

20 mm, 4 cm

20 mm, 2 cm

All the existing values with "cm" (4 cm) are removed and replaced with the newly converted cm value (2 cm).

The base UoM value (20 mm) is kept.

3

Overwrite

Keep

20 mm, 4 cm, 6 cm

20 mm, 2 cm

All the existing values with "cm" (4 cm, 6 cm) are removed and replaced with the newly converted cm value (2 cm).

The base UoM value (20 mm) is kept.

4

Overwrite

Delete

20 mm

2 cm

No existing value with "cm" is found, so the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is deleted.

5

Overwrite

Delete

20 mm, 4 cm

2 cm

All the existing values with "cm" (4 cm) are removed and replaced with the newly converted cm value (2 cm).

The base UoM value (20 mm) is deleted.

6

Overwrite

Delete

20 mm, 4 cm, 6 cm

2 cm

All the existing values with "cm" (4 cm, 6 cm) are removed and replaced with the newly converted cm value (2 cm).

The base UoM value (20 mm) is deleted.

7

Add new

Keep

20 mm

20 mm, 2 cm

No check is performed to find the existing value with "cm", and the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is kept.

8

Add new

Keep

20 mm, 4 cm

20 mm, 4 cm, 2 cm

No check is performed to find the existing value with "cm", and the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is kept, along with the other "cm" value (4 cm).

9

Add new

Keep

20 mm, 4 cm, 6 cm

20 mm, 4 cm, 6 cm, 2 cm

No check is performed to find the existing value with "cm", and the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is kept, along with the other "cm" values (4 cm, 6 cm).

10

Add new

Delete

20 mm

2 cm

No check is performed to find the existing value with "cm", and the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is deleted.

11

Add new

Delete

20 mm, 4 cm

4 cm, 2 cm

No check is performed to find the existing value with "cm", and the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is deleted, but the other "cm" value (4 cm) is kept.

12

Add new

Delete

20 mm, 4 cm, 6 cm

4 cm, 6 cm, 2 cm

No check is performed to find the existing value with "cm", and the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is deleted, but the other "cm" values (4 cm, 6 cm) are kept.

In case of Ignore existing values:

If any value with target UoM IS NOT found, then normal conversion takes place.

If a value with target UoM IS found, the entire conversion is not carried out; that is, no new values, no deletions, no changes.

13

Ignore

Keep

20 mm

20 mm, 2 cm

No existing value with "cm" is found, so the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is kept.

14

Ignore

Keep

20 mm, 4 cm

20 mm, 4 cm

Since an existing value (4 cm) with "cm" is found, no conversion is done. No changes to anything.

15

Ignore

Keep

20 mm, 4 cm, 6 cm

20 mm, 4 cm, 6 cm

Since an existing value (4 cm, 6 cm) with "cm" is found, no conversion is done. No changes to anything.

16

Ignore

Delete

20 mm

2 cm

No existing value with "cm" is found, so the converted cm value (2 cm) is simply added.

The base UoM value (20 mm) is deleted.

17

Ignore

Delete

20 mm, 4 cm

20 mm, 4 cm

Since an existing value (4 cm) with "cm" is found, no conversion is done. No changes to anything.

18

Ignore

Delete

20 mm, 4 cm, 6 cm

20 mm, 4 cm, 6 cm

Since an existing value (4 cm, 6 cm) with "cm" is found, no conversion is done. No changes to anything.

NOTE

By default, Ignore Existing Values and Keep is selected.

Based on the scenarios mentioned in the above table, select the necessary options.

For example, let us keep the base UoM and overwrite the target UoM. In case of Strap Width, the current value is 20 mm as shown below.

Graphical user interface, application, Word  Description automatically generated

Figure 157: View converted UoM values

  1. Click Overwrite Existing Values and Keep as mentioned in scenario 1 in Table 16: UoM Conversion Scenario.

  2. Click Convert UoM and the UoM is converted successfully and a message is displayed as shown below.

Graphical user interface, text, application  Description automatically generated

Figure 158: UoM conversion success message

You can also view the details in the SKU view as shown below. Hover the mouse on the Show Complete Details link and the details are displayed.

Graphical user interface, application, table  Description automatically generated

Since there was only 1 value 20 mm and no existing value with cm, the converted value 2 cm got added to the existing value and as we chose to keep the base UoM, 20 mm is also retained.

Similarly, you can perform the same operation for all SKUs of a node using the conversion scenarios mentioned, as needed.