# Features

Use **Features** to compare subscription plan limits, choose features for each plan,
and review feature prices before assigning a plan to a company.

## Features overview

**Features** is the configuration screen for comparing the limits and feature selections
that belong to subscription plans. It also provides the feature prices used in that
comparison.

| If you need to… | Go to |
| --- | --- |
| Review the plan-limit fields and feature matrix | [Read the Features screen](#read-the-features-screen) |
| Change plan capacity values | [Change plan limits](#change-plan-limits) |
| Add or remove a feature in a plan | [Assign a feature to a plan](#assign-a-feature-to-a-plan) |
| Open and close the feature-price dialog without saving | [Open and close the feature-price dialog without saving](#open-and-close-the-feature-price-dialog-without-saving) |
| Select all child features under a parent | [Select child features together](#select-child-features-together) |
| Continue to plan or company-specific configuration | [Continue from Features](#continue-from-features) |

The available plan columns and feature rows determine what you can compare. Review them
before choosing a plan.

## Before you start

Prerequisites

- Have administrator access to the configuration area.
- Know which plan column you intend to review or change.
- Identify whether you are reviewing plan limits, feature selections, or feature prices.

The available plan columns and feature rows depend on the current configuration. Open the
screen when you are ready to review those choices.

## Open Features

Steps

1. Open **Features** from the configuration navigation.
2. Confirm that **Plan name** and **Features** are visible.
3. Select **Companies** to return to the company configuration view when needed.

**Result:** The **Features** screen is open, with **Companies** available as the related
navigation link.

![Identify the plan-limit area, feature matrix, Companies link, and Save action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3f8ab829c6922bbeefd2cd58f785048c.png)

The open screen leads to the plan-limit and feature-matrix review below.

## Read the Features screen

The screen combines plan-limit fields with a feature matrix. Read a plan column from its
plan values, then read the feature rows and their plan selections.

| Field | What to read |
| --- | --- |
| **Plan name** | Use this field to identify the plan before reviewing its limits. It is required and has pattern validation. |
| **Plan Price** | The plan price, shown as a number with a minimum of `0` and a `#,##0.00` format. |
| **Branches count** | The branch capacity, from `1` to `99`. |
| **Users count** | The user capacity, from `1` to `99`. |
| **Teams count** | The team capacity, from `1` to `99`. |
| **Roles count** | The role capacity, from `1` to `99`. |
| **Dashboard widgets count** | The dashboard-widget capacity, from `1` to `99`; this field is disabled. |
| **Warehouses count** | The warehouse capacity, from `0` to `99`. |
| **Latest modifications count** | The latest-modifications capacity, from `0` to `99`. |

The feature matrix is headed Features. Its visible columns are Feature, Id, Price, and one
plan-selection column for each available plan. The current plan columns are Plan #0, Plan #1,
and Plan #2. Prices are read out in EUR.

Use Feature and Id to identify a row, Price to review its price, and the plan
column to review whether the feature is selected for that plan. When you have identified the
values to change, use the maintenance procedure that follows.

The plan-limit area appears when plan details are available. The Features tree appears
only when the available feature list contains at least one item. **Save** is disabled when
there are no unsaved plan changes.

![Read the plan-limit fields and the Feature, Id, Price, and plan-selection columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3f8ab829c6922bbeefd2cd58f785048c.png)

## Change plan limits and feature assignments

Use the plan-limit fields and feature-selection cells to prepare one complete plan change,
then select **Save** to submit it. To edit a feature price, use
[Open and close the feature-price dialog without saving](#open-and-close-the-feature-price-dialog-without-saving).

Prerequisites

- Know which plan column you are maintaining.
- Know the plan values or feature selections to apply.

Steps

1. Apply the change that matches your task.

   | If you need to… | Do this |
   | --- | --- |
   | Change plan limits | Follow [Change plan limits](#change-plan-limits). |
   | Assign a feature | Follow [Assign a feature to a plan](#assign-a-feature-to-a-plan). |
   | Select child features together | Follow [Select child features together](#select-child-features-together). |

2. Review the changed plan values and feature selections.
3. Select **Save**.

**Result:** The changed plan limits and feature selections are submitted.

### Change plan limits

Change a plan's name, price, and capacity values when the available subscription limits need
maintenance.

Prerequisites

- Know which plan column to maintain.
- Have the replacement plan values.

Steps

1. In the selected plan column, enter the replacement values in the fields below.

   | Field | Allowed value or action |
   | --- | --- |
   | **Plan name** | Enter the name used to identify the plan. |
   | **Plan Price** | Enter the price. |
   | **Branches count** | Enter a value from `1` to `99`. |
   | **Users count** | Enter a value from `1` to `99`. |
   | **Teams count** | Enter a value from `1` to `99`. |
   | **Roles count** | Enter a value from `1` to `99`. |
   | **Dashboard widgets count** | Review the displayed value after the capacity values change. |
   | **Warehouses count** | Enter a value from `0` to `99`. |
   | **Latest modifications count** | Enter a value from `0` to `99`. |

2. Review **Dashboard widgets count** after the plan feature selections change.
3. Select **Save**.

The dashboard-widget count is derived again when plan feature selections change. Keep the
displayed value with the completed plan review before saving.

**Result:** The selected plan column contains the revised plan-limit values and is sent to
the plan save operation.

### Assign a feature to a plan

Assign a feature by changing its selection cell in the target plan column, then save the
plan configuration.

Prerequisites

- Know the feature row to change.
- Know the target plan column.

Steps

1. Locate the feature by its Feature and Id values.
2. Select the feature-selection cell in the target plan column.
3. Review the changed selection and **Dashboard widgets count**.
4. Select **Save**.

Selecting the cell adds or removes the feature from the selected plan and recalculates the
dashboard-widget count.

**Result:** The feature assignment is included in the selected plan's changes.

### Open and close the feature-price dialog without saving

The feature-price popup provides an **Edit feature** dialog for a feature row. Use it to
review the feature price controls.

Prerequisites

- Have a feature row available in the feature matrix.

Steps

1. Select a feature row other than the all-features row.
2. In the **Edit feature** dialog, review the price entry for the selected feature.
3. Select **OK** to use the dialog's confirm control.

The feature-price popup opens when you select a feature row. Its price entry is optional
and has a minimum of `0`.

**Result:** The feature-price dialog is closed after its **OK** control is used.

## Handle parent and child features

A parent feature row can expose child feature rows beneath it. The available tree and its
parent-child relationships vary with the feature data returned when the screen loads.

When a parent has child features, **Select all sub** is available for that parent row. Child
rows provide the individual feature selections in the plan columns.

### Select child features together

Use **Select all sub** on a parent row when every child feature under that parent belongs in
the selected plan.

Prerequisites

- Have a parent feature row with child features.
- Know the plan column that receives the child selections.

Steps

1. Locate the parent feature row in the current feature tree.
2. In the target plan column, select **Select all sub** for that parent row.
3. Review the child feature rows in the target plan column.
4. Select **Save**.

Each plan column can expose its own **Select all sub** control. The control selects the child
features for the parent feature in the chosen plan column.

**Result:** The child features are selected together for the chosen plan and included in the
changes sent by **Save**.

## When a value or save goes wrong

Use the table below when a value is rejected or a request returns an error.

| What you see | Rule or path | What to do |
| --- | --- | --- |
| **Plan name** is rejected as empty | The field is required. The message is `This Field Is Required`. | Enter a plan name. |
| **Plan name** contains an unsupported character | Pattern validation accepts only the characters described by `Just '_'‘-''.' And '&' Characters Accepted`. | Replace the unsupported character with an accepted one. |
| **Plan Price** or a feature price is below `0` | The price minimum is `0`. | Enter `0` or a higher value. |
| A plan count is outside its allowed range | **Branches count**, **Users count**, **Teams count**, **Roles count**, and **Dashboard widgets count** accept `1` to `99`; **Warehouses count** and **Latest modifications count** accept `0` to `99`. | Enter a value within the field's range. |
| A plan or feature request returns an error | `An error occurred while processing your request` | Review the values and try the configuration again. |

The same request-error message is used for plan loading, plan saving, and feature saving.
After resolving the problem, continue with the relevant configuration area.

## Continue from Features

After reviewing or changing the comparison, continue to the configuration page that matches
the next task.

| If you need to… | Go to |
| --- | --- |
| Return to company configuration | Select **Companies**. |
| Review plan records | [Plans](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans) |
| Review details for one plan | [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record) |
| Review company-specific plan and feature configuration | [Company features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) |
| Review subscriber feature assignment | [Subscriber configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscriber-edit-record) |

## Out of scope

This screen does not provide controls to create or delete features. It also does not declare
a success message after **Save**, so the screen provides no confirmation message for a
completed plan or feature save.
