# Product serial combinations

## Product serial combinations

A product serial combination is the ordered set of components used to form a product serial.
Use this configuration when you need to review or adjust the component order, digit count, or
default value used for new products. The change applies only to new products; existing products
are not affected. The page displays: `Note : Serial combination changes will be applied only on new product, Old products will not be effected.`

| If you need to… | Go to |
|---|---|
| Review the fields and column headings | [Understand the screen](#understand-the-screen) |
| Add or adjust a serial component | [Add and adjust serial components](#add-and-adjust-serial-components) |
| Save the combination or leave the page | [Save or leave changes](#save-or-leave-changes) |
| Find a related serial-combination list | [Serial combinations](doc:configuration-serial-combinations-view) |
| Review serial-status reference data | [Reference serial status](doc:configuration-reference-list-reference-serial-status-view) |
| Work with products affected by this setting | Products |

## Before you start

The screen shows the main configuration surface when your subscription includes the feature.
Editing controls are available when you have edit access, and the subscription-upgrade surface
appears when the feature is not included.

**Prerequisites**

- Your subscription includes the feature, so the main configuration surface is available.
- You have edit access when you need to add, change, or save a combination.
- The page is not currently saving when you select **Save**.
- The serial-component list is available when you select **Component**.
- If the subscription-upgrade surface is shown outside a popup, **Back** is available.

The normal **Save** action requires the feature, edit access, and a page that is not saving. The
**Component** action also requires the serial-component list. The subscription-upgrade surface
uses **Back** when it is not inside a popup.

## Find the configuration screen

Open the configuration screen to review or change the combination.

**Prerequisites**

- You know that you need the product serial combination configuration.

**Steps**

1. Open **Product serial combination** from the configuration menu.

![The Product serial combination screen with its grid headers and action buttons.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0c81ac29dec1c2c2a0dc6b3970ba0ae1.png)

**Result:** The Product serial combination screen opens.

## Understand the screen

The screen uses a grid to show the ordered parts of a product serial combination. The visible
headers are **Serial Component**, **Digits**, and **Default Value**. A narrow position marker
shows each row's place, and a row-action area has no visible delete control.

| Area | What you use it for | When it appears |
|---|---|---|
| **Serial Component** | Choose an entry from the available serial-component list for a row. | When the serial-component list is available. |
| **Digits** | Choose the number of digits for the row. | After you select a component that supports a digit count. |
| **Default Value** | Enter a text value. | After you select a component that uses a text value. |
| **Default Value** | Choose a separator value. | After you select a component that uses a separator. |
| Row position | See where the row appears in the combination. | In the first narrow column. |

After you select a component, the row shows the editors that apply to it. **Digits** is required
when the row has no existing digit count; otherwise it is optional. **Default Value** is required
when it appears as a separator selector and optional when it appears as a text editor.

The grid supports single-row selection, row editing, and no sorting. The visible screen has the
three headers above, and the action buttons **Save** and **Component**.

![The Serial Component column and its row editor.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e8db9011e06f3a16d8c8accd4dee2508.png)

![The Digits column and its row editor.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/55cdb0c22bd90f748615f622c8d13ca8.png)

![The Default Value column and its value editor.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e8db9011e06f3a16d8c8accd4dee2508.png)

## Add and adjust serial components

Use the component rows to build the ordered serial combination. Changing a row updates the serial
preview represented by the grid, while row order determines the order of the combination.

**Prerequisites**

- The main configuration surface is available.
- You have edit access and the serial-component list is available.

**Steps**

1. Select **Component** to append a blank combination row.
2. In **Serial Component**, choose an entry from the available serial-component list.

   After you select an entry, the row can show a **Digits** editor, a text **Default Value**
   editor, or a **Default Value** separator selector. **Digits** is required when the row has no
   existing digit count; otherwise it is optional. The separator selector is required; the text
   editor is optional.
3. In **Digits**, choose the number of digits when that editor appears.
4. Use the alternatives in the table below to complete **Digits** or **Default Value**.
5. Drag a row to a new position when the component order needs to change.

The editors change with the selected component:

| If the selected component shows… | Complete **Digits** | Complete **Default Value** |
|---|---|---|
| A digit-count editor | Choose the available digit count. | — |
| A text editor | — | Enter the text value. |
| A separator selector | — | Choose the separator value. |

**Result:** The grid contains the component rows in the order you set, with each row showing its
component, digit setting, and default value.

## Save or leave changes

Save commits the configured combination through the screen's save action. Closing the page uses a
different close path depending on whether the page is in edit mode.

**Prerequisites**

- You have completed the row changes you want to keep.
- The feature is included and you have edit access to use **Save**.

**Steps**

1. Choose the action that matches your goal.

   | If you want to… | Select or do |
   |---|---|
   | Save the current combination and remain on the page | **Save** |
   | Leave while you are editing | The close control in the top action bar |
   | Leave when you are not editing | The close control in the top action bar |

2. If you selected the close control in the top action bar while editing, choose one exit-confirmation option.

   | If you want to… | Select |
   |---|---|
   | Keep the changes before leaving | **Save** |
   | Leave without keeping the changes | **Don't Save** |

![The Save action on the configuration screen.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4976afdebcc183a42f61947fa2e9e5c8.png)

**Result:** The combination is saved, and a successful save displays
`Your combination number saved successfully`. A failed save displays `Saving Failed In product serial`.

## Handle unavailable and conditional surfaces

The page changes between the main configuration surface and the subscription-upgrade surface
according to feature availability. The audit-log area is not part of the page's available path.

| If you see… | Use or expect… |
|---|---|
| The feature is not included | The subscription-upgrade surface and **Back** when it is outside a popup. |
| The feature is included but you do not have edit access | The page uses the non-edit close path instead of the edit close action. |
| The audit-log area is absent | Continue with the product serial combination grid. |
| You look for a column chooser | Work with the visible grid headers; the column chooser is disabled. |
| You look for row deletion | Use row changes and ordering instead; no delete control is available on this screen. |

The page does not show **Last Modifications**. Continue with the product serial combination grid.

## When validation or saving goes wrong

Use the exact message text to identify the correction. The page validates the selected component,
digit count, and separator value before saving.

| Message | What to correct |
|---|---|
| `Component is required.` | Choose a component in **Serial Component**. |
| `Invalid component.` | Choose a valid component in **Serial Component**. |
| `Quantity is required.` | Choose a digit count in **Digits**. |
| `Invalid quantity.` | Choose a valid digit count in **Digits**. |
| `this is required.` | Choose the required separator value in **Default Value**. |
| `Auto Serial must be the last item In product serial` | Move the Auto Serial row to the end of the combination. |
| `Please add serial components In product serial` | Add a row with **Component**. |
| `Serial type is required In product serial` | Select the required serial type. |
| `Please Note that you can't add serial combination larger than 12 characters In product serial` | Reduce the combination to 12 characters or fewer. |
| `Please select a serial type In product serial` | Select a serial type. |
| `Cannot have multiple Auto Serials In product serial` | Keep one Auto Serial in the combination. |
| `Must have one Auto Serial In product serial` | Add one Auto Serial to the combination. |
| `Cannot have Multiple AutoSerials` | Remove the additional Auto Serial. |
| `Please Note that you can't add serial combination larger than 12 characters` | Reduce the combination to 12 characters or fewer. |
| `Auto Serial Must Be a Number` | Enter a number for the Auto Serial value. |
| `Saving Failed In product serial` | Review the combination and select **Save** again. |

The successful save message is `Your combination number saved successfully`.

## What happens next

After you review or change the combination, the setting remains a configuration for new products.
Use the related serial-combination and serial-status pages when your next task concerns those
lists rather than this product-combination screen.