# Serial combination details

## Serial combination details

A serial combination is the ordered component configuration that PAMS uses to
build a serial number. This page maintains the combinations for the loaded
serial types, including job, offer, order, invoice, payment, buyout, MRQ,
package, purchase order, received shipment, inspected order, shipping order,
assembly order, transfer order, service order, issue note, delivery note, cost
transaction, and outgoing payment numbers. Changes apply only to new jobs; old
jobs are not affected.

| If you need to… | Go to |
| --- | --- |
| Open a combination and choose the serial type to inspect | [Find a serial combination](#find-a-serial-combination) |
| Identify the component-list columns and available actions | [Understand the combination screen](#understand-the-combination-screen) |
| Add, reorder, edit, delete, or save component rows | [Maintain a serial combination](#maintain-a-serial-combination) |
| Check why a control or tab is different | [Handle access and screen variations](#handle-access-and-screen-variations) |
| Correct a validation, deletion, or save result | [When saving or deleting goes wrong](#when-saving-or-deleting-goes-wrong) |
| Review audit history after maintenance | [After maintaining a combination](#after-maintaining-a-combination) |
| Locate a combination before opening its details | Serial combinations list |
| Review the separate product serial combination options | Product serial combinations |

## Before you start

The serial-combination feature controls whether this page is available. Permission to
edit serial combinations controls whether its maintenance actions are available.

**Prerequisites**

- Confirm that the serial-combination feature is included in your subscription.
- Have permission to edit serial combinations when you need **Save**, **Component**,
  the close action, or a delete action.
- Know which serial type you need to review. The route parameter selects that serial
  type.
- If you need audit history, confirm that it is enabled for your account and company
  branch.

## Find a serial combination

Open the details page from the serial-combinations list, choose a serial type, and then
continue to [Understand the combination screen](#understand-the-combination-screen).

**Prerequisites**

- Know the serial type you want to inspect.

**Steps**

1. Open **Configuration**.
2. Select **Serial Combinations**.
3. Select the link for the serial number you need to maintain.

   | Serial number you need to maintain | 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** |

4. Review the combination for the selected type.

**Result:** The details page opens for the selected serial type, with its component
list and maintenance actions visible.

## Understand the combination screen

The component list shows the ordered rows that make up the selected serial combination.
Each row can contain a serial component, a digit count where applicable, and a default
value where needed.

| What you need to identify | What appears on the screen |
| --- | --- |
| Component selected for a row | **Serial Component** |
| Character count for a row | **Digits** |
| Fixed text or another row value | **Default Value** |
| Number of rows reported | `Count: 4` |
| Add a component row | **Component** |
| Save the combination | **Save** |
| Refresh the displayed data | **Refresh** |

> **Note:** Serial combination changes apply only to new jobs; old jobs are not affected.

The **Last Modifications** tab opens the audit area when the audit condition is met. The
audit area provides a chronological sequence of actions performed by users and includes
dated entries such as `Created` and `1 Changes`.

![Identify the component list, its columns, row count, and actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3b623cb6d5ba41ecc4b78b52bd409453.png)

Continue with [Maintain a serial combination](#maintain-a-serial-combination) when you
are ready to change the rows.

## Maintain a serial combination

Treat the rows as an ordered recipe: each row contributes a component, a digit count
where applicable, and a default value where needed. **Save** checks the combination
before saving it.

**Prerequisites**

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

**Steps**

1. Select **Component** to add a serial-combination row.
2. In **Serial Component**, select the component that matches the row's purpose.

   | Component purpose | Select |
   | --- | --- |
   | Year component | **Year** |
    | Automatically generated serial portion | **auto serial** |
    | Fixed text portion | **text** |

3. Complete the row's available values.

   | If the row needs… | Do this |
   | --- | --- |
     | A digit count | In **Digits**, select an available choice for the selected component. Components that do not use a digit count do not offer this choice. |
     | A default value | In **Default Value**, enter the row's default text. A text box is provided for non-**text** components and another is provided for the **text** component. |

4. Drag and drop the rows into the order required for the serial number.
5. Remove an empty new row with its row deletion action.
6. Open the delete dropdown for a populated row.

   | If you need to… | Select |
   | --- | --- |
   | Close the dropdown without deleting the row | **Cancel** |
   | Remove the populated row | **Delete** |

7. Select **Save** to check and submit the combination.

**Result:** The rows are arranged and edited on the combination screen, and **Save**
checks and submits the combination.

If a control or tab differs, continue with [Handle access and screen
variations](#handle-access-and-screen-variations).

## Handle access and screen variations

Use the condition that matches your screen to choose the available path.

| Condition | Screen or exit path |
| --- | --- |
| The serial-combination feature is not included | A subscription-upgrade surface appears. |
| Edit permission is allowed | **Save**, the close action, the delete affordance, and **Component** are available according to their screen conditions. |
| Edit permission is not allowed | The edit-dependent controls are not available for maintenance. |
| A different serial type is selected | The selected type's status and combinations appear. |
| Audit history is enabled for your account and company branch | **Last Modifications** and log history are available. |
| A change has been made before closing | The shared exit popup opens. |
| No change has been made before closing | The screen closes directly. |

The separate Product serial combination page contains `category code`, `auto serial`,
and `separator`. Those options do not belong to this page. The log-history filter is not
available here.
If saving or deleting produces a message, use [When saving or deleting goes wrong](#when-saving-or-deleting-goes-wrong) to identify the result and correct the problem.

## When saving or deleting goes wrong

Use the displayed text to identify whether the problem concerns a row, the combination,
or the action.

| What you see | What to check or do |
| --- | --- |
| `Component is required.` | Select a component in **Serial Component** for the row. |
| `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 at least one row with **Component**. |
| `Serial type is required` | Select a serial type before saving. |
| `Please Note that you can't add serial combination larger than 12 characters` | Reduce the total combination length to 12 characters or fewer. |
| `Please select a serial type` | Select one of the available serial-type links. |
| `Cannot have multiple Auto Serials` or `Cannot have Multiple AutoSerials` | Keep only one **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 to remove before completing the delete action. |
| `Your combination number saved successfully` | The combination number is saved. |
| `Your Custom Job Number Combination Saved Successfully` | The custom job-number combination is saved. |
| `Saving Failed` or `Saving failed` | Review the combination and select **Save** again when the data is corrected. |

The displayed confirmation and outcome text identifies what happened after the
corresponding action.

After the combination is saved or reviewed, continue with [After maintaining a
combination](#after-maintaining-a-combination).

## Out of scope

- **Uploaded file** belongs to the shared import popup; this screen has no import launcher.
- `Registration` belongs to the log history component rather than this page.
- `Upload` belongs to the shared import popup rather than this page.

## After maintaining a combination

Review the audit sequence, then return to the serial-combination list to locate another
combination.

**Prerequisites**

- Have audit history enabled for your account and company branch.
- Open the details page for the serial type you reviewed.

**Steps**

1. Select **Last Modifications**.
2. Review the chronological sequence of actions performed by users.
3. Check the dated entries, including `Created` and `1 Changes` when they are present.
4. Return to the serial-combination list when you need to locate another combination.

![Review the chronological audit entries](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/88c5c80fb113e15628e5953623fc4ba1.png)

The audit area includes `Created` and `1 Changes`. Serial combination changes apply only
to new jobs; old jobs are not affected.

**Result:** The combination's audit history is available for review when the audit
condition is met, and you can continue from the serial-combination list.
