# Inspection documents

## Inspection documents

An inspection document is a warehouse configuration record that names a document used in warehouse
work. You manage it under **Configuration** > **Warehouse settings** on the shared configuration
surface.

| If you need to… | Go to |
|---|---|
| Check access and record requirements | [Before you start](#before-you-start) |
| Open the list or new-record surface | [Find an inspection document](#find-an-inspection-document) |
| Learn what the list and form contain | [Understand the list and form](#understand-the-list-and-form) |
| Add, edit, delete, save, or export | [Add or maintain an inspection document](#add-or-maintain-an-inspection-document) |
| Understand access and layout differences | [Handle access and surface variations](#handle-access-and-surface-variations) |
| Resolve a message or blocked action | [When maintenance does not work](#when-maintenance-does-not-work) |
| Open a related Warehouse list | [Continue with related warehouse configuration](#continue-with-related-warehouse-configuration) |

The list heading and popup title are **Inspection document**, and the parent setting is **Warehouse**.
The list shows the **Name** column and eight records.

![The Inspection document list with its Name column and records](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3b1e25d0e23be1462ea2257105c8f6a4.png)

## Before you start

The inspection document list is available when the subscription includes the shared configuration
surface. Your permissions and the saved list configuration determine which maintenance actions appear.

| Condition | What you can expect |
|---|---|
| The subscription includes this area | The inspection-document list is available. |
| The subscription does not include this area | An upgrade surface appears instead of the list. |
| **New** is visible | You can open the new-record surface. |
| The edit action is visible in a row's action column | You can open that record for editing. |
| The delete action is visible in a row's action column | You can open that record's delete menu. |

Each inspection document needs a **Name**. The form displays **Name** as a required text box.

The list can show different columns and labels. Use the headers and labels visible in your list.

## Find an inspection document

Open the inspection-document list through **Configuration** > **Warehouse settings**.

**Prerequisites**

- Your account can open the Warehouse inspection-document configuration surface.

**Steps**

1. Select **Configuration**.
2. Select **Warehouse settings**.
3. Select **Inspection Document**.
4. Confirm that the page heading is **Inspection document**.
5. Confirm that the list contains the **Name** column.
6. Review the records in the list.
7. Select **New**.
8. Confirm that the new-record surface is titled New Inspection document.

**Result:** The list is open, or the New Inspection document surface is open with its **Name** field
ready for entry.

## Understand the list and form

The form is a focused reference form: it asks for the document's **Name** and does not add
inspection-specific data fields to this resource.

| Surface | What you see | What it is for |
|---|---|---|
| List | **Name** | Identifies each record. |
| New-record form | **Name** with a required marker | Enters the inspection document name. |
| New-record form | **OK** | Submits the new-record surface. |
| Action column | Edit and delete actions | Maintains an existing row when your permissions allow it. |

The **Name** field is a text box. It appears when the new-record or edit popup is open and is required
on the form.

The grid's extra action column has no caption. The list does not display **DisplayOrder**, **Id**, or
**CompanyId**, so you do not edit these fields in this list.

The form does not ask for a select box, date, number, currency, or composite value. It is centered on
the required **Name** text box.

![The New Inspection document surface with the required Name field and OK control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e9e2b7d0f0209e16ce606bac6cc3f9a6.png)

## Add or maintain an inspection document

The new-record surface creates a record. A row's action column maintains an existing record, and the
list actions work with the list as a whole.

### Open a new inspection document

**Prerequisites**

- The subscription feature is included.
- **New** is visible.
- You have the inspection document name ready.

**Steps**

1. Select **New**.
2. Confirm that the New Inspection document surface opens.
3. Enter the document name in **Name**.
4. Select **OK**.

**Result:** The New Inspection document surface displays the required **Name** field and **OK**.

### Edit an inspection document

**Prerequisites**

- Edit permission is available.
- The row already exists.

**Steps**

1. In the row's action column, select the edit action.
2. Edit the value in **Name**.
3. Choose how to finish the edit.

| Choice | Action |
|---|---|
| Save the changed name | Select **Save**. |
| Leave the name unchanged | Select **Cancel** in the save popup. |

**Result:** The edit popup contains the inspection document's **Name** control.

### Delete an inspection document

**Prerequisites**

- Delete permission is available.
- More than one item is in the data source.

**Steps**

1. In the row's action column, select the delete action.

| If you want to… | Select |
|---|---|
| Close the delete menu without deleting the row | **Cancel** |
| Request deletion | **Delete** |

The delete action is available when more than one item is in the list. The delete menu displays
`Are you sure you want to delete this item?`.

**Result:** The delete menu is open after selecting the delete action in the row's action column, or
closed after selecting **Cancel**.

### Export the inspection-document list

**Prerequisites**

- Export access is available.
- The **Settings** control is visible.

**Steps**

1. Select **Settings**.
2. In the export menu, select **Export**.
3. Select an option in the export menu.

**Result:** The export options open after selecting **Export**.

The edit action opens the selected row in the edit popup. **Save** submits the popup form, and the
save popup's **Cancel** closes that popup.

## Handle access and surface variations

Subscription coverage, permissions, and the current list layout can change what appears.

| Variation | Surface change |
|---|---|
| The subscription does not include this area | The upgrade surface replaces the list. |
| The edit action is absent from a row's action column | That row cannot be opened for editing. |
| The delete action is absent from a row's action column | That row cannot be opened for deletion. |
| The list shows different headers or labels | Work from the headers and labels visible in your list. |

> **Note:** Controls and messages for survey answers, reference-list questions, currencies, banks,
> cost items, and product withdrawal strategies belong to other configuration lists. They are not
> fields on the inspection-document form.

## When maintenance does not work

Use the message on screen to identify whether the problem concerns the field value or a delete
condition.

| If you see this message | What to do |
|---|---|
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and try the filter again. |
| `Data saved Successfully` | Check the list for the new record. |
| `Data updated Successfully` | Check the list for the updated record. |
| `Are you sure you want to delete this item?` | Confirm the record and deletion action before continuing. |
| `Data Deleted Successfully` | Check that the row is no longer in the list. |
| `Related to Saved data, Can't be deleted` | Keep the related record in place. |
| `Failed to Delete` | Review the deletion condition before trying again. |
| `Must have at least one item` | Keep at least one inspection document. |

## Continue with related warehouse configuration

Warehouse settings groups inspection documents with sibling reference lists on the same navigation
surface. Open a sibling page when you need a different Warehouse configuration resource.

- [Warehouse configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view).
- [Base Of Inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base).
- [Inspection Checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist).
- [Transfer Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons).
- [Service Types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-service-types).

These lists share the generic configuration surface, while each remains a separate reference-list
resource under Warehouse settings.
