# Shareable content

Configure which company content can be shared between branches, save the settings, and review the
modification history from the same configuration page.

## Shareable content overview

Shareable content is the configuration area for deciding how company content is shared between
branches. **Last Modifications** is the history area for those changes.

Open **Shareable content** from the configuration area. Selecting **Last Modifications** changes
the visible tab only and keeps you on the Shareable content page.

| If you need to… | Go to |
|---|---|
| Check access and company conditions | [Before you start](#before-you-start) |
| Open the configuration page | [Open Shareable content](#open-shareable-content) |
| Identify the visible fields and actions | [Understand the screen](#understand-the-screen) |
| Choose a sharing mode or review branch choices | [Sharing areas and fields](#sharing-areas-and-fields) |
| Choose branches for a sharing mode | [Handle branch-sharing choices](#handle-branch-sharing-choices) |
| Save the settings | [Save sharing settings](#save-sharing-settings) |
| Review a failed load or save | [When saving does not work](#when-saving-does-not-work) |
| Review saved changes | [Review modifications and continue](#review-modifications-and-continue) |
| Continue from the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |
| Review company branch records | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) |

The subscription-upgrade surface is shown only when the subscription feature is not included.

## Before you start

Shareable-content work depends on the subscription, company context, access permission, and data
available to the page. Confirm the company and its branch data before changing the settings.

| Have or confirm | Why it matters |
|---|---|
| The shareable-content feature is included in the subscription | The main configuration content is available only when the feature is included. |
| The correct company and its company ID | The page loads and saves the sharing model for the company context. |
| Permission to edit the configuration | **Save** and **Save and Close** depend on edit permission. |
| A change to the sharing data | The save controls are available when the data has changed. |
| Shared objects for the company | The shared-object areas appear when a company has at least one shared object. |
| Branch data, when choosing specific branches | The branch choices come from the company's branch records. |

No required marker is shown for the visible sharing fields.

## Open Shareable content

Open **Shareable content** when you need to review or change how company content is shared between
branches.

Prerequisites

- You are signed in with access to the configuration area.
- The subscription and company conditions in [Before you start](#before-you-start) are met.

Steps

1. Open **Shareable content** from the configuration area.
2. Confirm that the page heading is **Shareable content**.

![The Shareable content page with its visible fields and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a466f7039c1e79e3d09519e9c7900952.png)

**Result:** The Shareable content page is open and ready for review or change.

## Understand the screen

The main page presents the visible sharing fields, a loading readout, save actions, and a refresh
control. It shows **Share Accounts/contacts Between Branches** and **Share Projects Between
Branches** without required markers. It also shows `loading..` beneath both visible fields.

| Screen area | What to look for |
|---|---|
| Visible sharing field | **Share Accounts/contacts Between Branches** |
| Visible sharing field | **Share Projects Between Branches** |
| Loading readout | `loading..` beneath each visible sharing field |
| Save action | **Save** |
| Save-and-leave action | **Save and Close** |
| Refresh control | An unlabeled control with the title `Refresh` |
| History area | **Last Modifications** |

Use the visible sharing fields when they appear on your page. Choose **Do Not Sharing**, **All
Branches**, or **Some Branches** when the choice appears in the relevant sharing area. If **Some
Branches** is available, choose branches in the picker.

### Sharing areas and fields

Each sharing area represents one kind of company content whose branch access can be configured. The
three sharing areas are **Share Projects Between Branches**, **Share Accounts/contacts Between
Branches**, and **Share Contacts Between Branches**.

| Sharing area or choice | Meaning in the page configuration |
|---|---|
| **Share Projects Between Branches** | Sharing area for projects between branches. |
| **Share Accounts/contacts Between Branches** | Sharing area for accounts and contacts between branches. |
| **Share Contacts Between Branches** | Sharing area for contacts between branches. |
| **Do Not Sharing** | The object is not shared. |
| **All Branches** | The object is shared with all branches. |
| **Some Branches** | The object is shared with selected branches. |
| The branch picker | The selected-branch list used with **Some Branches** when branch data exists. |

The branch picker lists the company's available branches by name. No required rule is shown for
these areas.

### Actions and audit area

**Last Modifications** is the page area for reviewing changes made to the sharing configuration.
Selecting it displays the history area without moving away from the Shareable content page.

The history area includes these readouts:

| Audit-area content | Text or action |
|---|---|
| History tab | **Last Modifications** |
| Explanation | `The audit log provides you with a chronological sequence of actions performed by the users` |
| Creation readout | `Created On: - By` |
| Related readout | `Tickets` |

## Handle branch-sharing choices

Branch sharing lets an object use a broad sharing mode or a selected list of company branches. The
selected-branch path applies when an object uses **Some Branches** and branch data is available.

Prerequisites

- The relevant sharing choice is available on your page.
- The company has branch data when you need to select individual branches.

Steps

1. In the relevant sharing area, select the available sharing mode.
2. Select **Some Branches** when you need to share the object with selected branches.
3. In the branch picker, add the branches to share.
4. Remove a branch from the selected list when it should no longer receive the shared object.
5. Review the selected branch names before saving.

The account-sharing choice affects related contact choices: selecting some branches for an account
can disable the all-branch and some-branch choices for the related contact object. Selecting no
branch can disable both of those contact choices. The available branch records and the way those
choices are enabled depend on the company data.

**Result:** The sharing area contains the selected sharing mode and, when applicable, the selected
company branches ready for saving.

## Save sharing settings

The page loads the company sharing model before you edit it, then sends the changed model when you
save. **Save** and **Save and Close** are available when the feature is included, edit permission is
granted, and the sharing data has changed.

Prerequisites

- The Shareable content page is open.
- You have edit permission.
- The subscription includes the feature.
- The sharing data has changed.

Steps

1. Select the save action that matches your next task.

   | If you need to… | Select |
   |---|---|
   | Keep the page open | **Save** |
   | Leave after saving | **Save and Close** |

2. Confirm the message `Your request was completed successfully`.
3. If you selected **Save**, select **Last Modifications**.
4. If you selected **Save**, review the refreshed modification history.

![The Last Modifications area with the audit-log text and visible readouts](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a466f7039c1e79e3d09519e9c7900952.png)

**Result:** The changed sharing settings are saved. With **Save**, the page remains open and the
history area is refreshed. With **Save and Close**, the page leaves through the available
save-and-close action after success.

## When saving does not work

The page uses the same error message for a failed load or save request. Use the message to identify
that the request did not complete, then check whether the subscription includes the feature and
whether you have edit permission.

| What you see | What it means | What to do |
|---|---|---|
| `An error occurred while processing your request` while the page loads | The load request did not complete. | Check the company context and company ID, then reload the page. |
| `An error occurred while processing your request` after selecting **Save** or **Save and Close** | The save request did not complete. | Check edit permission and the company context before trying again. |
| The save controls are unavailable | Save availability depends on edit permission and changed data. | Confirm that you have edit permission and that the sharing data has changed. |
| The main configuration content is unavailable | The subscription feature is not included. | Use the subscription surface for the available subscription action. |

### Out of scope

The following surfaces are not part of the sharing task on this page:

| Surface | Where it belongs |
|---|---|
| Upload, import, generic confirmation, generic alert, and generic popup controls | Shared popup functions rather than the Shareable content task |
| Subscription-upgrade **Back** action | The subscription-upgrade surface shown when the feature is not included |

## Review modifications and continue

After a successful save, review **Last Modifications** to confirm that the history area has refreshed.
Selecting it changes the visible tab only.

Prerequisites

- You have saved the sharing settings or opened the page to review its history.

Steps

1. Select **Last Modifications**.
2. Review the visible audit-log text and readouts.
3. Continue from the configuration area when you are ready for the next configuration task.

**Result:** The saved modification history is available, and you remain in the Shareable content
configuration area for your next navigation.
