# Manage demo data

Demo data is the demo company data managed as a whole from Configuration. Use this page before a
training or demonstration session, or after the session when you want to remove it.

| If you need to… | Go to |
|---|---|
| Find the page | [Find the page](#find-the-page) |
| Identify the action for the current account state | [Understand the screen](#understand-the-screen) |
| Start the first import | [Import demo data](#import-demo-data) |
| Refresh or remove imported demo data | [Refresh or delete imported demo data](#refresh-or-delete-imported-demo-data) |
| Continue with another Configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |

## Before you start

Demo data management uses the signed-in account's demo-data state to choose its starting row. The
page works on the demo company data as a whole rather than on individual records.

**Prerequisites**

- Sign in to the account whose demo-data state you want to manage.
- Know whether that account has demo data imported.

The page has no page-owned fields to complete, no file-selection step, and no grid or table columns
to review. No approval step is included for deleting demo data.

## Find the page

The Manage demo data page is the Configuration screen for importing, refreshing, and deleting demo
data.

Open Manage demo data from Configuration.

The deletion completion guidance includes the settings reference `Settings - Demo Data Settings`.

## Understand the screen

The page shows one of two rows according to whether demo data is already imported. The account starts
with the import row when its demo-data state is not imported; the imported branch offers refresh and
delete actions instead.

| When you are… | Select or do this |
|---|---|
| Demo data is not imported | Select **Import demo data**. |
| Demo data is imported | Select **Refresh demo data** or **Delete demo data**. |
| The deletion completion message is shown | Read the completion guidance, then select **Close**. |

The starting row determines which procedure follows: use [Import demo data](#import-demo-data) for
an account without imported data, or use [Refresh or delete imported demo data](#refresh-or-delete-imported-demo-data)
for an account with imported data.

## Import demo data

To import demo data, follow these steps.

**Prerequisites**

- The signed-in account is in the not-imported demo-data state.
- The Manage demo data page is open.

**Steps**

1. Select **Import demo data**.

   The modal changes to the progress state and shows `Start importing demo company data…`.

   ![The import action before starting the demo-data import](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abf65da87352cbd870653c8916a44117.png)

2. Keep the browser window open until the import finishes.

   > **Warning:** `Importing the demo company data will take a few minutes. Please do not close this browser window until the import process is complete. Ending the import process before it is finished may result in corrupt data being entered.`

   ![The import-progress message and warning](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fc38e252e013d8b6fd6b39c0b8e7c4e4.png)

3. Select **Close** after `Importing demo company data completed.` appears.

   ![The completed import message and Close action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/34bc0121509d4cf90a8d29742617f2e7.png)

**Result:** The import modal shows `Importing demo company data completed.` and **Close**.

## Refresh or delete imported demo data

When demo data is imported, choose whether to refresh it or remove it.

### Refresh imported demo data

Use refresh when you want to run the page's refresh operation on imported demo data.

**Prerequisites**

- Demo data is imported for the signed-in account.
- The Manage demo data page is open.

**Steps**

1. Select **Refresh demo data**.

   The refresh operation uses its own request.

   ![The imported-data row with Refresh demo data](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abf65da87352cbd870653c8916a44117.png)

**Result:** The page reports `Demo company data refreshed successfully` when the refresh request
reaches its success state.

### Delete imported demo data

Use deletion when you want to remove demo company data and its related records without affecting
private data added during experimentation.

**Prerequisites**

- Demo data is imported for the signed-in account.
- The Manage demo data page is open.

**Steps**

1. Select **Delete demo data**.

   The confirmation modal shows the title `Deleting demo company data?`. The modal also shows this
   safety message:

   `Deleting demo company data (and all its related records) will not affect your real private data that was added during the experimentation.`

   ![The confirmation dialog with the demo-data safety message](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abf65da87352cbd870653c8916a44117.png)

2. Choose one action in the confirmation modal.

   | Select | To |
   |---|---|
   | **Keep** | Leave the demo data in place |
   | **Delete** | Continue with deletion |

3. If you chose **Keep**, select **Keep**.

   **Result:** The deletion request does not start.

4. If you chose **Delete**, review `Important: Importing the demo company data will take a few minutes.`.

   **Result:** The deletion warning has been reviewed.

5. If you chose **Delete**, select **Delete** to confirm.

   The modal changes to the progress state and shows `Deleting demo company data…`.

   **Result:** The deletion progress state shows `Deleting demo company data…`.

6. If you chose **Delete**, keep the browser window open until the deletion finishes.

    When deletion completes, the modal shows `Demo company data deleted successfully` and the
    guidance `Start using PAMS account and remember you can manage demo company data any time from
    Settings - Demo Data Settings`.

   **Result:** The modal shows the deletion completion message and guidance.

7. If you chose **Delete**, select **Close** after the completion message appears.

   **Result:** The delete modal closes.

**Result:** After **Keep**, deletion does not start. After **Delete**, the completion message appears
and **Close** closes the delete modal.

## When an operation goes wrong

The page uses the same request-error message for failed import, refresh, and delete requests:
`An error occurred while processing your request`.

| What you see | What to do |
|---|---|
| The import request stops before completion | Keep the browser open while the request is active, then use the request-error message as the failure signal. |
| `An error occurred while processing your request` after an operation | Treat the operation as unsuccessful and repeat it only after the account is ready for that operation. |
| Refresh controls are unavailable | Return to the page when the imported-data branch is available. |
| Delete controls are unavailable | Return to the page when the imported-data branch is available. |

After the deletion completion message appears, select **Close**. Continue with the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home).

## After managing demo data

Use this procedure after the deletion completion message appears.

**Prerequisites**

- The deletion completion message and guidance are visible.

**Steps**

1. Read `Start using PAMS account and remember you can manage demo company data any time from Settings - Demo Data Settings`.
2. Select **Close**.

**Result:** The completion guidance has been displayed and **Close** has been selected.
