Help:UI manual

From Svacer Wiki
Jump to navigation Jump to search

На этой странице приведена инструкция по работе в пользовательском интерфейсе сервера Svacer.

Авторизация в пользовательском интерфейсе сервера Svacer

Для авторизации в пользовательском интерфейсе сервера Svacer введите логин и пароль на странице ввода учётных данных. Учётные данные по умолчанию — admin / admin.

AutorizationMain
Страница ввода учетных данных

Если на сервере настроена поддержка протокола LDAP, то войти можно с помощью внешних серверов. Для этого:

  1. На странице ввода учетных данных перейдите на вкладку LDAP.
  2. Выберите LDAP-сервер в списке, если настроено больше одного сервера авторизации.
  3. Введите логин и пароль.
AutorizationLDAP
Страница входа по протоколу LDAP

После успешного входа отобразится пользовательский интерфейс сервера Svacer. При этом, если в прошлой сессии пользователь выбрал проект, его ветку и снимок или применил фильтры, отобразятся эти проект, ветка и фильтры.

Примечание: чтобы после обновления системы в пользовательском веб-интерфейсе корректно отображались изменения, после авторизации обновите страницу в браузере – нажмите клавишу F5.

Описание основных элементов пользовательского интерфейса

Все страницы пользовательского интерфейса сервера Svacer устроены единообразно и состоят из двух частей:

  1. Верхняя панель – отображается на всех страницах пользовательского интерфейса
    Содержит:
  2. Рабочая область – область экрана для просмотра информации и ввода, которая соответствует выбранному режиму работы или странице настроек.

Базовые функции системы

Просмотр уведомлений

Чтобы посмотреть уведомления, нажмите кнопку в правом верхнем углу экрана.

В правой части экрана отобразится панель со списком уведомлений для авторизованного пользователя:

NotificationList
Панель уведомлений

Нажмите кнопку для удаления уведомления.

Нажмите кнопку Очистить для удаления всех уведомлений.

Настройка профиля пользователя

Для перехода в профиль выберите пункт Профиль в меню пользователя в правом верхнем углу экрана:

UserMenu
Меню пользователя. Переход к настройке профиля

В правой части экрана отобразится панель Профиль, которая состоит из трех разделов:

1. Профиль пользователя – в этом разделе можно изменить атрибуты своего профиля (ФИО, контакты), кроме логина, а также поменять пароль.
ProfileSetting
Настройки профиля пользователя
2. Общие настройки интерфейса – в этом разделе можно включить или выключить следующие функции:
Эти настройки сохраняются для учетной записи пользователя и не сбрасываются при новой сессии.
UserInterfaceSettings
Общие настройки интерфейса
3. Настройки панели навигации – в этом разделе можно настроить отображение по умолчанию для детекторов и файлов на панели навигации, а также для сортировки значений на вкладке Файлы.
Эти настройки сохраняются для учетной записи пользователя и не сбрасываются при новой сессии.
Временное отображение файлов на панели навигации и их сортировку можно настроить по нажатии иконки на панели навигации.
LeftNavigationPanelSettings
Настройки панели навигации

Изменение пароля

Для изменения пароля:

1. Выберите пункт Профиль в меню пользователя.
2. В разделе Профиль пользователя нажмите на ссылку Изменить пароль:
Переход к изменению пароля в профиле пользователя
3. В открывшемся окне:
а) Введите текущий пароль.
б) Дважды введите новый пароль.
в) Нажмите кнопку Изменить.
Окно изменения пароля

Просмотр информации о программе

Чтобы посмотреть информацию о программе, выберите пункт О программе в меню пользователя в правом верхнем углу экрана.

Меню пользователя. Переход к просмотру информации о программе

Нажмите на ссылку в строке Документация для перехода на страницу документации к системе.

Для просмотра информации об изменениях нажмите кнопку Показать Журнал изменений.

Информация о программе

Выбор контекста (проекта, ветки и снимка)

Для работы в режиме разметки или режиме просмотра кода требуется выбрать проект, ветку и снимок с результатами работы анализатора Svace, а в режиме формирования отчетов – проект и ветку. Это можно сделать в блоке, который расположен под верхней панелью.

По умолчанию после выбора проекта автоматически выбирается ветка master и последний импортированный снимок. Если master отсутствует, то эту ветку нужно выбрать вручную.

Работа в режиме разметки

Режим разметки предоставляет следующий набор элементов управления:

  1. Левая навигационная панель:
  2. Центральная панель:
  3. Правая панель.
Режим разметки. Набор элементов управления

Функции левой навигационной панели

Вкладка «Детекторы»

На этой вкладке отображается список детекторов Svace, которые сработали в выбранном снимке.

Серьезность (критичность) детектора обозначена цветом:

  • красный – наивысшая серьезность (CRITICAL);
  • желтый – высокая серьезность (MAJOR);
  • белый – обычная серьезность (NORMAL, MINOR, UNDEFINED).

На вкладке Детекторы пользователю доступны следующие функции:

1. Отображение данных в виде списка – для этого нажмите кнопку .
2. Группировка детекторов по уровням серьезности (по умолчанию) – для этого нажмите кнопку .


3. Отображение списка маркеров в файлах, в которых сработал детектор – для этого нажмите кнопку в левой части его имени.
Список маркеров, найденных детектором
4. Блокировка всех маркеров, найденных детектором, для разметки другими пользователями – для этого нажмите кнопку справа от названия детектора (отображается при наведении курсора).
5. Применение фильтра по детектору в таблице маркеров – для этого нажмите на имя детектора.
6. Применение фильтра по серьезности в таблице маркеров – для этого нажмите название группы серьезности.
7. Отмена фильтрации – для этого нажмите кнопку .
8. Отображение на вкладке исходного кода содержимого файла, места и содержания маркера, а также подробной информации о маркере на правой панели – для этого нажмите на маркер.
9. Просмотр фрагмента кода в режиме предпросмотра – для этого нажмите кнопку .

Вкладка «Файлы»

На этой вкладке отображается список файлов, в которых найдены маркеры.

Вкладка Файлы

Для каждого файла отображаются:

  • имя;
  • количество найденных маркеров (предупреждений);
  • количество размеченных маркеров;
  • кнопки и .

На вкладке Файлы пользователю доступны следующие функции:

1. Применение фильтра по файлу в таблице маркеров – для этого:
а) Нажмите на имя файла. В этом случае содержимое файла отобразится на вкладке с исходным кодом
или
б) Нажмите кнопку в одной или нескольких строках. В этом случае содержимое файла (файлов) не отобразится.
2. Исключение файла из фильтра по файлам в таблице маркеров – для этого нажмите кнопку в строке файла.
3. Отмена фильтрации в таблице маркеров для всех выбранных файлов – для этого нажмите кнопку или кнопку на вкладке Детекторы.
4. Блокировка всех маркеров в файле для разметки другими пользователями – для этого нажмите кнопку справа от названия файла (отображается при наведении курсора).
5. Отображение на вкладке с исходным кодом содержимого файла, места и содержания маркера, а также подробной информации о маркере на правой панели – для этого нажмите на имя файла.
6. Фильтрация по имени/пути файла в поле Отфильтровать файлы по полному пути. Поддерживается фильтрация с использованием регулярных выражений.
7. Временная настройка отображения файлов и сортировки полей на вкладке Файлы – для этого нажмите кнопку и поменяйте настройки.
Эти настройки будут действовать до конца сессии пользователя или до повторного изменения.
Временная настройка отображения файлов и сортировки полей

Функции центральной панели

Вкладка «Информация о снимке»

На этой вкладке отображается информация о выбранном снимке.

Вкладка Информация о снимке


На вкладке Информация о снимке пользователю доступны следующие функции:

  1. Просмотр подробной информации о снимке во всплывающем окне – для этого нажмите кнопку .
  2. Переход к экспорту кода с разметкой – для этого нажмите кнопку .
  3. Экспорт снимка в формате .snap – для этого нажмите кнопку .
  4. Просмотр параметров анализа во всплывающем окне – для этого нажмите кнопку в строке Параметры анализа.
  5. Экспорт параметров анализа в формате .txt – для этого нажмите кнопку в строке Параметры анализа.
  6. Просмотр таблицы статистики – для этого нажмите кнопку в строке Статистика. Информация в таблице сгруппирована по параметрам детекторов, найденным маркерам и статусу их разметки.
  7. Просмотр списка приложенных файлов для этого нажмите кнопку в строке Приложенные файлы. Для скрытия списка нажмите кнопку .

Вкладка с исходным кодом

Вкладка открывается только после выбора файла на вкладке Детекторы или Файлы, а также в таблице маркеров. Одновременно может быть открыто несколько вкладок с исходным кодом, если выключена настройка Переиспользование вкладки в редакторе кода.

В верхней части вкладки отображается полный путь к файлу.

Пример двух открытых вкладок с исходным кодом

На вкладке с исходным кодом пользователю доступны следующие функции:

1. Отображение кода на весь экран – для этого нажмите кнопку .
2. Отображение всех маркеров – для этого нажмите кнопку .
3. Скрытие всех маркеров – для этого нажмите кнопку .
4. Отображение списка маркеров в этом файле – для этого нажмите кнопку .
Cписок маркеров в файле
5. Выбор отображения информации о маркере и его разметки относительно строки кода, в которой он найден:
  • выше строки кода (по умолчанию) – нажмите кнопку ;
  • ниже строки кода – нажмите кнопку .


6. Возврат к исходному маркеру (например, если был выбран другой связанный маркер на вкладке Трасса правой панели) – для этого нажмите кнопку в верхней части блока с информацией о маркере.
7. Разметка маркера – установите Статус, Серьезность и Действия в верхней части блока с информацией о маркере.
8. Отображение блока информации об элементе трассы для строки кода – нажмите кнопку К трассе.
Для последовательного перехода к другим элементам трассы воспользуйтесь кнопками и .
Блок информации о элементе трассы
9. Переход к строке, в которой объявлена/определена переменная – нажмите правую кнопку мыши на строке исходного кода и выберите пункт Перейти к объявлению / Перейти к определению.
10. Просмотр ссылок на панели внизу экрана – нажмите правую кнопку мыши на строке исходного кода и выберите пункт Найти ссылки. На этой панели отображается иерархический список файлов с номерами строк, в которых найдены ссылки:
Cписок файлов с номерами строк, в которых найдены ссылки
  • Чтобы перейти к строке кода, на которую найдена ссылка, нажмите на ссылку с номером строки на панели [1].
  • Чтобы посмотреть фрагмента кода, на который найдена ссылка, в режиме предпросмотра, нажмите кнопку [2].
11. Переход к просмотру выбранного файла в режиме просмотра кода – нажмите правую кнопку мыши на строке исходного кода и выберите пункт Открыть в режиме код.
12. Копирование строки кода – нажмите правую кнопку мыши на строке исходного кода и выберите пункт Copy.
13. Вызов командной строки – нажмите правую кнопку мыши на строке исходного кода и выберите пункт Command Palette.
Командная строка

Таблица маркеров

Для раскрытия таблицы маркеров нажмите кнопку в верхней части центральной панели, а для её скрытия – . В верхней части таблицы находится панель, которая содержит:

Таблица маркеров с примененными фильтрами

В таблице маркеров пользователю доступны следующие функции:

  1. Выбор маркеров для групповой разметки – для этого установите флажок в строке маркера.
  2. Просмотр подробной информации о маркере в правой панели и его места и содержания на вкладке с исходным кодом – для этого дважды кликните на строку маркера или нажмите на имя файла в столбце Файл. Также для выбора можно использовать клавиши ↑ и ↓ – для перемещения по строкам, и Enter – для подтверждения выбора.
  3. Копирование детальной информации о маркере в буфер обмена – для этого нажмите правой кнопкой мыши на маркер и выберите пункт Копировать.
  4. Копирование ссылки на маркер в буфер обмена – для этого нажмите правой кнопкой мыши на маркер и выберите пункт Копировать ссылку на маркер.
  5. Переход к сравнению одного маркера с другим – для этого нажмите правой кнопкой мыши на маркер и выберите пункт Сравнить с ...

Функции правой панели

Эта панель предоставляет подробную информацию о маркере и его разметке:

Правая панель

На правой панели пользователю доступны следующие функции:

1. Копирование ссылки на маркер – для этого нажмите кнопку .
2. Блокировка маркера для разметки другими пользователями – для этого нажмите кнопку в верхней части правой панели.
3. Разметка маркера – для этого установите Статус, Серьезность и Действие в верхней части правой панели.
4. Просмотр истории разметки со связанными комментариями – для этого нажмите кнопку в верхней части правой панели.
Пример истории изменения разметки маркера
5. Отображение маркера на вкладке с исходным кодом одним из двух способов:
а) Нажмите кнопку с именем файла и номером строки в верхней части правой панели [1].
б) Нажмите кнопку Найти в коде на вкладке Подробности [2]. Это позволяет всегда вернуться к нужной точке при навигации по коду.
Правая панель. Способы перехода к маркеру на вкладке с исходным кодом
6. Переход к блоку с информацией об элементе трассы – для этого нажмите на ссылку с именем файла и номером строки на вкладке Трасса [1].
7. Отображение кода, который соответствует строке трассы, в отдельном окне в режиме предпросмотра – для этого на вкладке Трасса нажмите кнопку рядом с именем файла и номером строки [2].
Элементы управления для работы с элементом трассы
8. Просмотр и добавление комментариев к маркеру на вкладке Комментарии. Комментарии для каждого маркера уникальны. Добавление одинаковых комментариев недоступно.
9. Редактирование и удаление комментариев на вкладке Комментарии с помощью кнопок и .
Если для проекта установлен флажок Обязательный комментарий при разметке, то удаление связанного с разметкой комментария недоступно. Его можно только отредактировать.
Вкладка Комментарии
Примечание: Пользователь может отредактировать и удалить только свои комментарии. Пользователю с доступом Изменение любых комментариев доступно редактирование и удаление комментариев всех пользователей. Если такой пользователь внёс изменения, то изначальный автор теряет возможность изменять свой комментарий (если у него нет доступа Изменение любых комментариев), так как авторство передаётся пользователю, который последним внёс изменения. Для отредактированного комментария отображается слово изменено, при наведении курсора на которое отображается сообщение с логином пользователя, изменившего комментарий, и датой редактирования.
10. Просмотр подробной информации на вкладке Подробности.
Вкладка Подробности
11. Просмотр информации о детекторе, который обнаружил маркер, – для этого нажмите на его имя на вкладке Подробности.
Пример информации о детекторе
12. Просмотр истории обнаружения маркера в снимках – для этого нажмите кнопку слева от названия снимка на вкладке Подробности.
Пример истории маркера
13. Запуск хуков (скриптов) – для этого нажмите кнопку Запустить на вкладке Подробности и выберите хук, который требуется запустить.


Использование фильтров

Общая информация

Настройка и использование фильтров доступны в режиме разметки.

Существует пять видов фильтров:

  1. Фильтры левой навигационной панели [1]: детекторы, файлы или серьезность.
  2. Доступные для разметки – позволяют отобразить только маркеры, которые доступны пользователю для разметки, т. е. при использовании этого фильтра в списке не будут отображаться маркеры, заблокированные другими пользователями. Фильтр применяется по нажатии кнопки [2] в правой части блока выбора проекта, ветки и снимка.
  3. Размеченный – позволяют отобразить только размеченные маркеры. Фильтр применяется по нажатии кнопки [3] в правой части блока выбора проекта, ветки и снимка.
  4. Пользовательские фильтры – доступны по нажатии кнопки [4] в правой части блока выбора проекта, ветки и снимка.
  5. Запрос – фильтр, указанный в поле в верхней части таблицы маркеров [5].
Существующие фильтры

Посмотреть примененные фильтры (кроме Доступные для разметки) и последовательность их применения можно в поле в верхней части таблицы маркеров.

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

По нажатии кнопки в правой части блока выбора проекта, ветки и снимка можно отменить примененные фильтры: пользовательский или все.

Настройка и использование пользовательских фильтров

Настроить пользовательские фильтры можно в режиме разметки. Для этого:

1. Нажмите кнопку в правой части блока выбора проекта, ветки и снимка. В правой части экрана отобразится панель пользовательских фильтров, которые разделены на три группы:
  • параметры детекторов;
  • параметры разметки маркеров;
  • файлы.
2. На вкладке Пользовательский:
а) Настройте параметры фильтрации – выберите значения в списках полей или нажмите кнопки со значениями.
б) Нажмите на кнопку справа от значения в списке, чтобы отменить его выбор.
в) Если параметры нужно исключить из поиска, нажмите на кнопку . Кнопка поменяется на .
г) Если параметры нужно включить в поиск, нажмите на кнопку . Кнопка поменяется на .
д) Нажмите кнопку , чтобы очистить все параметры фильтрации.
е) Нажмите кнопку , в открывшемся диалоге введите название и нажмите кнопку Сохранить.
ж) Нажмите кнопку , чтобы применить фильтр. После применения кнопка фильтра станет зеленой, а ее название поменяется на название сохраненного фильтра.
Пользовательские фильтры. Вкладка Пользовательский
3. На вкладке Сохраненные:
а) Для редактирования сохраненного фильтра нажмите кнопку .
б) Создайте дубликат фильтра – нажмите кнопку .
в) Удалите фильтр – нажмите кнопку .
г) Примените фильтр – нажмите на его название и нажмите кнопку .
Пользовательские фильтры. Вкладка Сохраненные

После применения:

  • примененный фильтр будет отмечен ;
  • кнопка фильтра станет зеленой, а ее название поменяется на название сохраненного фильтра.

Сравнение снимков и маркеров

Чтобы сравнить снимки и маркеры в них:

1. Выберите исходные проект, ветку и снимок.
2. В режиме разметки нажмите кнопку .
3. В открывшемся окне выберите проект, ветку и снимок для сравнения; нажмите кнопку .
Выбор проекта, ветки и снимка для сравнения
Результат сравнения отобразится в левой навигационной панели и центральной панели, причем:
  • вкладка Информация о снимке поменяется на вкладку Информация о различиях с информацией о двух сравниваемых снимках;
  • применится первый режим сравнения, в котором найдены результаты.
4. Выберите режим сравнения.
Выбор режима сравнения
В левой навигационной панели и центральной панели отобразятся только результаты выбранного режима сравнения.
В режимах Сопоставленные и Одинаковые в таблице маркеров добавится столбец с номером версии: V1 – маркер в файле текущего снимка, V2 – маркер в файле целевого снимка.

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


5. Посмотрите различия в параметрах анализа – нажмите кнопку Показать различия на вкладке Информация о различиях.
Сравнение настроек анализа
6. Посмотрите различия в статистике разметки – нажмите кнопку Различия разметок.
Сравнение статистики разметок
7. Нажмите кнопку или , чтобы скачать статистику в формате CSV или PDF.
8. Отмените сравнение – нажмите кнопку в блоке выбора проекта, ветки и снимка.


Сравнение маркеров

Чтобы сравнить два маркера:

1. В режиме разметки выберите исходные проект, ветку и снимок.
2. Раскройте таблицу маркеров.
3. Нажмите правой кнопкой мыши на строке маркера и выберите пункт Сравнить с ...
Откроется окно выбора маркера для сравнения.
Окно выбора маркера для сравнения
4. Выберите проект, ветку и снимок. Отобразится список маркеров в выбранном снимке, где можно ввести запрос для поиска маркеров.
Выбор маркера для сравнения
5. Дважды кликните на строке маркера, чтобы перейти в окно сравнения маркеров.
Окно сравнения маркеров

Разметка маркера

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


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

Окно разметки. Поле Комментарий – обязательное

Результаты разметки со связанными комментариями отображаются в правой панели на вкладке Комментарии. При этом можно поменять текст комментария, но не результат разметки. Для её изменения нужно заново установить статус, серьёзность и действие.

Правая панель. Комментарии, добавленные при разметке

Групповая разметка маркеров

Для групповой разметки:

1. В режиме разметки выберите исходные проект, ветку и снимок.
2. Включите отображение таблицы маркеров.
3. Выберите маркеры для разметки – установите флажки в строках таблицы.
4. Нажмите кнопку (доступна, если выбраны маркеры в таблице).
Выбор маркеров для групповой разметки
Отобразится окно для групповой разметки.
Окно групповой разметки
5. Разметьте выбранные маркеры: выберите статус разметки, а затем (опционально) статус серьезности (критичности) и требуемое действие – нажмите кнопки со значениями.
6. Добавьте общий комментарий для выбранных маркеров.
После того, как пользователь присвоил статусы и (или) написал комментарий, станет доступной кнопка Применить.
Примечание: ввод комментария обязателен, если для проекта установлен флаг Обязательный комментарий при разметке.
7. Если требуется отменить изменения, нажмите в правом верхнем углу окна или кнопку Отмена.
Диалоговое окно закроется, изменения не будут применены, выделение с выбранных для разметки маркеров не снимается.
9. Нажмите кнопку Применить, чтобы запустить процесс разметки.

Прогресс разметки отображается в соответствующем окне. Запущенный процесс можно полностью отменить нажатием кнопки Отмена.
В результате применения разметки текст маркеров в таблице маркеров окрасится в цвет, соответствующий выставленному статусу.


Блокировка разметки маркеров

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

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

1. На вкладке Детекторы. В этом случае блокировка распространяется на все маркеры выбранного детектора в открытом проекте и ветке, для всех снимков ветки.
2. На вкладке Файлы. В этом случае блокировка распространяется на все маркеры в выбранном файле в открытом проекте и ветке, для всех снимков ветки.
3. В верхней части правой панели. В этом случае блокировка распространяется на все эквивалентные маркеры в открытом проекте и ветке, для всех снимков ветки.


Если один пользователь заблокировал маркер, то другой пользователь не сможет заблокировать детектор, которому принадлежит этот маркер, и файл, в котором этот маркер найден.

Чтобы посмотреть все блокировки, перейдите в раздел Настройки на вкладку Блокировки:

Таблица блокировок

В этом разделе можно удалить только свои блокировки. Пользователь с доступом Удаление блокировок может удалить любые блокировки.

Экспорт кода с разметкой

Пользователь может экспортировать с сервера исходный код с разметкой (опционально) из снимка двумя способами:

Способ 1 – в пользовательском интерфейсе сервера Svacer

Для этого:

1. В режиме разметки выберите исходные проект, ветку и снимок.
2. На вкладке Информация о снимке в строке свойства ID нажмите кнопку .
Переход к экспорту кода с разметкой
3. В открывшемся окне выберите шаблон для экспорта в списке справа (по умолчанию Нет, т. е. разметка экспортироваться не будет) и опционально заполните поля для удаления префиксов и исключения путей:
Окно экспорта кода с разметкой

Пример удаления префиксов путей: /.build/ – чтобы убрать папку .build при экспорте.

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

Способ 2 – через консольную команду svacer markup export

Синтаксис команды:

svacer markup --user <user> --password <password> --project <project id or name> --branch <branch id or name> --snapshot <snapshot id or name> export [--stripPrefixes <prefix1, prefix2, … , prefixN> --excludePaths <path1, path2, … ,pathN> --template <name>]

Где:

  • user, password — имя пользователя и пароль учетной записи на сервере Svacer;
  • project — проект на сервере Svacer, из которого будет экспортирован код;
  • branch — ветка в проекте, выбранном выше (по умолчанию master), из которой будет экспортирован код;
  • snapshot — снимок в выбранных проекте и ветке (по умолчанию последний загруженный), из которого будет экспортирован код;
  • stripPrefixes, excludePaths — аналогичны полям Удалить префиксы и Исключить пути в форме экспорта разметки в пользовательском интерфейсе, описанной выше;
  • template — определяет название шаблона для экспорта разметки. Если название не указано, разметка не экспортируется.

В результате будут созданы директории и файлы с исходным кодом, соответствующие выбранному проекту. Если директории и файлы уже существуют, они будут перезаписаны.

Наличие в файлах комментариев зависит от того, был ли выбран шаблон разметки.

Работа с таблицей статистики

Чтобы посмотреть краткую статистику о разметке маркеров:

1. Выберите исходные проект, ветку и снимок.
2. Перейдите в режим разметки.
3. На вкладке Информация о снимке в строке свойства Статистика нажмите кнопку .
Переход к просмотру статистики
Отобразится таблица статистики:
Таблица статистики
4. Нажмите кнопку или , чтобы выгрузить статистику в соответствующем формате.
5. Нажмите кнопку в строке статистики, чтобы применить пользовательский фильтр с параметрами, которые соответствуют выбранному значению.

Работа в режиме просмотра кода

Режим позволяет посмотреть снимки исходного кода, связанного с результатами анализатора Svace.

Для этого:

1. Перейдите в режим просмотра кода с помощью переключателя в верхней части экрана.
2. Выберите исходные проект, ветку и снимок.
Примечание: по умолчанию выбран контекст (проект, ветка), заданный ранее в режиме Разметка или Отчеты. Если Пользователь перешел в раздел Кoд из режима сравнения снимков раздела Разметка, то для изменения контекста требуется отменить режим сравнения.
В левой части экрана отобразится иерархический список файлов снимка, а в правой – поле для отображения исходного кода файла.
Режим просмотра кода
3. В левой части экрана раскройте группу файлов и нажмите на имя файла.
4. Также доступен поиск файлов, для этого кликните на поле поиска или нажмите комбинацию клавиш Ctrl+Shift+O, в открывшемся окне введите поисковый запрос и выберите файл.
В правой части отобразится исходный код файла.
Пример одного открытого файла
4. Если требуется, откройте другие файлы.
Они отобразятся на отдельных вкладках, если выключена настройка Переиспользование вкладки в редакторе кода.
Пример трёх открытых файлов
5. Вызовите функции, доступные по нажатию правой кнопки мыши на строке исходного кода
  • Перейти к объявлению – для перехода к строке, в которой объявлена переменная;
  • Перейти к определению – для перехода к строке, в которой определена переменная и функция;
  • Найти ссылки – для просмотра ссылок в панели с иерархическим списком файлов, именами файлов и номерами строк, в которых найдены ссылки;
Cписок файлов с номерами строк, в которых найдены ссылки
  • Copy – для копирования строки в буфер обмена;
  • Command Palette – для вызова командной строки.

Управление проектами и группами проектов

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

Раздел Проекты

Работа с проектами

Список проектов отображается в левой части экрана и организован в виде иерархии. При этом:

  • для проектов, разметку маркеров которых нужно в обязательном порядке снабжать комментариями, отображается иконка ;
  • в нижней части списка отображается общее количество проектов и веток с учетом примененных фильтров, а также выбранных проектов и веток.

В списке доступны:

  • поиск по имени проекта;
  • фильтрация списка по группам проектов;
  • сортировка по названию или дате создания (по умолчанию – по названию).

При работе с проектами пользователю доступны следующие функции:

1. Загрузка актуальных данных с сервера – для этого нажмите кнопку .
2. Просмотр списка веток – для этого нажмите на название проекта.
Ветки отобразятся в этом же списке проекта на втором уровне.
3. Просмотр списка снимков – для этого нажмите на название ветки.
Список снимков отобразится в виде таблицы в правой части экрана.
4. Группировка проектов.
5. Создание проекта:
а) Нажмите кнопку Создать проект.
б) В открывшемся окне введите его название, выберите одну или несколько групп и установите флажок, если требуется при разметке маркеров обязательно добавлять комментарий.
в) Нажмите кнопку Создать.
При создании проекта автоматически создается ветка master.
При импорте снимка в интерфейсе командной строки проект, при его отсутствии, добавляется автоматически.
Окно создания проекта
6. Добавление ветки:
а) Нажмите кнопку в строке проекта.
б) В меню выберите пункт Создать ветку.
в) В открывшемся окне введите название.
При импорте снимка в интерфейсе командной строки ветка, при ее отсутствии, добавляется автоматически.
Окно добавления ветки в проект
7. Редактирование параметров проекта:
а) Нажмите кнопку в строке проекта.
б) В меню выберите пункт Редактировать.
в) В открывшемся окне измените название проекта, скорректируйте список групп, в которые включен проект, и установите или снимите флажок обязательности комментария при разметке.
8. Удаление одного проекта:
а) Нажмите кнопку в строке проекта.
б) В меню выберите пункт Удалить.
в) Подтвердите удаление.
9. Удаление нескольких проектов с ветками:
а) Выберите проекты для удаления – установите флажки в левой части названий проектов и веток или нажмите кнопку Выбрать всё.
б) Нажмите кнопку Удалить в верхней части списка проектов и подтвердите удаление.

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

Работа с группами проектов

Работа с группами проектов доступна на отдельной панели Группы проектов, которая отрывается по нажатии кнопки в списке проектов. При этом в нижней части списка отображается общее количество групп.

В списке групп доступны:

  • поиск по названию группы;
  • фильтрация списка по проектам.
Панель Группы проектов

При работе с группами проектов пользователю доступны следующие функции:

1. Просмотр списка связанных с группой проектов – для этого нажмите на название группы.
Проекты отобразятся в этом же списке групп на втором уровне.
2. Добавление группы:
а) Нажмите кнопку Создать группу.
б) В открывшемся окне введите название группы и выберите проекты, которые в неё войдут, нажмите кнопку Создать.
Созданная группа отобразится в списке на панели Группы проектов.
Окно Создать группу
3. Редактирование параметров группы:
а) Нажмите кнопку в строке группы.
б) В открывшемся окне измените название группы, скорректируйте состав включенных в группу проектов.
в) Нажмите на кнопку справа от названия проекта в списке, чтобы исключить его из группы.
г) Нажмите кнопку Сохранить.
Окно Редактировать группу
4. Исключение одного проекта из группы – для этого нажмите кнопку в правой части списка проектов группы.
5. Удаление одной группы – для этого нажмите кнопку в правой части списка групп и подтвердите удаление.
6. Удаление нескольких групп:
а) Выберите группы для удаления – установите флажки в левой части названий групп или нажмите кнопку Выбрать всё.
б) Нажмите кнопку Удалить в верхней части списка групп проектов и подтвердите удаление.
При удалении группы разрывается связь проекта с группой. Сами проекты не удаляются.

Работа с ветками

При работе с ветками проекта пользователю доступны следующие функции:

1. Просмотр списка снимков – для этого нажмите на название ветки.
Список снимков отобразится в виде таблицы в правой части экрана.
2. Редактирование ветки:
а) Нажмите кнопку в строке ветки.
б) В меню выберите пункт Редактировать.
в) В открывшемся окне измените название ветки.
Окно редактирования ветки
3. Клонирование ветки проекта:
а) Нажмите кнопку в строке ветки.
б) В меню выберите пункт Клонировать.
в) В открывшемся окне введите название новой ветки и нажмите кнопку Клонировать.
Окно клонирования ветки
4. Удаление ветки:
а) Нажмите кнопку в строке ветки.
б) В меню выберите пункт Удалить.
в) Подтвердите удаление.
При удалении ветки удаляются все ее снимки.
5. Копирование разметки в другой контейнер (проект и ветку):
а) Нажмите кнопку в строке ветки и в меню выберите пункт Копировать разметку.
б) В открывшемся окне выберите проект и ветку, в которые нужно скопировать разметку, а также действия, которые нужно выполнить при наличии разметки.
в) Нажмите кнопку Копировать.
Окно копирования разметки в другой контейнер

Разметка в контейнере состоит из множества размеченных маркеров. В целевой ветке уже может находиться разметка. Все множество маркеров в исходной ветке можно разбить на два:

  • «Уникальные» – маркеры, которые есть только в исходной ветке;
  • «Общие» – маркеры, которые есть как в ветке-источнике, так и в ветке-приемнике.

При выполнении операции копирования разметка в уникальных маркерах всегда копируется в ветку-приемник. Для «Общих» маркеров возможны несколько вариантов продолжения копирования, но по умолчанию выбран пункт Не копировать – в этом случае разметка в «Общих» маркерах в ветке-приемнике не изменяется.

Если выбрано действие Перезаписать, разметка на «Общих» маркерах в целевом контейнере будет заменена разметкой из ветки-источника.

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

Пример

Есть несколько контейнеров:
  • A с разметкой {(M1, D1), (M2, D2), (M3, D3)}
  • B с разметкой {(M4, D4), (M2, D5), (M3, D6)},
где M — это маркер, а D — разметка (включая метку времени).
Операцию сравнения на разметке обозначим как >. Если метка времени в D1 больше, чем в D2, то D1 > D2.
Пусть D2 > D5, а D3 < D6. Тогда операция копирования всегда скопирует разметку D1 (но не сам маркер), так как маркер M1 новый для контейнера B.
Маркеры M2, M3 — общие для двух контейнеров, поэтому то, какая разметка будет в контейнере-приемнике, будет зависеть от выбранного варианта разрешения конфликта:
  • если выбран пункт Не копировать, то в контейнере B на маркерах M2, M3 будет разметка D5, D6 соответственно;
  • если выбран пункт Перезаписать, то на M2, M3 будет разметка D2, D3;
  • если выбран пункт Перезаписать только старую разметку, то на M2, M3 разметка будет: D2, D6, так как D2 > D5 и D6 > D3.
При выполнении копирования наличие маркера в ветке-приемнике не проверяется.
При успешном копировании выводится всплывающее сообщение вида: Выполнено успешно. Всего: Х, Заменено:Y
Это сообщение означает, что всего было скопировано X инвариантов вместе с разметкой и среди скопированных инвариантов Y штук было скопировано с заменой.

Работа со снимками

Список снимков отображается в правой части экрана в виде таблицы после выбора ветки проекта. При этом в нижней части списка отображается общее количество снимков в выбранной ветке и количество выбранных снимков. В списке доступны:

  • поиск по названию снимка;
  • сортировка по значениям столбцов (по умолчанию — по дате создания).

Для настройки снимков пользователю доступны следующие функции:

1. Импорт снимка из файла:
а) Нажмите кнопку Импорт в верхней части табличного списка снимков.
б) В открывшемся окне выберите файл в формате .snap, введите название снимка (опционально) и нажмите кнопку Импортировать.
Примечание: если название не введено, то при импорте будет то же название, которое было при экспорте результатов анализа из Svace.
Окно импорта снимка
2. Переход к разметке маркеров снимка:
а) Нажмите кнопку в крайнем правом столбце строки снимка.
б) В меню выберите пункт Разметить.
3. Редактирование снимка:
а) Нажмите кнопку в крайнем правом столбце строки снимка.
б) В меню выберите пункт Редактировать.
в) Поменяйте название.
Окно редактирования снимка
4. Экспорт снимка в файл формата .snap:
а) Нажмите кнопку в крайнем правом столбце строки снимка.
б) В меню выберите пункт Экспортировать.
5. Просмотр информации о снимке в JSON-формате:
а) Нажмите кнопку в строке снимка крайнем правом столбце.
б) В меню выберите пункт Просмотреть JSON.
Окно просмотра информации о снимке в JSON-формате
6. Удаление одного снимка:
а) Нажмите кнопку в строке снимка крайнем правом столбце.
б) В меню выберите пункт Удалить.
в) Подтвердите удаление.
7. Удаление нескольких снимков:
а) Чтобы выбрать для удаления все снимки, установите флажок в заголовке табличного списка снимков.
б) Чтобы выбрать несколько снимков, установите флажки в крайнем правом столбце табличного списка.
в) Нажмите кнопку Удалить в верхней части табличного списка снимков и подтвердите удаление.

Режим формирования отчетов

Режим позволяет сформировать отчеты на основе хранимой информации, посмотреть их в пользовательском интерфейсе и выгрузить в формате .json. Для этого:

1. Выберите исходные проект и ветку.
Примечание: по умолчанию выбран контекст (проект, ветка), заданный ранее в режиме Разметка или Отчеты. Если Пользователь перешел в раздел Отчеты из режима сравнения снимков раздела Разметка, то для изменения контекста требуется отменить режим сравнения.
2. Перейдите в раздел Отчеты в верхней части экрана.
Отобразится форма формирования отчетов:
Форма формирования отчетов
3. На панели слева выберите требуемый отчет: Общий отчет или Тренды.
4. Выберите текущий и целевой снимки:
Выбор снимков для формирования отчета
5. Нажмите кнопку для запуска формирования отчета и его отображения в пользовательском интерфейсе.
6. Нажмите кнопку для выгрузки отчета в формате .json.


Пример отчета Тренды

Настройка сервера Svacer

Перейти в раздел Настройки можно по нажатии кнопки в верхней правой части экрана.

В этом разделе пользователю, в зависимости от роли, доступны следующие функции:

Управление пользователями, ролями и организациями

Управление пользователями

Реестром учетных записей пользователей можно управлять на вкладке Пользователи в разделе Управление пользователями страницы Настройки.
Для учетных записей с доступом по LDAP рядом с логином отображается индикатор , а для учетных записей с признаком Мастер разметки – индикатор .
В разделе доступны:

  • поиск по атрибутам учётной записи пользователя;
  • фильтрация списка по типам учётных записей:
  • все;
  • системные;
  • LDAP;
  • заблокированные;
  • активные.
  • сортировка по колонкам Логин, ФИО и Дата создания (по умолчанию).
Вкладка Пользователи в разделе Управление пользователями страницы Настройки

Для управления пользователями:

1. Создайте учетную запись пользователя:
а) Нажмите кнопку Создать.
Откроется окно добавления учетной записи пользователя.
Окно Создать пользователя
б) Заполните поля:
  • Логин;
  • Пароль;
  • e-mail;
  • ФИО.
в) Выберите организации, в которые должен входить пользователь, а также назначьте ему роли – выберите значения в раскрывающихся списках полей Организации и Роли соответственно. Для отмены выбора нажмите на кнопку справа от значения.
г) Включите опции Изменить пароль при первом входе в систему и Мастер разметки.
Примечание: Если для учётной записи активирована опция Мастер разметки, есть разрешение на разметку и этот пользователь разметил маркер в каком-либо снимке, то изменить его разметку может только пользователь, в учётной записи которого также активирована опция Мастер разметки или которому предоставлен серверный доступ Изменение любой разметки.
д) Нажмите кнопку Создать.
В таблице со списком пользователей добавится новая запись.
2. Воспользуйтесь функциями в строке учетной записи в крайнем правом столбце – нажмите кнопку и выберите пункт:
  • Редактировать – для перехода к редактированию данных профиля;
  • Изменить пароль – для перехода к изменению пароля;
  • Сбросить настройки пользователя – для возврата пользовательских настроек к их значениям по умолчанию;
  • Заблокировать – для блокировки учетной записи. В этом случае для учетной записи пользователя блокируется доступ к системе, а в списке рядом с логином учетной записи отображается индикатор ;
  • Разблокировать – для восстановления доступа пользователя к системе;
  • Удалить – для удаления учётной записи пользователя;
  • Показать доступы пользователя – для отображения списка объединенных доступов всех ролей, назначенных пользователю:
Список доступов пользователя
Примечание: Функции блокировки и удаления недоступны для системных учетных записей. При изменении логина или списка доступов у авторизованного пользователя, он будет перенаправлен на страницу авторизации.
3. Воспользуйтесь функциями управления несколькими учётными записями одновременно:
а) Чтобы выбрать несколько записей, установите флажки в первом столбце списка пользователей.
б) Чтобы выбрать все отображаемые учётные записи, установите один флажок в заголовке столбцов в первом столбце списка.
в) Нажмите кнопку Действия в верхней части списка пользователей и выберите пункт: Сбросить настройки пользователя, Заблокировать, Разблокировать или Удалить. В списке активны только действия, доступные всем выбранным учетным записям.
4. Для учетной записи с доступом по LDAP обновите данные – в окне редактирования данных профиля пользователя нажмите кнопку Загрузить из LDAP.
Загрузятся параметры профиля пользователя и его контакты из профиля в службе каталогов, если они там указаны.
Загрузка данных из LDAP

Управление ролями

Реестром ролей можно управлять на вкладке Роли в разделе Управление пользователями страницы Настройки.

Вкладка Роли в разделе Управление пользователями страницы Настройки

Примечание: роли admin, filter_master и importer являются встроенными с особым значением. Их нельзя удалить или изменить.
Доступен поиск по названию роли и сортировка по колонкам Название (по умолчанию) и Пользователи.
Для управления ролями доступны следующие функции:

1. Создание новой роли:
а) Нажмите кнопку Создать.
Окно добавления роли
б) Заполните поля появившейся формы:
  • введите название роли;
  • в блоке Серверные доступы выберите доступы – нажмите кнопку Выбрать всё или установите флажки для активации доступов.
При наведении курсора на иконку отображается пояснение к доступу.
  • в блоке Проектные доступы выберите тип доступа: группа проектов или определённый проект или его ветка;
  • если выбран тип Группа проектов, выберите название группы и установите флажки для активации доступов;
  • если выбран тип Проект / Ветка, выберите название проекта или ветки проекта, установите флажки для активации доступов.
Если выбрано значение Все, то доступы будут предоставлены для всех проектов;
  • для удаления строки с проектными доступами в блоке Проектные доступы нажмите кнопку в крайнем правом столбце.
в) Нажмите кнопку Создать.
2. Просмотр доступов роли, нажмите на ссылку Показать доступы в столбце Доступы.
Список доступов роли
3. Редактирование роли:
а) Нажмите кнопку в строке роли в крайнем правом столбце.
б) В меню выберите пункт Редактировать и внесите изменения.
4. Создание копии роли:
а) Нажмите кнопку в строке исходной роли в крайнем правом столбце.
б) В меню выберите пункт Создать копию.
В реестр ролей добавится новая запись с именем исходной роли и добавленным порядковым номером копии.
5. Просмотр информации о роли в JSON-формате:
а) Нажмите кнопку в строке исходной роли в крайнем правом столбце.
б) В меню выберите пункт Просмотреть JSON.
6. Удаление роли:
а) Нажмите кнопку в строке исходной роли в крайнем правом столбце.
б) В меню выберите пункт Удалить.
в) Подтвердите удаление.
7. Удаление несколько ролей одновременно:
а) Для выбора нескольких записей установите флажки в первом столбце списка ролей.
б) Чтобы выбрать все записи, установите один флажок в заголовке столбцов в первом столбце списка ролей.
в) Нажмите кнопку Удалить и подтвердите удаление.

Управление организациями

Пользователи могут быть связаны с организациями. Один пользователь может принадлежать нескольким организациям. Организации носят информационный характер и не влияют на права пользователей в системе.
Реестром организаций можно управлять на вкладке Организации в разделе Управление пользователями страницы Настройки.

Вкладка Организации в разделе Управление пользователями страницы Настройки

Доступен поиск по названию и сокращенному названию организации и сортировка по колонкам Название (по умолчанию), Сокращенное название и Пользователи. Для управления организациями, доступны следующие функции:

1. Создание организации:
а) Нажмите кнопку Создать.
б) Заполните поля появившейся формы.
в) Нажмите кнопку Создать.
Окно добавления организации в реестр
2. Редактирование организации:
а) Нажмите кнопку в крайнем правом столбце.
б) В появившейся форме отредактируйте данные организации.
в) Нажмите кнопку Сохранить.
3. Удаление организации:
а) Нажмите кнопку в крайнем правом столбце.
б) В появившемся диалоге подтвердите удаление, нажав на кнопку Удалить.
4. Удаление несколько организаций одновременно:
а) Для выбора нескольких записей установите флажки в первом столбце списка организаций.
б) Чтобы выбрать все организации, установите один флажок в заголовке столбцов в первом столбце списка.
в) Нажмите кнопку Удалить и подтвердите удаление.

Настройка глобальных фильтров

В разделе Глобальные фильтры страницы Настройки можно настроить глобальные фильтры, применительно к выбранным проекту или ветке проекта:
Примечание: по умолчанию выбран контекст (проект, ветка), заданный ранее в режиме Разметка, Код или Отчеты.

Раздел Фильтры на странице Настройки

В разделе доступен поиск по названию фильтра.

Для настройки фильтров:

1. Выберите проект и ветку в верхней строке раздела. По умолчанию указаны проект и ветка, выбранные в разделе Разметка.
2. Чтобы добавить фильтр, нажмите кнопку Создать.
Отобразится новая строка:
Новая строка с фильтром
3. Чтобы изменить настройки фильтров:
а) Введите или поменяйте название фильтра
б) Включите или выключите фильтр – нажмите на значение в столбце Статус, чтобы отобразилась иконка (по умолчанию) или .
в) Выберите область применения фильтра – нажмите на значение в столбце Область один или два раза, чтобы отобразилось значение ветка или проект.
г) Введите регулярное выражение или загрузите его из файла в столбцах Включить пути по шаблону, Исключить пути по шаблону и Детекторы.
д) Выберите уровни серьезности (критичности) и надежности:
  • – уровень выбран;
  • – уровень не выбран.
Для изменения выбора нажмите на название уровня.
4. Нажмите кнопку в крайнем правом столбце, чтобы удалить один фильтр.
5. Чтобы удалить несколько фильтров:
а) Для выбора нескольких записей установите флажки в первом столбце списка фильтров.
б) Чтобы выбрать все записи, установите один флажок в заголовке столбцов в первом столбце списка фильтров.
в) Нажмите кнопку Удалить.
6. Для сохранения и применения изменений нажмите кнопку Применить.
Примечание: если не применить изменения, то при переходе в другой раздел системы отобразится сообщение о том, что изменения не применены:

Управление блокировками разметки

Чтобы посмотреть список всех блокировок, перейдите на вкладку Блокировки страницы Настройки:

Раздел Блокировки страницы Настройки

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

Для удаления одной блокировки:

1. Нажмите кнопку в строке проекта в крайнем правом столбце.
2. Подтвердите удаление.

Для удаления нескольких блокировок:

1. Чтобы выбрать для удаления все блокировки, установите флажок в заголовке табличного списка.
2. Чтобы выбрать несколько блокировок, установите флажки в крайнем правом столбце табличного списка.
3. Нажмите кнопку Удалить в верхней части списка.

Управление шаблонами разметки

Управление шаблонами разметки доступно в разделе Шаблоны разметки страницы Настройки:

Раздел Шаблоны разметки на странице Настройки

Шаблоны разметки нужны для импорта/экспорта разметки. С их помощью комментарии в исходном коде будут преобразовываться в разметку на сервере истории и обратно.

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

Примечание: для корректного создания или изменения шаблонов разметки следует обратиться к разработчикам Svacer.

Для управления шаблонами:

1. Нажмите кнопку Создать.
Откроется окно создания шаблона.
Окно создания шаблона разметки
2. Введите название шаблона.
3. Нажмите кнопку Создать.
Шаблон появится в списке шаблонов для разметки в правой панели формы
4. Отредактируйте поля шаблона разметки:
Редактирование шаблона разметки
5. Нажмите Сохранить.
6. Чтобы клонировать существующий шаблон разметки, нажмите кнопку в правой части строки шаблона в списке.
7. Для удаления одного шаблона:
а) Нажмите кнопку в правой части строки шаблона в списке.
б) Подтвердите удаление.
8. Для удаления нескольких шаблонов:
а) Выберите шаблоны для удаления – установите флажки в левой части названий шаблонов или нажмите кнопку Выбрать всё.
б) Нажмите кнопку Удалить в верхней части списка шаблонов и подтвердите удаление.

Просмотр списка всех детекторов и его выгрузка в формате PDF

Чтобы посмотреть список всех детекторов, перейдите в раздел Детекторы страницы Настройки:

Раздел Детекторы страницы Настройки

Нажмите кнопку в строке детектора, чтобы посмотреть подробную информацию:

Окно с информацией о детекторе

Нажмите кнопку Экспорт в PDF, чтобы выгрузить список детекторов в формате .pdf.

Управление клиентами OAuth

Svacer поддерживает авторизацию по протоколу OAuth. Для авторизации используются запросы GET /api/oauth/authorize и POST /api/oauth/token в соответствии со стандартом.

Управление клиентами доступно в разделе Клиенты OAuth на странице Настройки:

Раздел Клиенты OAuth на странице Настройки

Доступен поиск по имени и домену клиента OAuth, сортировка по колонкам Название (по умолчанию) и Домен.

Для управления клиентами OAuth:

1. Создайте клиента OAuth:
а) Нажмите кнопку Создать.
б) В окне Создание клиента OAuth введите название и домен.
в) Нажмите кнопку Создать.
Окно Создание клиента OAuth
Отобразится окно с секретом клиента.
Внимание! Секрет отображается только один раз – при создании клиента.
г) Нажмите кнопку Скопировать в буфер обмена и сохраните секрет в надежном месте.
2. Чтобы скопировать ID клиента OAuth, нажмите кнопку .
3. Для перехода к изменению имени и домена клиента OAuth нажмите кнопку в крайнем правом столбце.
4. Для удаления одного клиента OAuth:
а) Нажмите кнопку в крайнем правом столбце.
б) Подтвердите удаление.
5. Для удаления нескольких клиентов OAuth:
а) Чтобы выбрать для удаления все клиенты, установите флажок в заголовке табличного списка.
б) Чтобы выбрать несколько клиентов, установите флажки в крайнем правом столбце табличного списка.
в) Нажмите кнопку Удалить в верхней части табличного списка клиентов и подтвердите удаление.

Просмотр информации о сервере

В разделе Информация о сервере на странице Настройки отображаются:

  • параметры, с которыми запущен сервер;
  • логи сервера;
  • журнал базы данных.
Раздел Информация о сервере на странице Настройки

Доступны функции:

  • копирование записей в системном логе и журнале;
  • выгрузка системного лога и журнала в файлы в формате .log

Выход из системы

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

Выход из системы

Использование регулярных выражений

Регулярные выражения можно использовать для поиска и фильтрации данных в левой навигационной панели на вкладке Файлы и в окне настройки пользовательских фильтров в блоке Файлы.

Особенности реализации:

1. Поиск происходит только по регулярному выражению. Если требуется найти специальный символ в качестве обычного символа, его нужно экранировать (например, точку: \.)
2. При поиске находятся вхождения подстроки в полном пути к файлу (аналогично grep). Если требуется найти по полной строке, используйте символы начала и конца строки: ^ и $
3. Поиск не зависит от регистра символов (case insensitive)
В окне настройки пользовательских фильтров в блоке Файлы можно применить фильтр как для отображения только маркеров из файлов, которые подходят под паттерн, так и для скрытия таких маркеров. Для переключения между этими режимами используйте кнопки и , которые расположены рядом с полем ввода.

Примеры регулярных выражений:

1. Поиск файлов с текстом sha или md5 в любом месте пути или имени файла:
sha|md5
2. Отображение только маркеров из файлов с расширением .c:
.*\.c$
3. Скрытие маркеров из файлов, имя которых начинается с символа q и которые имеют расширения .с или .сс:
а) Используйте выражение /q[^/]*\.c$|/q[^/]*\.cc$
б) Нажмите кнопку рядом с полем ввода, чтобы она поменялась на
4. Отображение только маркеров из файлов, которые имеют текст string в конце имени файла и с расширением из одного символа:
/.*string\..$
5. Скрытие маркеров из файлов в директориях asn1 и pem:
а) Используйте выражение /asn1/|/pem/
б) Нажмите кнопку рядом с полем ввода, чтобы она поменялась на
6. Отображение только маркеров из файлов, которые имеют в имени три цифры подряд:
.*/.*[0-9]{3}[^/]*$
где [^/]*$ означает, что после трех цифр и до конца строки может встречаться любой символ, кроме /. Это позволяет исключить директории, имеющие три цифры в названии.

Описание ролевой модели

Серверные доступы

Полномочие (доступ) Описание Влияние на графический интерфейс admin filter_master importer
Создание проектов Создание проектов. Пользователь, создавший проект, имеет полный доступ к управлению этим проектом Наличие полномочия делает доступным:
  • раздел Проекты;
  • кнопку Создать проект;
  • форму создания и редактирования проекта.

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

+
Настройка групп проектов Создание, редактирование и удаление групп проектов Наличие полномочия делает доступным:

Наличие доступа предоставляет права на просмотр маркеров во всех проектах

+
Управление пользователями Создание, редактирование и удаление пользователей Наличие полномочия делает доступной вкладку Пользователи в разделе Настройки – Управление пользователями со всеми функциями управления учетными записями пользователей +
Управление ролями Создание, редактирование и удаление ролей Наличие полномочия делает доступной вкладку Роли в разделе Настройки – Управление пользователями со всеми функциями управления ролями +
Управление организациями Создание, редактирование и удаление организаций Наличие полномочия делает доступной вкладку Организации в разделе Настройки – Управление пользователями со всеми функциями управления организациями +
Управление шаблонами разметки Создание, редактирование и удаление шаблонов разметки Наличие полномочия делает доступным раздел Настройки – Шаблоны разметки со всеми функциями управления учетными записями шаблонами +
Удаление блокировок Просмотр и удаление блокировок всех пользователей Наличие полномочия позволяет просматривать и удалять блокировки всех пользователей в разделе Настройки – Блокировки +
Управление клиентами OAuth Создание, редактирование и удаление клиентов OAuth Наличие полномочия делает доступным раздел Настройки – Клиенты OAuth со всеми функциями управления клиентами OAuth + + +
Администрирование сервера Просмотр настроек сервера, системных лог-файлов и выполнение операций по администрированию сервера Svacer Наличие полномочия делает доступным раздел Настройки – Информация о сервере +
Создание резервных копий Создание, просмотр и восстановление резервных копий в интерфейсе командной строки +
Запуск скриптов Запуск скриптов (hooks) по кнопке, расположенной на вкладке Подробности в правой панели, содержащей информацию о маркере Наличие полномочия добавляет строку Хуки на вкладке Подробности правой панели с возможностью запуска скриптов +
Использование Public API Использование REST API для интеграции с внешними системами +
Изменение любой разметки Изменение любой разметки маркеров, включая выполненную пользователями с признаком Мастер разметки Доступ позволяет переразмечать маркеры (добавлять новую разметку), которые разметили любые пользователи, в том числе те, для которых активирована опция Мастер разметки.

При этом:

  1. Полномочие не предоставляет доступ ко всем проектам. Т. е. пользователь с таким полномочием может изменять разметку только в проектах, к которым у него имеется доступ.
  2. Для переразметки маркеров пользователю должен быть предоставлен проектный доступ Разметка маркеров.
  3. Чтобы переразметить заблокированный маркер, сначала нужно снять его блокировку
+
Изменение любых комментариев Редактирование и удаление любых пользовательских комментариев к маркерам Доступ позволяет изменять/удалять комментарии, которые создали любые пользователи, в том числе те, для которых активирована опция Мастер разметки.

При этом:

  1. Полномочие не предоставляет доступ ко всем проектам. Т. е. пользователь с таким полномочием может изменять разметку только в проектах, к которым у него имеется доступ.
  2. Для добавления комментариев пользователю должно быть предоставлено проектное полномочие Разметка маркеров.
  3. Чтобы поменять комментарий к заблокированному маркеру, сначала нужно снять его блокировку
+

Проектные доступы

Полномочие (доступ) Описание Влияние на графический интерфейс admin filter_master importer
Управление проектом и его ветками Редактирование и удаление проекта, включая операции по управлению ветками и снимками проекта, настройке глобальных фильтров, импорту/экспорту разметки и просмотру маркеров Наличие полномочия делает доступным:
  • раздел Проекты;
  • все функции управления проектом (проектами в группе) и его содержимым (за исключением разметки маркеров) – т. е. все операции с проектом, ветками и снимками.

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

+
Управление ветками и снимками Редактирование и удаление ветки проекта, включая операции по управлению снимками, настройке глобальных фильтров, импорту/экспорту разметки и просмотру маркеров Наличие полномочия делает доступным:
  • раздел Проекты;
  • все функции управления веткой и снимками проекта (за исключением разметки маркеров) – т. е. доступны все операции с веткой и снимками, но не операции управления проектом.

Наличие полномочия позволяет удалять приложения к снимкам и экспортировать разметку с исходным кодом. Запрещено клонировать ветку при наличии доступа только к этой ветке

+
Настройка глобальных фильтров Создание, редактирование и удаление глобальных фильтров Наличие полномочия делает доступным раздел Настройки – Глобальные фильтры.

Список проектов и веток в разделе определяется полномочиями к этим проектам и веткам

+ +
Импорт снимков Загрузка, редактирование названия и удаление снимков Наличие полномочия делает доступным:
  • раздел Проекты;
  • функции просмотра проекта и ветки, управления снимками в указанной ветке, просмотра маркеров в снимке
+ +
Импорт разметки Импорт разметки из исходного кода и управление подавлением маркеров в интерфейсе командной строки Наличие полномочия делает доступным просмотр маркеров в указанном контейнере + +
Экспорт разметки Экспорт разметки с исходным кодом Наличие полномочия позволяет выполнить экспорт разметки с исходными кодами и просматривать маркеры в указанном контейнере + +
Просмотр маркеров Просмотр маркеров и кода снимков, экспорт снимков, просмотр блокировок маркеров Наличие полномочия предоставляет доступ к следующим функциям в режиме разметки:
  • просмотр и выбор снимков в указанной ветке;
  • просмотр содержимого снимков и маркеров (без возможности разметки);
  • экспорт снимков и пр.

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

+ + +
Разметка маркеров Просмотр и разметка маркеров в снимках, включая добавление комментариев, управление списком блокировок Наличие полномочия позволяет пользователю размечать маркеры в указанном снимке, добавлять комментарии, управлять своими блокировками, т. е. для собственных блокировок доступны кнопки удаления, а блокировки других пользователей доступны только для просмотра.

При отсутствии полномочия в таблице маркеров недоступны поля для установки флажков, а кнопка групповой разметки – неактивна

+
Использование Report API Использование Report API для получения статистических показателей +

Известные ограничения

  • Управление своими проектами для пользователей только c серверной ролью "Create Projects" без дополнительных прав может не работать для проектов, созданных до Release 7-0-0.
Workaround: добавить пользователю явно проектные доступы на каждый необходимый проект.