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

Користувачі

1. Опис

Призначений для створення користувачів.

Містить інформацію про всіх користувачів у домені.

Сторінка "Користувачі" складається з таких частин:

  1. Інструмент створення (Рис. 1.(1));

  2. Поле пошуку (Рис. 1.(2));

  3. Інструмент імпорту файлу CSV (Рис. 1.(3));

  4. Інструмент оновлення реєстру записів (Рис. 1.(4));

  5. Реєстр записів (Рис. 1.(5));

  6. Пагінація (Рис. 1.(6)).

Сторінка Користувачі.png
Рис. 1. Сторінка "Користувачі"

1.1. Інструмент створення

Для створення нового об'єкта служить кнопка "Додати" (Рис. 1.(1)), після натискання на яку відкривається доступ до деталей. Відкрити доступ до деталей до вже створеного користувача можна за допомогою інструмента редагування запису (див. пункт 1.5.7).

Деталі:

1.2. Поле пошуку

Пошук здійснюється по колонці "Ім'я"

Складається з поля введення та кнопки закриття ( image2024-1-25_1-6-25.png ), яка відображається, коли в поле введення введено дані.

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

1.3. Інструмент імпорту файлу CSV

Щоб завантажити користувачів із файлу CSV, скористайтеся кнопкою імпорту файлу CSV (Рис. 1.(3)). Під час наведення курсора на цю кнопку відображається напис "Завантажити". При натисканні на кнопку image-2023-7-12_17-51-39.png з'явиться вікно вибору файлу.

Виберіть потрібний файл та натисніть кнопку "Відкрити" (залежно від ОС вікно вибору файлу може відрізнятися) (Рис. 2).

При збереженні переконайтеся, що "CSV-файл" встановлено як тип файлу.

Вибір файлу для імпорту.png

Рис. 2. Вибір файлу для імпорту

Відкривається модальне вікно "Імпортувати CSV" (Рис. 3).

У документі для імпорту обов'язково мають бути заголовки!

1.3.1. Модальне вікно "Імпортувати CSV"

Призначений для налаштування імпорту даних.

Складається з таких частин:

  1. Блок налаштування (Рис. 3.(1));

  2. Блок попереднього перегляду (Рис. 3.(2));

  3. Блок вибору (Рис. 3.(3)).

Модальне вікно_Імпортувати CSV.png
Рис. 3. Модальне вікно "Імпортувати CSV”
1.3.1.1. Блок налаштування 

Чекбокс "Згорнути заголовки" дає змогу пропустити заголовки. На цей момент параметр недоступний для змін.

Поле "Char set" служить для вибору кодування. На цей момент параметр недоступний для змін. За замовчуванням використовується "UTF-8".

У полі "Розділювач" вводиться той розділовий знак, який використовується у файлі, який імпортується. За замовчуванням використовується кома.

1.3.1.2. Блок попереднього перегляду

У цьому блоці відображаються назва полів та декілька заповнених рядків із таблиці, що імпортується.

1.3.1.3. Блок вибору

У списках, що випадають, виберіть назви колонок (використані у файлі CSV), дані з яких повинні відповідати параметру, для якого робиться вибір. Наприклад, у списку "username" вибрати "Логін" (Рис. 4).

Приклад вибору.png
Рис. 4. Налаштування імпорту файлу CSV

Складається з полів:

  • username - унікальний логін користувача;

  • name – ім'я користувача;

  • extension – внутрішній номер користувача;

  • email – адреса електронної пошти користувача.

Після налаштування обов'язкових полів кнопка "Зберегти" стає активною. Обов'язкові поля позначаються "*". Після натискання на кнопку "Зберегти" модальне вікно закривається, в реєстрі записів додаються записи з файлу CSV.

1.4. Інструмент оновлення реєстру записів 

Оновлення таблиці реєстру записів виконується натисканням кнопки оновлення - image-20241231-123329.png .

1.5. Реєстр записів

Реєстр є список записів наявних об'єктів цього розділу, кожна з яких складається з набору полів.

Складається з таких частин:

  1. Чекбокс;

  2. Колонка "Ім'я";

  3. Колонка "Статус";

  4. Колонка "Логін";

  5. Колонка "Внутрішній номер";

  6. Колонка "DnD";

  7. Інструмент редагування;

  8. Інструмент видалення.

1.5.1. Чекбокс

Використовується для вибору одного або кількох записів. Після вибору одного або кількох записів з’являється додатковий інструмент видалення біля поля пошуку. Інформація про кількість записів, вибраних для видалення, з’являється при наведенні на цей інструмент. Коли ви натискаєте на нього, з’являється модальне вікно підтвердження. Він містить кнопки "Так", "Ні" та кнопку закриття - image-2023-7-12_22-34-16.png . Натискання кнопки "Так" видаляє записи. Натискання кнопки «Ні» закриває модальне вікно, а записи не видаляються.
Якщо відмітити чекбокс у заголовку, то усі записи на сторінці будуть вибрані.

Модальне вікно Підтвердіть видалення (декілька об'єктів).png

Рис. 5. Підтвердження видалення декількох записів

1.5.2. Колонка "Ім'я"

У цій колонці відображаються імена користувачів.

1.5.3. Колонка "Статус"

У цій колонці відображаються чотири статуси (індикатора) (Рис.6):

  • Web;

  • SIP;

  • Dlg;

  • DnD.

Індикатори відображають два стани:

  • активне — жовтий колір image2021-8-9_9-43-5.png

  • пасивне — сірий колір image2021-8-9_9-43-51.png

За умовчанням відображається пасивний стан.

Колонка Статус.png
Рис. 6. Колонка "Статус"

Web - встановлено з'єднання за протоколом websocket (обмін подіями). Стає активним, коли відкривається з'єднання протоколу websocket - користувач залогінений в Workspace.

SIP – з'єднання з протоколом SIP. Стає активним у таких випадках:

  • Реєстрація пристрою цього користувача за протоколом SIP;

  • Користувач залогінений у Workspace, і в нього встановлено "Пристрій за замовчуванням".

Dlg – стан у розмові. стає активним у момент, коли відбувається дзвінок;

DnD – відображає режим "Не турбувати". Стає активним, коли встановлено цей режим. Встановити його можна в:

  • реєстрі записів користувачів (див. пункт 1.5.6);

  • у Workspace.

1.5.4. Колонка "Логін"

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

1.5.5. Колонка "Внутрішній номер"

У цій колонці відображаються внутрішні номери користувачів.

1.5.6. Колонка "DnD"

За допомогою перемикача в цій колонці можна увімкнути/вимкнути режим "Не турбувати". При включенні (Рис.7(1)) або відключенні (Рис.7(2)) режиму "Не турбувати" в колонці "Статус" індикатор DnD стає активним, або неактивним (Рис.7(3)), відповідно.

DnD Користувачі.png
Рис. 7. DnD

1.5.7. Інструмент редагування

Відкривається натисканням кнопки редагування ( image-20241231-123436.png ), при наведенні курсором на яку відображається інформація з назвою інструмента. Після натискання цієї кнопки відкривається доступ до деталей, в яких можна змінити дані об'єкта.

(див. пункт 2.4)

1.5.8. Інструмент видалення

Використовується для видалення об'єкта із підтвердженням через модальне вікно. Під час наведення на кнопку видалення ( image-20241231-123050.png ) відображається інформація з назвою інструменту. Після натискання кнопки видалення з'являється модальне вікно з підтвердженням. Натискання кнопки "Так" видаляє об'єкт. Натискання кнопки "Ні" закриває модальне вікно, об'єкт не видаляється.

Модальне вікно Підтвердіть видалення.png

Рис. 8. Модальне вікно "Підтвердіть видалення"

1.6. Пагінація

Складається з поля "Записів на сторінці", в якому вказується кількість записів (можливо задати від 1 до 1000) на одну сторінку та кнопок вперед image-20250102-163221.png і назад image-20250102-163241.png для перемикання сторінок.

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

2.1. Створення нового користувача

Ціль

Створити нового користувача

Передумови

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

  2. Доступ до розділу "Користувачі" в Admin;

  3. Дозвіл на створення у розділі "Користувачі".

Сценарій:


  1. Натиснути кнопку "Додати". Відкриється сторінка "Загальне".

  2. Вказати дані.

  3. Натиснути на "Ролі". Відкривається сторінка деталі "Ролі".

  4. Вказати дані.

  5. Натиснути на "Ліцензія". Відкривається сторінка деталі "Ліцензія".

  6. Вказати дані.

  7. Натиснути на "Пристрій". Відкривається сторінка деталі "Пристрій".

  8. Вказати дані.

  9. Натиснути на "Змінні". Відкривається сторінка деталі "Змінні".

  10. Вказати дані.

  11. Натиснути на "Токени". Відкривається сторінка деталі "Токени".

  12. Вказати дані.

  13. Натиснути на "Дозволи". Відкривається сторінка деталі "Дозволи".

  14. Вказати дані.

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

Результат

Відкриється сторінка "Користувачі". Користувача створено.

2.2. Видалення користувача

Ціль

Видалення користувача

Передумови

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

  2. Доступ до розділу "Користувачі" в Admin;

  3. Дозвіл на видалення у розділі "Користувачі";

  4. Наявність щонайменше одного користувача.

Сценарій:


  1. Знайти користувача, якого потрібно видалити.

  2. Натиснути кнопку видалення - image2021-8-16_14-26-39.png . Відкривається модальне вікно для підтвердження видалення.

  3. Натиснути кнопку "Так".

Результат

Модальне вікно закривається. Користувача видалено.

2.3. Видалення кількох користувачів

Ціль

Видалення кількох користувачів

Передумови

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

  2. Доступ до розділу "Користувачі" в Admin;

  3. Дозвіл на видалення у розділі "Користувачі";

  4. Наявність щонайменше двох користувачів.

Сценарій:


  1. Знайти користувачів, яких потрібно видалити. Вибрати їх за допомогою чекбоксу.

  2. Натиснути кнопку видалення вгорі реєстру записів. Відкривається модальне вікно для підтвердження видалення.

  3. Натиснути кнопку "Так".

Результат

Модальне вікно закривається. Користувачів видалено.

2.4. Редагування параметрів користувача

Ціль

Змінити параметри користувача

Передумови

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

  2. Доступ до розділу "Користувачі" в Admin;

  3. Дозвіл на редагування у розділі "Користувачі";

  4. Наявність щонайменше одного користувача.

Сценарій:


  1. Знайти у реєстрі записів користувача, якого потрібно редагувати.

  2. Натисніть кнопку редагування в записі цього користувача. Відкриється сторінка "Загальне".

  3. Відкрити сторінку потрібної деталі.

  4. Внести зміни.

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

Результат

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

2.5. Увімкнення режим DnD (режим "Не турбувати") користувачеві

Ціль

Включити статус DnD

Передумови

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

  2. Доступ до розділу "Користувачі" в Admin;

  3. Дозвіл на редагування у розділі "Користувачі";

  4. Наявність щонайменше одного користувача.

Сценарій:


  1. Знайти користувача, якому потрібно змінити статус.

  2. Перевести перемикач DnD в активне положення шляхом натискання на сам перемикач.

Результат

Індикатор DnD у колонці "Статус" стає активним. Користувач у режим "Не турбувати".

2.6. Додавання користувачів за допомогою імпорту CSV-файлу

Ціль

Додати користувачів за допомогою імпорту CSV файлу

Передумови

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

  2. Доступ до розділу "Користувачі" в Admin;

  3. Дозвіл на створення у розділі "Користувачі";

  4. Наявність CSV-файлу.

Сценарій:


  1. Натиснути кнопку імпорту файлу CSV - image2021-8-9_17-1-12.png . Відкривається вікно, щоб вибрати файл.

  2. Виберіть потрібний файл на пристрої та натисніть кнопку Відкрити (залежно від ОС вікно відкриття файлу може відрізнятися). Відкривається модальне вікно "Імпортувати CSV".

  3. У полі "Розділювач" введіть розділовий знак, який використовується у файлі, який імпортується.

  4. У списках, що випадають, виберіть назви колонок (використані у файлі CSV), дані з яких повинні відповідати параметру, для якого робиться вибір. Наприклад, у списку "username" вибрати "Логін" (Рис.4). Кнопка "Зберегти" стає активною.

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

Результат

Модальне вікно зачиняється. Користувачі з файлу CSV додаються до реєстру записів.