# Clone Order Request Item Entity for Back Office

This section explains how to **clone the Order Request Item entity** and customize it for the **Back Office role**.\
Back Office users are responsible for **selecting suppliers**, **reviewing stock and pricing**, and **preparing cost summaries** before requests proceed to the approval stage.

The Back Office entity is derived from the **Admin Order Request Item entity**, with adjustments made to fields, visibility, and actions to match Back Office responsibilities.

***

### Objective

By completing this section, you will learn how to:

* Clone an existing Order Request Item entity
* Modify fields for Back Office–specific data handling
* Enable read‑only viewing of supplier information
* Add fields for stock allocation and pricing calculation
* Restrict actions inappropriate for Back Office users

***

### Step 1: Open Clone Entity

1. From the **ONEWEB App Designer** screen, click\
   **Entities > Clone Entity**.
2. The **Clone Entity** dialog opens.

***

### Step 2: Clone the Admin Order Request Item Entity

1. At **Select Existing Entity**, choose\
   `Doc Order Request Item - Admin`.
2. At **Name of Clone Entity**, enter\
   `Doc Order Request Item - Back Office`.
3. Click **Clone**.
4. Wait until the message\
   \&#xNAN;**“Entity has been imported successfully”** appears and the\
   **Open Cloned Entity** button is shown.

***

### Step 3: Open the Cloned Entity

1. Click **Open Cloned Entity**.
2. The **Search Entities** dialog opens.
3. Click the **pencil icon** to edit the cloned entity.

***

### Step 4: Add Summary Price Field to Order Request Item

1. In module **Order Request Item**, click **Append Row**.
2. From **Tools > Field**, drag a **Text Box** into the first cell of the new row.
3. Click the **pencil icon** to configure the field.

Configure as follows:

* Source tag: `readonly`
* Number Formatter: `Currency`
* FIELD\_ID: `SUMMARY_PRICE`
* Populate ShowFieldName → `Summary Price`

4. Click **OK**.

***

### Step 5–9: Enable View Mode for Supplier Fields

In module **Supplier**, edit each field as follows:

1. **Supplier Name**
   * Set `viewFlag` = `Y`
   * Click **OK**
2. **In Stock**
   * Set `viewFlag` = `Y`
   * Click **OK**
3. **Unit Price**
   * Set `viewFlag` = `Y`
   * Click **OK**
4. **Remark**
   * Set `viewFlag` = `Y`
   * Click **OK**

These fields are displayed as read‑only for Back Office users.

***

### Step 10: Add Remain Order Unit Field

1. From **Tools > Field**, drag a **Text Box** into module **Supplier**.
2. Click the **pencil icon** to configure.

Configure as follows:

* Number Formatter: `Integer`
* FIELD\_ID: `REMAIN_ORDER_UNIT`
* Populate ShowFieldName → `Remain Order Unit`
* FieldGroup: `3`
* Seq: `1`
* onlyGuiFlag: `Y`
* viewFlag: `Y`

3. Click **OK**.

This field displays remaining units that can still be ordered.

***

### Step 11: Add Order Unit Field for Back Office

1. From **Tools > Field**, drag a **Text Box** into module **Supplier**.
2. Click the **pencil icon** to configure.

Configure as follows:

* Number Formatter: `Integer`
* FIELD\_ID: `UNIT_BY_BACK_OFFICE`
* ShowFieldName: `Order Unit`
* FieldGroup: `4`
* Seq: `1`
* ShowSearch: `Y`
* showSearchSeq: `4`

3. Click **OK**.

***

### Step 12: Add Total Price Field

1. From **Tools > Field**, drag a **Text Box** into module **Supplier**.
2. Click the **pencil icon** to configure.

Configure as follows:

* Source tag: `readonly`
* Number Formatter: `Currency`
* FIELD\_ID: `TOTAL_PRICE`
* Populate ShowFieldName → `Total Price`
* FieldGroup: `4`
* Seq: `2`
* ShowSearch: `Y`
* showSearchSeq: `5`

3. Click **OK**.

***

### Step 13: Add Back Office Remark Field

1. From **Tools > Field**, drag a **Textarea** into module **Supplier**.
2. Click the **pencil icon** to configure.

Configure as follows:

* FIELD\_ID: `BACK_OFFICE_REMARK`
* Populate ShowFieldName → `Back Office Remark`
* FieldGroup: `5`
* Seq: `1`

3. Click **OK**.

***

### Step 14: Remove Unused Module Buttons

1. In module **Supplier**, delete the following buttons:
   * **ADD**
   * **DELETE**

Back Office users should not create or remove supplier records at this stage.

***

### Step 15: Save the Entity

1. Click **Save this Entity** to complete the configuration.

The completed Back Office Order Request Item entity appears as shown below:

<figure><img src="https://docs.oneweb.tech/oneweb/~gitbook/image?url=https%3A%2F%2F2015371994-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FMpDjHWFRUtZ5nJcSfVXd%252Fuploads%252FIgxuqwgSUTfBvdqtePwG%252Fimage.png%3Falt%3Dmedia%26token%3D8bdbfa7a-0408-4514-b81b-719a1fe51462&#x26;width=768&#x26;dpr=1&#x26;quality=100&#x26;sign=1412e8fc&#x26;sv=2" alt=""><figcaption></figcaption></figure>

***

### Summary

In this section, you have:

* Cloned the Admin Order Request Item entity for Back Office usage
* Added pricing and quantity calculation fields
* Enabled read‑only viewing of supplier information
* Configured Back Office–specific input fields
* Removed actions not suitable for Back Office users

This entity enables Back Office users to **evaluate suppliers, allocate quantities, and prepare pricing information**, forming a crucial step in the **Order Management App (Web)** workflow.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onewebstack.com/tutorials-examples/order-management-app-web/app-designer/clone-order-request-item-entity-for-back-office.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.