Адресные книги¶

Адресные книги — именованные наборы адресов и тегов с раздельным доступом. Одна и та же страница управляет как личной книгой пользователя, так и общими книгами, к которым выдан доступ отдельным пользователям

Важно

Пользователь видит свою личную книгу, общие книги, к которым ему выдан доступ, а также книги, которыми он владеет
Руководитель подразделения дополнительно видит общие книги своего подразделения
Суперпользователь имеет доступ ко всем адресным книгам

Как это работает¶

Адресная книга — это контейнер, в котором хранятся записи об устройствах (адреса) и теги для их классификации. Теги принадлежат книге: один и тот же тег в разных книгах — это разные теги. При удалении тега сами адреса не удаляются — снимается только его привязка к ним

Примечание

Одно устройство может присутствовать в книге только один раз, но одно и то же устройство можно добавить в несколько разных книг

Книги делятся на два типа:

Личная — создаётся автоматически для каждого пользователя в единственном экземпляре при создании учётной записи. Её владельцем всегда является сам пользователь, а удалить её может только суперпользователь. Именно с личной книгой работает клиентское приложение RuDesktop
Общая — создаётся вручную на странице «Адресные книги» (при наличии права Адресная книга → Создание) или автоматически при создании подразделения. Книга подразделения создаётся без явного владельца, и управляет ею руководитель этого подразделения. Общую книгу можно поделиться с пользователями и удалить

Доступ к общей книге выдаётся отдельным пользователям на одном из трёх уровней:

Просмотр — просматривать адреса и теги книги и подключаться к устройствам
Изменение — дополнительно добавлять, редактировать и удалять адреса и теги
Управление — дополнительно редактировать книгу, управлять доступом, включать/выключать и удалять книгу

Важно

Владелец книги, руководитель подразделения (для книг своего подразделения) и суперпользователь всегда имеют уровень Управление

Каждая книга может быть включена или выключена. Если книга выключена, её содержимое (адреса и теги) скрывается от пользователей, а сама книга остаётся видимой владельцу, чтобы её можно было включить обратно

Важно

При удалении устройства на странице Устройства связанные с ним адреса автоматически удаляются из всех книг
При удалении пользователя удаляются все общие книги, которыми он владеет, вместе с их содержимым; книги подразделений создаются без владельца и удаление пользователя переживают
При удалении подразделения его общая книга не удаляется, а теряет привязку к подразделению
При удалении книги удаляются все входящие в неё адреса, теги и выданные доступы

Описание страницы¶

На странице «Адресные книги» отображено:

Кнопка Добавить адресную книгу
Фильтр
Массовые действия
Таблица с возможностью настройки отображаемых столбцов

1. Добавление книги¶

При нажатии на кнопку Добавить адресную книгу откроется страница создания книги. Созданная таким образом книга является общей, и вы автоматически получаете к ней уровень доступа Управление

Содержит поля:

Название* — необходимо ввести название книги
Включена — состояние книги (по умолчанию включена)
Описание — произвольное описание книги
Подразделение — привязка книги к подразделению (поле доступно при наличии права Подразделения → Просмотр; выбрать можно только подразделения, которыми управляет пользователь)

Для создания книги нужно нажать на кнопку Сохранить или Сохранить и продолжить

2. Фильтр¶

Можно формировать таблицу для получения определенных данных, используя фильтр:

Личная книга — фильтрация книг по типу (личная / общая)
Включена — фильтрация книг по состоянию (включена / выключена)
Подразделение — фильтрация книг по подразделению (доступно суперпользователю и руководителю подразделения)
Поле поиска — поиск по названию, описанию книги, а также по имени и e-mail владельца

Для выполнения поиска необходимо заполнить поля или часть полей и нажать на кнопку Найти

3. Массовые действия¶

Доступные действия:

Включить / выключить адресные книги — массовое изменение состояния выбранных книг

Удалить выбранные адресные книги — удаляет выбранные книги (личные книги пропускаются)

Важно

В зависимости от прав действия могут отсутствовать

Для выполнения действия необходимо нажать на кнопку Выполнить

4. Таблица¶

Таблица разбита по столбцам:

Название — название книги

Включена — состояние книги

Тип — тип книги: Личная или Общая

Подразделение — подразделение, к которому привязана книга

Адреса — количество адресов в книге; ссылка открывает Адреса, отфильтрованные по этой книге

Доступы — количество выданных доступов; ссылка открывает вкладку доступа в свойствах книги

Владелец — владелец книги

Операции¶

При нажатии на кнопку с правого края таблицы открывается контекстное меню

Доступные действия:

Редактировать — при выборе этого пункта откроются свойства книги

Удалить — при выборе этого пункта книга будет удалена (недоступно для личной книги; удалить личную книгу может только суперпользователь)

История изменений — при выборе этого пункта будет отображена история книги: создание/редактирование и пользователь, который выполнил данные операции

Примечание

Операции Редактировать и Удалить доступны только при наличии уровня доступа Управление

Свойства книги¶

При нажатии на кнопку Редактировать откроется страница свойств книги, состоящая из нескольких вкладок

Основная информация¶

Название — название книги
Включена — состояние книги
Описание — описание книги
Подразделение — подразделение книги (поле доступно при наличии права Подразделения → Просмотр; для личной книги недоступно)

Адреса¶

Вкладка отображает адреса, входящие в книгу, и позволяет управлять ими:

Поле поиска — поиск адресов внутри книги
Кнопка Добавить адрес — открывает страницу добавления адреса с уже выбранной текущей книгой
Кнопка Очистить адресную книгу — удаляет все адреса из книги
Таблица адресов со столбцами Адрес, Теги и Удалить

Примечание

Управление адресами на вкладке «Адреса» доступно при уровне доступа Управление; пользователи с уровнем Изменение редактируют адреса на странице Адреса

Доступ к адресной книге¶

Вкладка служит для выдачи и отзыва доступа к книге. Доступна только для общих книг и только при наличии уровня доступа Управление

Для добавления доступа необходимо нажать на кнопку Добавить ещё доступ и заполнить строку:

Пользователь — пользователь, которому выдаётся доступ
Право — уровень доступа: Просмотр, Изменение или Управление
Выдал — пользователь, выдавший доступ (заполняется автоматически)
Дата — дата выдачи доступа (заполняется автоматически)

Важно

Нельзя выдать доступ одному и тому же пользователю дважды в пределах одной книги

Владелец¶

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

Владелец — владелец книги

Меню действий¶

Меню действий расположено на всех вкладках страницы редактирования и имеет следующие возможности:

Сохранить — производит сохранение внесенных изменений и перенаправляет на страницу «Адресные книги»

Сохранить и продолжить — производит сохранение внесенных изменений и позволяет остаться на странице редактирования

Удалить — производит удаление книги (недоступно для личной книги; удалить личную книгу может только суперпользователь)

История изменений — отображает все изменения, выполненные для этой книги