Webitel: Документація

Загальне (Політики збереження файлів)

1. Опис

Призначена для зазначення загальної інформації про політику.

Складається з (Рис. 1):

  1. Поля “Ім'я";

  2. Поля “Опис”;

  3. Перемикача “Стан”;

  4. Перемикача “Шифрувати файли”;

  5. Поля “Канали”;

  6. Поля “MIME типи”;

  7. Поля “Кількість днів зберігання”;

  8. Поля “Максимальна швидкість завантаження (kbps)”;

  9. Поля “Максимальна швидкість вивантаження (kbps)”;

  10. Поля “Максимальний розмір файлу (bytes)”.

Політики збереження файлів.png
Рис. 1. Сторінка деталі “Загальне”

1.1. Поле “Ім'я”

У цьому полі вказується ім'я політики.

1.2. Поле “Опис”

Опис політики, що надає додатковий контекст.

1.3. Перемикач “Стан”

Статус політики, який визначає, чи є політика активною. Для цього використовуються перемикач - включена image-20250418-121804.png та вимкнена image-20250418-121829.png . За замовчуванням політика включена.

Важливо! Вимкнення політики не скасовує вже заплановане автоматичне видалення файлів. Детальна логіка застосування та перерахунку дат видалення описана в розділі 2.“Застосування політики до наявних файлів”.

1.4. Перемикач “Шифрувати файли“

Перемикач, який визначає, чи будуть файли шифруватися, що зберігаються відповідно до політики.

Якщо опція активована – image-20250418-121804.png , усі завантажені файли (крім типу "медіа" та "чат") зберігаються в зашифрованому вигляді.

1.5. Поле “Канали”

Канали, до яких буде застосовуватися ця політика. Адміністратор може вибрати з переліку доступних каналів (чат, лист, дзвінок, лог, медіа, запис екрана).

1.6. Поле “MIME типи”

Типи файлів, які будуть збережені за цією політикою.

Користувач може:

  • вибрати MIME типи з типового переліку;

  • додати власні MIME типи вручну.

Усі вибрані значення відображаються у вигляді чіпів з можливістю видалення.

Важливо! Якщо користувач у чаті намагається завантажити файл, що не відповідає визначеним MIME типам, система надсилає повідомлення про заборонений або некоректний формат файлу (див. пункт 1.5. Повідомлення про заборонений формат файлу в документації Шаблони (Telegram)).

1.6.1. Типові MIME типи

Система містить попередньо підготовлений перелік найпоширеніших MIME типів. Користувач може вибрати один або декілька типів з цього переліку:

Зображення

Формат

MIME-type

JPEG

image/jpeg

PNG

image/png

GIF

image/gif

SVG

image/svg+xml

WebP

image/webp

Відео

Формат

MIME-type

MP4

video/mp4

WebM

video/webm

MPEG

video/mpeg

Аудіо

Формат

MIME-type

MP3

audio/mpeg

WAV

audio/wav

Документи

Формат

MIME-type

PDF

application/pdf

MS Word (.doc)

application/msword

Word (.docx)

application/vnd.openxmlformats-officedocument.wordprocessingml.document

Типові MIME типи можуть бути комбіновані з користувацькими значеннями.

1.6.2. Типові політики та поведінка для існуючих користувачів

Для користувачів, у яких уже є створені політики, система автоматично додає три типові політики у розділ Політики збереження файлів“:

Політика 1: media_storage

Поле

Значення

Назва

media_storage

MIME типи

image/jpeg, image/png, video/mp4, audio/mpeg, audio/wav

Кількість днів зберігання

365

Максимальна швидкість завантаження (kbps)

2048

Максимальна швидкість вивантаження (kbps)

1024

Максимальний розмір файлу (bytes)

52428800

Канали

чат

Політика 2: email_attachment

Поле

Значення

Назва

email_attachment

MIME типи

application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, image/*

Кількість днів зберігання

365

Максимальна швидкість завантаження (kbps)

1024

Максимальна швидкість вивантаження (kbps)

512

Максимальний розмір файлу (bytes)

10485760

Канали

лист

Політика 3: call_recordings

Поле

Значення

Назва

call_recordings

MIME типи

audio/mpeg, audio/wav

Кількість днів зберігання

365

Максимальна швидкість завантаження (kbps)

1024

Максимальна швидкість вивантаження (kbps)

512

Максимальний розмір файлу (bytes)

20971520

Канали

дзвінок

Типовий перелік MIME типів одразу доступний у полі “MIME типи” та може бути використаний під час налаштування політик.

Типові політики додаються у вимкненому стані, не є обов’язковими для використання, можуть редагуватися або видалятися користувачем і не впливають на чинні налаштування, доки користувач самостійно не ввімкне одну з них.

1.7. Поле “Кількість днів зберігання”

Кількість днів, протягом яких файли будуть зберігатися, перш ніж вони будуть автоматично видалені.

Дата автоматичного видалення файлу розраховується як дата створення файлу + значення поля “Кількість днів зберігання”.

Розрахована дата зберігається для кожного файлу окремо.

1.8. Поле “Максимальна швидкість завантаження (kbps)”

Максимальна швидкість завантаження файлів у кілобітах за секунду, яка буде застосовуватись до файлів під цією політикою. Якщо значення дорівнює 0, швидкість не обмежується.

1.9. Поле “Максимальна швидкість вивантаження (kbps)”

Максимальна швидкість вивантаження файлів у кілобітах за секунду, яка буде застосовуватись до файлів під цією політикою. Якщо значення дорівнює 0, швидкість не обмежується.

1.10. Поле “Максимальний розмір файлу (bytes)”

Максимальний допустимий розмір файлу для завантаження в байтах. Якщо значення дорівнює 0, обмеження на розмір файлу не встановлено.

2. Застосування політики до наявних файлів

Після створення політики можна застосувати її до наявних файлів. Для цього є кнопка "Застосувати" (Рис. 2)

Застосувати термін зберігання до наявних файлів.png
Рис. 2. Кнопка "Застосувати”

Натискання на неї відкриває модальне вікно (Рис. 3), в якому є дві кнопки:

  • “Oк” – застосовує нову політику до наявних файлів.

  • “Відмінити“ – закриває модальне вікно без змін.

Після натискання на кнопку “Ок“ система перераховує та оновлює дату автоматичного видалення для кожного наявного файлу відповідно до поточного значення поля “Кількість днів зберігання”.

Модальне вікно підтвердження.png
Рис. 3. Модальне вікно для застосування політики до наявних файлів

Зміни вступають у силу через 30 секунд після підтвердження.

3. Можливості

3.1. Змінити або задати параметри

Ціль

Змінити або задати параметри

Передумови

  1. Доступ до застосунку "Admin";

  2. Доступ до розділу "Політики збереження файлів" в Admin;

  3. Дозвіл на створення і редагування у розділі "Політики збереження файлів";

  4. Наявність щонайменше однієї політики, або створення нової.

Сценарій:

 

  1. Натисніть поле, яке потрібно змінити.

  2. Ввести потрібні зміни (для "Ім'я" дані мають бути унікальні).

  3. Натиснути кнопку "Зберегти".

Результат

Дані збережені.