# Serial combinations

## What serial combinations are

A serial combination is the configuration that determines the component sequence used for
new job numbers. The list is the entry point; the detail record is where you review fields,
maintain component rows, and review audit history. Changes apply only to new jobs; old jobs
are not affected.

| If you need to… | Go to |
| --- | --- |
| Locate a combination and open its detail record | [Find and open a serial combination](#find-and-open-a-serial-combination) |
| Read the list columns and empty state | [Understand the list and configuration fields](#understand-the-list-and-configuration-fields) |
| Review product-specific serial options | [Product serial combination fields](#product-serial-combination-fields) |
| Interpret the detail form fields | [Serial combination form fields](#serial-combination-form-fields) |
| Add, change, reorder, delete, and save component rows | [Maintain a serial combination](#maintain-a-serial-combination) |
| Check access, subscription, and close branches | [Handle access branches and failures](#handle-access-branches-and-failures) |
| Match a validation or save message to an action | [When the screen does not behave as expected](#when-the-screen-does-not-behave-as-expected) |
| Review the detail record and audit history | [What to do next](#what-to-do-next) |
| Open the separate product serial-combination options | [Product serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) |
| Return to the configuration starting point | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |

## Before you start

The serial-combination feature controls whether this configuration is available. Edit
permission controls whether you can maintain it.

**Prerequisites**

- Confirm that the serial-combination feature is included in your subscription.
- Have edit permission when you need **Save**, **Component**, the close action, or a delete action.
- Know which serial type you need to review.
- Have access to the audit information when you need the audit area.

The audit area is conditional. When its audit condition is met, **Last Modifications** is
available for the selected combination.

## Find and open a serial combination

Use the list to locate a serial combination, then open its detail record for field work.

**Steps**

1. Open the serial-combination list from the configuration area.

   ![Check the serial-combination list and initial grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/896ba20e4e57f1a89b09ed4aeb460bc5.png)

2. In the grid header, enter a keyword in **Keyword to Search...**.

3. Select the row you want to inspect.

   Selecting a data row opens its detail record unless you select the edit action.

4. To open the selected row directly for editing, select its icon-only edit action.

5. To open a serial type from the detail screen, select its serial-type link.

   | Serial number | Select |
   | --- | --- |
    | Job | **Job No.** |
    | Offer | **Offer No.** |
    | Order | **Order No.** |
    | Invoice | **Invoice No.** |
    | Payment | **Payment No.** |
    | Buyout | **Buyout No.** |
    | MRQ | **MRQ No.** |
    | Package | **Package No.** |
    | Purchase order | **Purchase Order No.** |
    | Received shipment | **Received shipment No.** |
    | Inspected order | **Inspected Order No.** |
    | Shipping order | **Shipping order no.** |
    | Assembly order | **Assembly order no.** |
    | Transfer order | **Transfer order no.** |
    | Service order | **Service order no.** |
    | Issue note | **Issue note no.** |
    | Delivery note | **Delivery note no.** |
    | Cost transaction | **Cost transaction no.** |
   | Outgoing payment | **Outgoing Payment** |

**Result:** The selected serial-combination detail screen is open, or the list is filtered to
the keyword you entered. Continue with the list and field reference below.

## Understand the list and configuration fields

The list is a table for locating combinations. It has no labelled data-entry form; component
maintenance belongs to the selected detail record.

| What you see | What it means |
| --- | --- |
| **Name** | The serial type name. |
| **Serial Combination** | The serial-combination value. |
| `No data` | The list contains no rows for the current view. |

The list displays **Name** and **Serial Combination**. It displays no labelled form controls,
validation groups, dynamic column sets, or mounted new, delete, import, or export actions.

### Product serial combination fields

Product serial combination is the separate configuration for product serial formatting. It is
maintained on the separate [Product serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view)
page, not as fields on this list.

The product page owns **Category code**, **Auto serial**, and **Separator**. On this screen,
use the serial-type links to open the combination for a selected number type.

### Serial combination form fields

The detail form builds the number from ordered rows. Each row uses **Serial Component**,
**Digits**, and **Default Value** according to the selected component.

| Field | Choices or display | When it applies |
| --- | --- | --- |
| **Serial Component** | The component shown for the row. | Choose the component for the row. |
| **Digits** | An available digit count. | Use it when the row requires a digit count. |
| **Default Value** | A text box for the row's default text. | Enter a value when the row requires one. |

The required rules for **Serial Component** and **Digits** are configurable. Treat a field as
required when the screen marks it required for your configuration. **Uploaded file** belongs to
shared import mode; this page has no import launcher.

The field reference leads into the ordered-row procedure below.

## Maintain a serial combination

Maintain the detail record as an ordered sequence of component rows. The sequence determines
how new job numbers are assembled, so an incorrect row or order changes future new job numbers.

**Prerequisites**

- Open the combination for the serial type you need.
- Have edit permission.
- Know the component order and values required for new jobs.

Use this table while adding or changing rows:

| If… | Then… |
| --- | --- |
| You need another row | Select **Component**. |
| **Serial Component** is available | Select the component required for the row. |
| **Digits** is shown | Select an available digit count when the row requires one. |
| The row requires a default | Enter its text in **Default Value**. |
| The sequence is wrong | Drag the rows to their required positions. |
| The row is an empty new row | Use its row deletion action. |
| The row is populated | Open its delete dropdown. |
| The populated-row delete dropdown is open and you want to remove the row | Select **Delete**. |
| The populated-row delete dropdown is open and you want to keep the row | Select **Cancel**. |

The populated-row confirmation message is `Are you sure you want to delete this row?`.

Use exactly one **Auto serial** row, place it last, keep its value numeric, and keep the
complete combination at 12 characters or fewer.

**Steps**

1. Apply the row choice in the table above for each component in the required sequence.
2. Drag the **Auto serial** row to the last position.
3. Confirm that there is one numeric **Auto serial** row and that the combination is no longer
   than 12 characters.
4. Select **Save** to validate and save the combination.

   The defined save messages are `Your combination number saved successfully`,
   `Your Custom Job Number Combination Saved Successfully`, `Saving Failed`, and
   `Saving failed`.

**Result:** The maintained rows are submitted through **Save** when validation passes. Any
change to the combination applies only to new jobs. Continue with the access table if a control
or close action is unavailable.

### Add or edit component rows

Use one row for each part of the number. **Digits** and **Default Value** change with the
selected component, so review each row before saving.

**Prerequisites**

- Open the serial-combination detail record.
- Have edit permission.

Use exactly one **Auto serial** row, place it last, keep its value numeric, and keep the
complete combination at 12 characters or fewer.

**Steps**

1. Select **Component** to add a row.
2. In **Serial Component**, select the component required for the row.
3. In **Digits**, select an available digit count when the field is shown.
4. In **Default Value**, enter the row's default text when the row requires a value.
5. Drag each row to its required position in the sequence.
6. Use the row deletion action to remove an empty new row.
7. Open the delete dropdown for a populated row.
8. Select **Delete** to remove the populated row.
9. Drag the **Auto serial** row to the last position.
10. Select **Save** after confirming that there is one numeric **Auto serial** row and that
    the combination is no longer than 12 characters.

**Result:** The component rows show the required sequence, with one numeric **Auto serial**
row at the end, ready for **Save**.

## Handle access branches and failures

Use the branch that matches what is on your screen before continuing the combination work.

| If… | Then… |
| --- | --- |
| The serial-combination feature is not included | A subscription-upgrade surface appears. |
| Edit permission is allowed | **Save**, **Component**, the close action, delete actions, and the reset action are available according to their screen conditions. |
| Edit permission is not allowed | Edit-dependent maintenance controls are unavailable. |
| Audit information is available for the selected record | **Last Modifications** and log history are available. |
| You changed the combination before closing | The shared exit popup opens. |
| You made no change before closing | The screen closes directly. |
| A new row is empty | Its direct row deletion action is used. |
| A row is populated | Its delete dropdown contains **Cancel** and **Delete**. |

If the reset action is available, select its icon to restore the default combination. The
product messages for this action are `Set to Default Successfully` after success and
`Setting to Default failed` after failure.

The shared log-history **ActionTypes** control is not available on this screen.

## When the screen does not behave as expected

Use the message or surface you see to choose the correction. When the list shows `No data`,
there is no row to open for populated-row editing or reset.

| What you see | What to do |
| --- | --- |
| `Component is required.` | Select a component in **Serial Component**. |
| `Invalid component.` | Select a valid **Serial Component** option. |
| `Quantity is required.` | Select a value in **Digits** when the row requires a character count. |
| `Invalid quantity.` | Select a valid **Digits** value for the selected component. |
| `Please add serial components` | Add a row with **Component**. |
| `Serial type is required` | Select a serial type before saving. |
| `Please select a serial type` | Select one of the serial-type links. |
| `Please Note that you can't add serial combination larger than 12 characters` | Reduce the total combination length to 12 characters or fewer. |
| `Cannot have multiple Auto Serials` or `Cannot have Multiple AutoSerials` | Remove the additional **Auto serial** row. |
| `Must have one Auto Serial` | Add one **Auto serial** row. |
| `Auto Serial must be the last item` | Drag the **Auto serial** row to the last position. |
| `Auto Serial Must Be a Number` | Correct the value used for the **Auto serial** row. |
| `Are you sure you want to delete this row?` | Confirm that the selected row is the one you intend to remove. |
| `Your combination number saved successfully` or `Your Custom Job Number Combination Saved Successfully` | The combination-number save branch completed. |
| `Saving Failed` or `Saving failed` | Correct the combination and select **Save** again. |
| `[object Object]` | Close the alert and return to the screen. |

## What to do next

After locating a row, open its detail record to review or maintain the component sequence.
From the detail record, open **Last Modifications** when the audit condition is available to
review the chronological user actions, including entries such as `Created` and `1 Changes`.

For product-specific serial formatting, continue to [Product serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view),
where **Category code**, **Auto serial**, and **Separator** belong. Return to the
[Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) when you need another configuration area.
