# Comments, files, and history on an MRQ

An MRQ is a material requisition: a saved request whose supporting files, discussion, and
modification history remain available for follow-up work.

## Before you start

The MRQ status values are `NA`, `Active`, and `Cancelled`. Complete the request on the MRQ
record, then use its related areas for supporting material, discussion, and history.

| If you need to… | Go to |
|---|---|
| Open the saved MRQ and reach its related areas | [Find and open the saved MRQ](#find-and-open-the-saved-mrq) |
| Recognize the saved-MRQ surface | [Understand the saved-MRQ surface](#understand-the-saved-mrq-surface) |
| Keep a supporting file with the MRQ | [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq) |
| Create a library entry | [Enter library details](#enter-library-details) |
| Create a folder entry | [Enter folder details](#enter-folder-details) |
| Upload supporting material | [Enter upload details](#enter-upload-details) |
| Keep written discussion with the MRQ | [Keep discussion with the MRQ](#keep-discussion-with-the-mrq) |
| Read the audit history | [Review Last Modifications](#review-last-modifications) |
| Complete the MRQ record itself | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) |
| Create an MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
| Manage the wider purchase-job workspace | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) |
| Use file management outside an MRQ | [Libraries and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) |

## Find and open the saved MRQ

A saved MRQ has an identifier, so its related tabs can be shown. The tab area is available when
the record is saved and the purchasing subscription is included.

**Prerequisites**

- You are signed in to PAMS.
- You have an existing saved MRQ to open.
- The purchasing subscription is included for the current account.

**Steps**

1. Open an existing saved MRQ.
2. Confirm that `Log in to Pams` is not shown.
3. Confirm that **Last Modifications** is visible.

   ![The saved MRQ surface with its stage tabs, record fields, item columns, and Last Modifications tab](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5de95b11ab03a9c24121ce4e29a1dee7.png)

**Result:** The saved MRQ is open and its related-tab area is available. Continue with
[Understand the saved-MRQ surface](#understand-the-saved-mrq-surface).

## Understand the saved-MRQ surface

The saved-MRQ surface combines the MRQ record with related follow-up areas. The record controls
are **Branch**, **MRQ title**, **Required Receiving Date**, and **Required Receiving After**.

| Area | What you can see |
|---|---|
| Record controls | **Branch**, **MRQ title**, **Required Receiving Date**, **Required Receiving After** |
| Item columns | `#`, `Product`, `Unit`, `Qty`, `Purchasing`, `Forecasted Receiving Date` |
| Related areas | Discussion, Last Modifications, and files |

The surface has six item columns and three buttons: **Save**, **Save and Close**, and **Refresh**.
It also includes the MRQ, RFQ, and Direct PO stage tabs. Use [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up)
for record-level completion.

The related areas are conditional. The tabs require a saved MRQ and an included subscription; the
discussion area requires an available comments list and the **Comments** tab; the history area
requires the **Last Modifications** tab.

   ![The saved MRQ surface before opening a related area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5de95b11ab03a9c24121ce4e29a1dee7.png)

Choose [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq) for files,
[Keep discussion with the MRQ](#keep-discussion-with-the-mrq) for comments, or
[Review Last Modifications](#review-last-modifications) for history.

## Keep supporting files with the MRQ

The files surface keeps libraries, folders, and uploaded documents alongside the MRQ. A library
is the top-level file area, and a folder is a named area below the current non-default location.

| File-surface area | Labels and actions |
|---|---|
| Search and details | **Keyword to Search...**, **Library name**, **File Name**, **Links**, **Name**, **Type**, **Tags**, **Modified** |
| File actions | **Get old cloud**, **Download**, **Link**, **Open**, **Add/Remove tags**, **Rename**, **Export**, **Edit**, **Delete** |
| Entry areas | Edit a document, edit document links, create a folder, create a library, or upload a file |

The available entry action depends on the current location:

| If you need to… | Select |
|---|---|
| Create a library at library level | **New Library** |
| Create a folder below a non-default location | **New Folder** |
| Submit a supporting file below a non-default location | **Upload** |

Selecting a file can expose **Open** and **Add/Remove tags**. Selecting a folder or library can
expose **Rename**.

> **Note:** File creation and upload change the supporting material associated with the MRQ.
> Review the current location and file name before selecting a committing action.

**Prerequisites**

- The saved MRQ is open.
- The files surface is available.

**Steps**

1. Select **New Library**, **New Folder**, or **Upload**, according to the file action you need.

**Result:** The selected entry form is open. Continue with [Enter library details](#enter-library-details),
[Enter folder details](#enter-folder-details), or [Enter upload details](#enter-upload-details), as applicable.

### Enter library details

**Prerequisites**

- The library-entry form is open.

**Steps**

1. In **Library name**, enter the library name.
2. Select **Save**.

**Result:** The library-entry details are submitted. Return to [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq).

### Enter folder details

**Prerequisites**

- The folder-entry form is open.

**Steps**

1. In **Name**, enter the folder name.
2. Select **Save**.

**Result:** The folder name is submitted. Return to [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq).

### Enter upload details

An upload adds supporting material to the current file location with the metadata requested by the
upload entry.

**Prerequisites**

- The upload form is open.
- You have the supporting file and its metadata ready.

**Steps**

1. In **File Name**, enter the file name.
2. In **Type**, select the file type.
3. In **Tags**, enter or select the tags for the file.
4. Submit the supporting file with **Upload**.
5. If you decide not to submit it, select **Cancel**.

If the file name fails the file-name character rule, the message is
`Just '_'‘-''.' And '&' Characters Accepted`. After a successful file request, the success
message is `Your request was completed successfully`.

**Result:** The upload form is submitted with **Upload** or closed with **Cancel**. Continue with
[Keep discussion with the MRQ](#keep-discussion-with-the-mrq) when you are ready to record discussion.

## Keep discussion with the MRQ

Comments are written discussion attached to a saved MRQ. The discussion area requires a saved MRQ,
the **Comments** tab, and an available comments list.

| If you need to… | Select |
|---|---|
| Add a new comment | **Post** |
| Reply to a displayed comment | **Reply** |
| Change your own comment | **Edit** |
| Save an edited comment | **Save** |
| Leave comment editing | **cancel** |
| Open replies | **view sub comments** |
| Start comment deletion | **Delete** |
| Close the deletion confirmation | **Cancel** |

Use **Edit**, **Save**, or **cancel** for your own comment. Use **Reply** when the reply area is
shown and you have permission to reply. Use **view sub comments** when the comment has replies.

**Prerequisites**

- The saved MRQ is open.
- The **Comments** tab is available on the current record.
- You have permission to use the discussion action you need.

**Steps**

1. Select **Comments** when it is available on the saved MRQ.
2. Select the discussion action that matches your work in the table above.

**Result:** The selected action opens its editor or confirmation surface. Continue with
[Review Last Modifications](#review-last-modifications) when you are ready to review the record
history.

## Review Last Modifications

Last Modifications is the audit-log surface for reading the chronological sequence of actions
performed by users on the saved MRQ.

**Prerequisites**

- The saved MRQ is open.
- **Last Modifications** is visible.

**Steps**

1. Select **Last Modifications**.
2. Read the history rows shown for the MRQ.
3. Select a history row when it has changes to open its change details.
4. Select **Refresh** when you need to reload the history.

The audit log provides a chronological sequence of actions performed by the users.

   ![The Last Modifications tab selected on the saved MRQ](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5de95b11ab03a9c24121ce4e29a1dee7.png)

**Result:** Last Modifications is open and the saved MRQ's chronological history is available.
Continue with [When a follow-up action goes wrong](#when-a-follow-up-action-goes-wrong) if an action
does not complete.

## When a follow-up action goes wrong

Use the exact message on screen to decide whether the record-level save needs correction or the
related surface needs product or administrator follow-up.

| What you see | What to do |
|---|---|
| `Check mandatory field(s)` | Review the required fields in the active entry before submitting again. |
| `An error occurred while processing your request` | Stop and request product or administrator follow-up before repeating the action. |
| **Comments** is not shown | Continue with **Last Modifications** or return to the MRQ record guidance; Comments is conditional. |

If a record-level save displays one of these messages, correct the MRQ record before continuing
with related work:

- `Package must have at least one item`.
- `Cannot be deleted. Product is in purchasing`.
- `You cannot save without adding at least one product`.
- `One of products has no quantity`.

## Know what to do next

After reviewing the available discussion, files, and history, choose the next MRQ or procurement
task.

| If you need to… | Continue with |
|---|---|
| Complete requested products or additional requirements on the MRQ | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) |
| Create the request because no saved MRQ exists | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
| Continue with the wider procurement workspace | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) |
| Find active or archived purchase-job work | [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) |
