1. Описание

Предназначена для добавления номеров телефонов абонентов в список.

Состоит из таких элементов:

1. Поле поиска (Рис1 (1));
2. Инструмент импорта CSV-файла (Рис.1 (2));
3. Инструмент добавления (Рис.1 (3));
4. Инструмент обновления списка реестра (Рис.1 (4));
5. Реестр записей (Рис.1 (5));
6. Пагинация (Рис.1 (6)).

Рис. 1. Страница детали "Номера"

1.1. Поле поиска

Поиск производится по колонке "Номер".

Состоит из поля ввода и кнопки закрытия (), которая отображается, когда в поле ввода установлен курсор.  Для поиска по части слова, или номера, используется символ "*". Можно использовать символ "*" и для замены любого количества символов.

1.2. Инструмент импорта CSV-файла

Для загрузки номеров телефона из файла CSV используется кнопка импорт файла CSV - . При наведении курсора на эту кнопку отображается надпись "Загрузить". При нажатии на кнопку () открывается окно выбора файла.

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

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

Открывается модальное окно "Импортировать CSV" (Рис.3).

1.2.1. Модальное окно "Импортировать CSV"

Предназначено для настройки импорта данных.

Состоит из таких элементов:

1. Блок настройки (Рис.3 (1));
2. Блок предпросмотра (Рис.3 (2));
3. Блок выбора (Рис.3 (3)).

Рис. 3. Модальное окно "Импортировать CSV"

1.2.1.1. Блок настройки

Чекбокс "Свернуть заголовки" дает возможность пропустить заголовки. На данный момент параметр недоступен для изменений. 

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

В поле "Разделитель" введите тот знак препинания, который используется в импортированном  файле. По умолчанию, используется ",".

1.2.1.2. Блок предпросмотра

В этом блоке отображаются название полей и несколько заполненных строк из таблицы, которая импортируется.

1.2.1.3. Блок выбора

В выпадающих списках выберите названия колонок (использованные в файле CSV). Данные из колонок должны соответствовать параметру, для которого делается выбор. К примеру, в выпадающем списке "number" выбрать "Номер" (Рис.4) 

Рис. 4. Настройка импорта файла CSV

Состоит из полей:

• number - номер телефона абонента или другие контактные данные абонента, к примеру, e-mail;
• description - имя абонента или другое описание, которое будет целесообразно;
• expireAt - дата и время до которого данный номер будет в этом списке, задается в формате Unix Timestamp. Если оставить пустым, то номер из списка автоматически удалятся не будет.

Для удобства колонки файла CSV (Рис.5) могут совпадать с полями для заполнения при импорте файла.

Рис. 5. Файл CSV

После настройки обязательных полей кнопка "Сохранить" становится активной. Обязательные поля обозначаются "*". После нажатия на кнопку "Сохранить" модальное окно закрывается, в реестре записей добавляются записи из CSV-файла.

1.3. Инструмент добавления

Для добавления нового номера телефона абонента необходимо нажать кнопку добавления - . После нажатия кнопки добавления открывается модальное окно "Новый номер" (Рис.6).

Рис. 6. Модальное окно "Новый номер"

Модальное окно состоит из таких элементов:

1. Поле "Номер";
2. Переключатель "Временный;
3. Поле "Описание";
4. Кнопка "Добавить";
5. Кнопка "Закрыть".

1.3.1. Поле "Номер"

Здесь вводится номера телефона абонента или другие контактные данные абонента, к примеру, e-mail;.

1.3.2. Переключатель "Временный

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

- номер не удаляется автоматически;

- номер удалится из списка в указанное в поле "Срок действия" (Рис.7) дату и время.

Рис. 7. Переключатель "Временный" активный

При нажатии на поле "Срок действия" открывается календарь, в котором выбирается дата и время удаления данного номера.

1.3.3. Поле "Описание"

Здесь вводится имя абонента или другое описание, которое будет целесообразно.

1.3.4. Кнопка "Добавить"

Нажатие на кнопку "Добавить" добавляет указанный номер.

1.3.5. Кнопка "Закрыть"

Нажатие на кнопку "Закрыть" закрывает модальное окно, номер не добавляется.

1.4. Инструмент обновления реестра записей

Обновление таблицы реестра записей выполняется нажатием на кнопку обновления -

1.5. Реестр записей

Реестр представляет собой список записей существующих объектов этого раздела. Каждая запись состоит из набора полей:

1. Чекбокс;
2. Колонка "Номер";
3. Колонка "Описание";
4. Колонка "Срок действия";
5. Инструмент редактирования записи;
6. Инструмент удаления записи.

1.5.1. Чекбокс

Рис. 8. Подтверждение удаления

1.5.2 Колонка "Номер"

Здесь отображаются номера телефонов абонентов.

1.5.3. Колонка "Описание"

Здесь отображается описание — информация, которая была внесена в поле "Описание" при создании записи.

1.5.4. Колонка "Срок действия"

Здесь отображается дата, до которой данный номер буде находиться в списке. Если поле пустое — номер не удаляется.

1.5.5. Инструмент редактирования записи

После нажатия кнопки редактирования  открывается модальное окно "Редактировать номер", в котором можно изменить номер и описание выбранной записи.

1.5.6. Инструмент удаления записи

Рис. 9. Модальное окно подтверждения удаления

1.6. Пагинация

Состоит из поля "Записей на странице", в котором указывается количество записей (возможно задать от 1 до 1000) на одну страницу и кнопок вперед  и назад  для переключения страниц. 

2. Возможности

2.1. Добавление нового номера телефона абонента в список 

2.2. Удаление номера телефона абонента из списка

2.3. Редактирование номера телефона абонента из списка

2.4. Добавление номеров телефона посредством импорта CSV-файла

3. Дополнительные материалы

3.1. Инструкции

3.1.1. Инструкция по добавлению номера абонента в чёрный список