Webitel: Documentation

Storage policies (Integrations)

1. Description

This section is intended for managing file retention policies in the system. Administrators can create, edit, and delete policies by configuring storage rules for different channels and MIME types.

The section interface includes the following elements (Fig. 1):

  • Creation tool (Fig. 1.(1));

  • Search field (Fig. 1.(2));

  • Record registry refresh tool (Fig. 1.(3));

  • Record table (Fig. 1.(4));

  • Pagination panel (Fig. 1.(5)).

Storage Policies Integrations.png
Fig. 1. Start page of the "Storage policies" section

1.1. Creation Tool

To add a new policy, use the "Add" button (Fig. 1.(1)). After clicking, the "General" tab becomes available. To edit an existing record, use the edit tool (see section 1.4.7).

1.2. Search Field

Search is performed in the "Name" column.

The element consists of an input line and a clear button ( image-20241231-141138.png ), which appears when the cursor is placed in the input field. You can use the asterisk * for partial search. This symbol can also replace any number of characters.

1.3. Record Registry Refresh Tool

To refresh the list, click the refresh button — image-20241231-123329.png .

1.4. Record Registry

The registry displays a list of existing records in this section, each consisting of a set of fields.

It includes the following parts:

  1. Checkbox;

  2. "Name" column;

  3. "Channels" column;

  4. "MIME types" column;

  5. "Status" column;

  6. "Retention days" column;

  7. "Max upload speed (kbps)" column;

  8. "Max download speed (kbps)" column;

  9. "Max file size (bytes)" column;

  10. "Description" column;

  11. "Position" column;

  12. Move tool;

  13. Edit tool;

  14. Removal tool.

1.4.1. Checkbox

Used to select one or more entries. An additional removal tool appears next to the search field after selecting one or more entries. Information about the number of entries chosen for deletion appears when you hover over this tool. When you click on it, a modal confirmation window appears.

It contains the Yes, No, and close ( image2024-3-7_15-21-56.png ) buttons.

  • Clicking the Yes button deletes the entries.

  • Clicking the No button closes the modal window, and the entries are not deleted.

All records on the page will be selected if you select the checkbox in the header.

Confirm deletion modal window.png


Fig. 2. Confirmation of multiple record deletion

1.4.2. "Name" Column

Displays the names of the policies.

1.4.3. "Channels" Column

Displays the channels to which the policy is applied.

1.4.4. "MIME Types" Column

Indicates the types of files stored under the policy.

1.4.5. "State" Column

Contains a toggle switch that enables or disables the policy depending on its position:

  • image-20250117-094305.png – policy is enabled;

  • image-20250117-094429.png – policy is disabled.

1.4.6. "Retention Days" Column

Specifies the number of days files are stored before being automatically deleted.

1.4.7. "Max Upload Speed (kbps)" Column

Displays the maximum upload speed in kilobits per second applied to files under the policy. If set to 0, no speed limit is applied.

1.4.8. "Max Download Speed (kbps)" Column

Displays the maximum download speed in kilobits per second applied to files under the policy. If set to 0, no speed limit is applied.

1.4.9. "Max File Size (bytes)" Column

Displays the maximum file size in bytes allowed for upload. If set to 0, no size restriction is applied.

1.4.10. "Description" Column

Displays a description of the policy, providing additional context.

1.4.11. "Position" Column

Shows the sequence number that determines the policy's priority. The lower the value in the "Position" field, the higher the priority. A policy with position 1 has higher priority than a policy with position 2, and so on. The order can be changed manually using the move tool to set application priority.

1.4.12. Move Tool

Clicking and holding the icon image-20250218-145457.png allows dragging records in the registry.

1.4.13. Edit Tool

The General tab opens after clicking on this button. You can change the object's data and go to other tabs for editing.

1.4.14. Removal Tool

It is used to remove an object with confirmation through a modal window. A modal confirmation window appears after clicking the image-20241231-121409.png button. Clicking the Yes button - deletes the object and the entry. Clicking the No button closes the modal window, and the object is not deleted.

Confirm deletion modal window.png

Fig. 3. Confirmation of multiple record deletion

1.5. Pagination

It consists of the Rows per page field, which indicates the number of entries (it is possible to set from 1 to 1000) per page, and forward and backward buttons for switching pages.

2. Features

2.1. Creating a Storage Policy

Goal

Create a new file storage policy

Preconditions

  1. Access to the "Admin" application;

  2. Access to the "Storage Policies" section in Admin;

  3. Permission to create entries in the "Storage Policies" section.

Steps:

 

  1. Click the "Add" button. The "General" detail page will open.

  2. Enter the required data.

  3. Click the "Save" button.

Result

Data is saved.

2.2. Deleting a Storage Policy

Goal

Delete a file storage policy

Preconditions

  1. Access to the "Admin" application;

  2. Access to the "Storage Policies" section in Admin;

  3. Permission to view and delete entries in the "Storage Policies" section;

  4. At least one policy must exist.

Steps:

 

  1. Find the policy to delete.

  2. Click the delete button — 9c370541-2dd8-4e0e-9292-355f502cd97f . A confirmation modal window will open.

  3. Click "Yes".

Result

The modal window closes. The policy is deleted.

2.3. Deleting Multiple Storage Policies

Goal

Delete multiple file storage policies

Preconditions

  1. Access to the "Admin" application;

  2. Access to the "Storage Policies" section in Admin;

  3. Permission to view and delete entries in the "Storage Policies" section;

  4. At least one policy must exist.

Steps:

 

  1. Locate the policies in the registry to delete. Select them using checkboxes.

  2. Click the delete button at the top of the registry. A confirmation modal window will open.

  3. Click "Yes".

Result

The modal window closes. Selected policies are deleted.

2.4. Editing Storage Policy Parameters

Goal

Edit the parameters of a file storage policy

Preconditions

  1. Access to the "Admin" application;

  2. Access to the "Storage Policies" section in Admin;

  3. Permission to view and delete entries in the "Storage Policies" section;

  4. At least one policy must exist.

Steps:

 

  1. Find the policy to edit in the registry.

  2. Click the edit button in the record row. The "General" page opens.

  3. Make the necessary changes.

  4. Click "Save".

Result

Data is saved.

2.5. Enabling a Storage Policy

Goal

Enable a file storage policy

Preconditions

  1. Access to the "Admin" application;

  2. Access to the "Storage Policies" section in Admin;

  3. Permission to view and delete entries in the "Storage Policies" section;

  4. At least one policy must exist.

Steps:

 

  1. Find the policy whose status needs to be changed.

  2. Switch the "State" toggle to active by clicking it.

Result

The policy is enabled.