# Teams

## Teams at a glance

A team record groups members under a required team name and department. A saved team
provides a member list, a leader, activation controls, and history; a sales team also
has a booking target. Team administration sits in the security administration area
alongside users and roles.

The team-type list identifies `NA`, `SalesTeam`, `SalesTeamless`, `Administration`,
`PurchasingTeam`, and `ProjectManagementTeam`.

If you need to:

| If you need to… | Go to |
|---|---|
| Find a team or open the new-team form | [Find and open a team](#find-and-open-a-team) |
| Narrow, group, lay out, or export the list | [Adjust the Teams list](#adjust-the-teams-list) |
| Read the fields and tabs on a team | [Understand the team screen](#understand-the-team-screen) |
| Add or edit a member | [Add or edit a member](#add-or-edit-a-member) |
| Change a leader or remove a member | [Change a member or the team status](#change-a-member-or-the-team-status) |
| Review users who can become members | [Users](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) |
| Create a user before adding that person to a team | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) |
| Maintain permissions beside team membership | [Roles](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/roles) |
| Maintain the related booking target | [Targets and budgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-booking-target) |
| Review adjacent account-manager administration | [Account managers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-account-managers-view) |

## Before you start

Team administration is available only when the signed-in account can enter the security
area and the subscription allows the company's team capacity. The Teams list is behind
authenticated access. The new and edit routes also protect unsaved changes when you
leave the screen.

| Before you start | Why it matters |
|---|---|
| Sign in with an account that has access to security administration. | Authentication is required for the Teams list and team form. |
| Check that the subscription allows another team. | If **New** is unavailable, ask the administrator to review the subscription's team capacity. |
| Use a saved team for member, activation, deactivation, and history work. | Member and status actions require a team identifier; **Last Modifications** is available only for a saved team. |
| Have the team name, department, members, and intended leader ready. | The team form requires the team name and department; member and leader information is used in the related surfaces. |

You cannot delete a team from the Teams list.

## Find and open a team

The Teams list is the starting place for finding existing teams, creating a team, and
entering the merge flow.

Prerequisites

- Sign in with access to security administration.
- Have a team record to open, or know the information for a new or merged team.

Steps

1. Open the Teams list.
2. Choose the route for your task:

   | If you need to… | Select |
   |---|---|
   | Open an existing team in your branch | An existing team row |
   | Create a team | **New** |
   | Enter the merge flow | **Merge teams** |

![The Teams list with its team rows, toolbar, and entry actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8601497aad10dfdca03de9bf2b9e9178.png)

**Result:** The Teams list, an existing team record, the new-team form, or the merge
dialog is on screen. Continue with [Adjust the Teams list](#adjust-the-teams-list),
[Understand the team screen](#understand-the-team-screen), or the relevant maintenance
procedure.

## Adjust the Teams list

The Teams list is where you find teams and change what the list displays or exports.
Use the team-record procedures below to change a team.

| List surface | Use it to… |
|---|---|
| Search | Search the visible team list. |
| Filters | Narrow the rows by available filter values. |
| Grouping | Group rows in the list. |
| Columns | Choose or review the columns in the current layout. |
| Paging | Move through the list pages. |
| State storing | Keep the list view state available to the list. |
| Export | Open export choices and export when rows exist. |
| Row opening | Open a row when its branch condition permits editing. |

The list displays `Team`, `Leader`, `Memebers`, `Department`,
`Target`, and `Active`. The spelling `Memebers` is the label shown
in that list. The available toolbar also showed **Refresh**, Table Layout, and
`Settings`.

To export the current list, select **Export**, choose the available export choice, and
select **Export**. If the list has no rows, the screen shows:

`NO Data to Export`.

The list also provides **Cancel** in the export popup. Import is not an available list
operation on this surface.

After adjusting the list, continue with [Understand the team screen](#understand-the-team-screen)
or [Start a team record or merge teams](#start-a-team-record-or-merge-teams).

## Understand the team screen

A team screen identifies the team, its department, its member and leader information,
and the saved-record areas used to maintain it.

| Area | What it contains | When it appears |
|---|---|---|
| Team identity | **Team Name** and **Department** | On the team form; both are required. |
| Member summary | **Members** | On the team form; it displays the member count. |
| Leader summary | **Team Leader** | On the team form; it displays the leader name. |
| Booking target | **Booking target** | When the department is `SalesTeam`. |
| Member maintenance | **Members** tab and Member action | On a saved, non-child team display. |
| History | **Last Modifications** | When the team has an id and the history tab is selected. |

The Members surface includes a member grid with a `Team member name` column and a blank
leader-marker column. The new-team form shows **Team Name**, **Department**, **Members**,
and **Team Leader**, plus **Save** and **Save and Close**. On a new team, **Last Modifications**
is absent, and **Department** offers **Sales**, **Purchasing**, and
**Project management**.

![The new-team form with required identity fields, member summary, and save actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/888d0d39401bd367a077f3cd57514333.png)

## Start a team record or merge teams

From the Teams list, choose the route that matches the work:

| If you need to… | Select | You enter |
|---|---|---|
| Record a team that does not yet exist | **New** | The new-team form. |
   | Combine selected teams into one team | **Merge teams** | The merge dialog. |

Both actions are available when your access allows team creation.

### Start a new team record

Use a new team record when you need to enter a team name and department before adding
members or maintaining the saved team.

Prerequisites

- Open the Teams list with team creation available.
- Have the team name and department ready.

Steps

1. Select **New**.
2. In **Team Name**, enter the team name.
3. In **Department**, select **Sales**, **Purchasing**, or **Project management**.
4. Select one of these save actions:

   | Select | Result |
   |---|---|
   | **Save** | Save and remain on the form. |
   | **Save and Close** | Save and leave the form. |

If a required value is missing, the form remains on screen for correction. A save
validation can show:

`Check validation`

The form also uses these validation messages:

`The common required-field message`.

`The pattern message for special characters`.

After a successful save, the screen shows:

`Saved Successfully`

If the save cannot complete, the screen can show:

`Saving Error`

or:

`You’ve reached the maximum storage limit`.

If the request fails without the storage-limit message, the screen can show:

`An error occurred while processing your request`.

![The new-team form at the required-field validation and save-choice point.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/888d0d39401bd367a077f3cd57514333.png)

**Result:** The team is saved, and you either remain on the team form or leave it. Continue
with [Understand the team screen](#understand-the-team-screen) or [Add or edit a
member](#add-or-edit-a-member).

### Open the merge dialog

The merge dialog combines selected source teams into a team with its own department,
name, members, and leader choice.

The options for **Choose teams to merge** are team records returned for the selected **Department**.

The options for **Team Leader** are member names returned from the selected teams.

| Control | Options |
|---|---|
| **Choose teams to merge** | |
| **Team Leader** | |

Prerequisites

- Open the Teams list with **Merge teams** available.
- Know which source teams belong in the combined team.
- Have the destination department, team name, and leader choice ready.

Steps

1. Select **Merge teams**.
2. In **Department**, select **Sales**, **Purchasing**, or **Project management**.
3. In **Choose teams to merge**, select from the team records returned for the selected department.
4. In **Team Name**, enter the destination team name after selecting at least one source team.
5. Review the read-only **Members** list.
6. In **Team Leader**, select one of the member names from the selected teams.

The merge requires at least two source teams. If you select fewer, the screen displays
`Select at least two teams to merge.` The destination name and leader remain required;
the corresponding messages are `Team Name is mandatory.` and `Team Leader is mandatory.`

![The Teams list with the merge entry and the new-team route available.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a58b2f55972a8bff17a7d81352491bee.png)

**Result:** The merge dialog contains the selected teams and their members, with the
destination department, name, and leader fields ready for the merge branch. Continue
with the merge action in the dialog.

## Maintain members and team status

Member maintenance changes who belongs to a saved team; status maintenance changes
whether that saved team is active. These actions are available from the saved team's
Members and status surfaces, not from a new unsaved record.

Prerequisites

- Open a saved team record.
- Know whether you need to add or edit a member, change the leader, remove a member,
  activate the team, or deactivate the team.

Steps

1. Select **Members** to open the member-maintenance surface.
2. Choose the member task:

   | If you need to… | Select |
   |---|---|
   | Add a member | **Member** |
   | Edit a member | The member row |

3. Select the member action that matches the required change.
4. Choose the status task:

   | If you need to… | Select |
   |---|---|
   | Activate the team | **Activate team** |
   | Deactivate the team | **Deactivate team** |

5. Select `confirm` in the confirmation popup when the requested change is correct.

**Result:** The saved team remains open with its member or active-state branch selected
for confirmation or maintenance. Continue with [Add or edit a member](#add-or-edit-a-member)
or [Change a member or the team status](#change-a-member-or-the-team-status).

### Add or edit a member

The Members tab is the team-maintenance area for adding a person to a team or changing
an existing member. The add-member popup uses **Team Members**; the leader choice is
the Team leadership checkbox with the visible text **Team leader**.

Prerequisites

- Open a saved team that is not displayed as a child record.
- Have an existing user record for the person to add or select.

Steps

1. Select **Members**.
2. Select Member to open the add-member popup.
3. In **Team Members**, select the person to add.
4. Select Team leadership when the person must be the team leader.
5. Select **OK** to apply the member choice.
6. In the member grid, select the member row when you need to edit an existing member.
7. In the edit-member selection, choose the available person record.
8. Select Team leadership when the edited member must be the leader.

The add-member popup can show `No data` in the member grid. If the selected person is
already a member, the screen shows:

`This person is already a member in this team`.

![The Members tab with the add-member popup, Team Members choice, and Team leadership control.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/496ecb168b7bfbeb2d49581fad21a4a9.png)

**Result:** The member popup closes after **OK**, and the Members surface shows the
member grid or the applicable duplicate-member message. Continue with [Change a member
or the team status](#change-a-member-or-the-team-status).

### Change a member or the team status

Use the actions beside a member to change leadership or remove a member. Use the status
control to activate or deactivate a saved team.

Prerequisites

- Open a saved team that is not displayed as a child record.
- For a leader change, select a member who is not the current leader.

Steps

1. In the Members tab, select Make as leader for the member who must lead the team.
2. Select `confirm` to apply the leader change after checking the confirmation text.
3. In the Members tab, select Remove from team for the member to remove.
4. Select `confirm` to apply the removal after checking the confirmation text.
5. Select the required status action:

   | If the team must… | Select |
   |---|---|
   | Become active | **Activate team** |
   | Become inactive | **Deactivate team** |

6. Select `confirm` in the status confirmation popup.

The confirmation texts are:

`Are you sure you want to make ... a team leader?`

`Are you sure you want to activate ...`

`Are you sure you want to deactivate ...`

`Are you sure you want to exclude ... from the team?`

After the status request, the screen shows either:

`Team activated successfully`

or:

`Team deactivated successfully`

If the request fails, the screen shows the corresponding message:

`Error while activate team`.

or:

`Error while deactivate team`.

**Result:** The selected member or saved-team status has reached its confirmation
branch, and a successful activation or deactivation displays its status message. Continue
with [What to do next](#what-to-do-next).

## When a field or route is unavailable

The missing surface usually belongs to one of five conditions: access, subscription,
record state, team type, or history availability.

| What you see | Condition to check | What to do |
|---|---|---|
 | **New** or **Merge teams** is unavailable. | The list creation permission or team subscription limit does not allow the operation. | Ask the administrator to review access and the company's team capacity. |
| **Save** or **Save and Close** is unavailable. | The team is displayed as a child, editing is not allowed, or there are no data changes. | Open the editable team route and change a permitted value before saving. |
| The Members tab is not selected. | The member surface is not open. | Select **Members**. |
| Member actions are unavailable because the team is shown as a child. | Child team displays do not provide member maintenance. | Open the editable team record. |
| Member actions are unavailable because the team is not saved. | Member maintenance requires a saved team. | Save the team first. |
| **Booking target** is unavailable. | The department is not `SalesTeam`. | Review the department shown on the team record. |
| **Last Modifications** is unavailable. | The team has no id, or the history tab is not available for the current display. | Save the team first, then review the history surface. |

## What to do next

After finding or maintaining a team, continue with the administration surface for the
next task:

| Next need | Continue with |
|---|---|
| Add a person who does not yet have a user record | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) |
| Review or maintain user records | [Users](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) |
| Maintain permissions and access roles | [Roles](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/roles) |
| Maintain targets related to team booking | [Targets and budgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-booking-target) |
| Review account-manager administration | [Account managers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-account-managers-view) |
