Help:UI manual

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

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

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

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

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

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

Страница входа по протоколу LDAP

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

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

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

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

1. Верхняя панель – отображается на всех страницах пользовательского интерфейса
   Содержит:
   • логотип сервера Svacer
   • – кнопки для переключения режимов работы:
     • Разметка – просмотр и разметка найденных маркеров, а также сравнение снимков или отдельных маркеров;
     • Код – просмотр снимков исходного кода, связанного с результатами анализатора Svace;
     • Проекты – управление проектами (режим доступен только пользователям с ролью admin);
     • Отчеты – формирование отчетов на основе хранимой информации;
   • – кнопка для перехода к настройке системы
   • – переключатель языка пользовательского интерфейса
   • – кнопка для перехода на страницу документации к системе
   • – кнопка для перехода к уведомлениям
   • – кнопка меню пользователя, которое предоставляет следующие функции:
     • переход к настройке профиля пользователя;
     • выход из системы;
     • просмотр информации о программе.
2. Рабочая область – область экрана для просмотра информации и ввода, которая соответствует выбранному режиму работы или странице настроек.

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

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

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

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

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

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

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

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

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

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

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

1. Профиль пользователя – в этом разделе можно изменить атрибуты своего профиля (ФИО, контакты), кроме логина, а также поменять пароль.

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

2. Общие настройки интерфейса – в этом разделе можно включить или выключить следующие функции:

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

Эти настройки сохраняются для учетной записи пользователя и не сбрасываются при новой сессии.

Общие настройки интерфейса

3. Настройки панели навигации – в этом разделе можно настроить отображение по умолчанию для детекторов и файлов на панели навигации, а также для сортировки значений на вкладке Файлы.

Эти настройки сохраняются для учетной записи пользователя и не сбрасываются при новой сессии.

Временное отображение файлов на панели навигации и их сортировку можно настроить по нажатии иконки на панели навигации.

Настройки панели навигации

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

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

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.

Командная строка

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

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

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

• – поле с информацией о примененных фильтрах: как назначенных в навигационной панели, так и с помощью пользовательских фильтров и запросов
• поле запроса для фильтрации данных;
• кнопка – выгрузка отображаемых маркеров в формате .csv или .pdf;
• кнопка – переход к групповой разметке выбранных маркеров (доступна, если выбраны маркеры в таблице).

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

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

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] в правой части блока выбора проекта, ветки и снимка [3].
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. В верхней части правой панели. В этом случае блокировка распространяется на все эквивалентные маркеры в открытом проекте и ветке, для всех снимков ветки

• 

  Блокировка маркера на вкладке Детекторы

• 

  Блокировка маркера на вкладке Файлы

• 

  Блокировка маркера на правой панели

Если один пользователь заблокировал маркер, то другой пользователь не сможет заблокировать детектор, которому принадлежит этот маркер, и файл, в котором этот маркер найден.
В этом случае при наведении курсора на в строке файла отобразится сообщение: Невозможно заблокировать файл, так как один или несколько его маркеров заблокированы другим пользователем.

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

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

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

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

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

Способ 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 — имя пользователя и пароль учетной записи на сервере истории
• project — проект на сервере истории, из которого будет экспортирован код
• branch — ветка в проекте, выбранном выше (по умолчанию master), из которой будет экспортирован код
• snapshot — снимок в выбранных проекте и ветке (по умолчанию последний загруженный), из которого будет экспортирован код
• stripPrefixes, excludePaths — аналогичны полям Удалить префиксы и Исключить пути в форме экспорта разметки в пользовательском интерфейсе, описанной выше
• template — определяет имя шаблона для экспорта разметки. Если имя не указано, разметка не экспортируется

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

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

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

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

1. Выберите исходные проект, ветку и снимок

2. Перейдите в режим разметки

3. На вкладке Информация о снимке в строке свойства Статистика нажмите кнопку

Переход к просмотру статистики

Отобразится таблица статистики:

Таблица статистики

4. Нажмите кнопку или ,чтобы выгрузить статистику в соответствующем формате

5. Нажмите кнопку в строке статистики, чтобы применить пользовательский фильтр с параметрами, которые соответствуют выбранному значению

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

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

Для этого:

1. Выберите исходные проект, ветку и снимок

2. Перейдите в режим просмотра кода с помощью переключателя в верхней части экрана

В левой части экрана отобразится иерархический список файлов снимка, а в правой – поле для отображения исходного кода файла

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

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

Пример одного открытого файла

4. Если требуется, откройте другие файлы

Они отобразятся на отдельных вкладках

Пример трёх открытых файлов

5. Вызовите функции, доступные по нажатию правой кнопки мыши на строке исходного кода

• Перейти к определению – для перехода к строке, в которой определена переменная и функция
• Найти ссылки – для просмотра ссылок в панели с иерархическим списком файлов, именами файлов и номерами строк, в которых найдены ссылки

Cписок файлов с номерами строк, в которых найдены ссылки

• Copy – для копирования строки в буфер обмена
• Command Pallette – для вызова командной строки

Командная строка

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

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

1. Выберите исходные проект и ветку

2. Перейдите в режим формирования отчетов с помощью переключателя в верхней части экрана

Отобразится форма формирования отчетов:

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

3. На панели слева выберите требуемый отчет: Общий отчет или Тренды

4. Выберите текущий и целевой снимки:

Выбор снимков для формирования отчета

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

6. Нажмите кнопку для выгрузки отчета в формате .json

Пример общего отчета

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

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

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

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

• управление пользователями и ролями
• настройка глобальных фильтров
• управление шаблонами разметки
• управление проектами
• просмотр и выгрузка списка детекторов
• управление блокировками
• просмотр информации о сервере
• управление клиентами OAuth
• управление организациями

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

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

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

Вкладка Пользователи на странице Настройки

Для учетных записей с доступом по LDAP, над логином учетной записи отображается индикатор

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

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

1. Создайте учетную запись пользователя:

а) Нажмите кнопку Добавить пользователя

Переход к добавлению учетной записи пользователя

Откроется окно добавления учетной записи пользователя

б) Заполните поля:

• Логин
• Пароль
• e-mail
• ФИО
• Организации

в) Включите опцию Изменить пароль при первом входе в систему (опционально)

г) Нажмите кнопку Добавить

Окно Добавить пользователя

В таблице со списком пользователей добавится новая запись.

2. Чтобы назначить пользователю роли, выберите значения в выпадающем списке поля в столбце Роли:

Назначение ролей пользователю

3. Нажмите на кнопку справа от значения, чтобы отменить его выбор

4. Воспользуйтесь функциями в строке профиля в столбце Действия:

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

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

Загрузятся параметры профиля пользователя и его контакты из профиля в службе каталогов, если они там указаны. Пользователь может изменить эти параметры

Загрузка данных из LDAP

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

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

1. Нажмите кнопку Роли:

Переход к управлению ролями

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

Панель со списком ролей

Следующие роли являются встроенными с особым значением, их нельзя удалить или изменить:

Роль	Полномочия/особенности
importer	Загрузка данных анализа посредством команды в CLI svacer upload
review_master	Разметка, выполненная пользователем с этой ролью, не может быть переопределена пользователем без этой роли
admin	Дает полномочия администратора сервера
filter_master	Дает возможность настраивать глобальные фильтры для проектов и веток проектов

2. Включите опцию Показать столбец "ID роли", если требуется

3. Чтобы добавить роль:

а) Нажмите кнопку Добавить роль

Откроется окно добавления роли

б) Введите название роли

в) Добавьте разрешения для создаваемой роли, для этого:

• Нажмите кнопку Добавить еще
• Выберите проект или ветку и разрешение

г) Нажмите кнопку Добавить

Окно добавления роли

В таблице со списком ролей добавится новая запись.

Роль пользователя определяет доступные пользователю действия со следующими объектами сервера: проектами, ветками, маркерами, снимками:

Действие	Область	Эффект
Чтение	Проект	Получение списка веток проекта Получение списка маркеров любой ветки проекта Экспорт данных из веток проекта
Чтение	Ветка	Получение списка маркеров из ветки проекта Экспорт данных из ветки проекта
Запись	Проект	Импорт данных в любую ветку проекта
Запись	Ветка	Импорт данных в конкретную ветку проекта
Разметка	Проект	Возможность менять разметку и добавлять/менять комментарии к маркерам во всех ветках проекта
Разметка	Ветка	Возможность менять разметку и добавлять/менять комментарии к маркерам в конкретной ветке проекта

Также существует:

• специальная область ALL, которая означает все проекты и ветки
• действие ALL, которая означает все доступные действия чтение, запись и разметка

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

5. Чтобы удалить роль, нажмите кнопку в строке роли в столбце Действия (недоступно для встроенных ролей)

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

Примечание: функции, описанные в этом разделе, доступны только пользователю с ролью admin или Filter_master. Пользователям с другими ролями доступен только просмотр.

На вкладке Фильтры страницы Настройки можно настроить глобальные фильтры, применительно к выбранным проекту или ветке проекта:

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

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

1. Чтобы добавить фильтр, нажмите кнопку Добавить фильтр

Отобразится новая строка:

Новая строка с фильтром

2. Чтобы изменить настройки фильтров:

а) Введите или поменяйте название фильтра

б) Деактивируйте или активируйте фильтр – нажмите на значение в столбце Активные один или два раза, чтобы отобразилась иконка или

в) Выберите область применения фильтра – нажмите на значение в столбце Область один или два раза, чтобы отобразилось значение ветка или проект

г) Укажите регулярное выражение или загрузите файл шаблона в столбцах Включить пути по шаблону, Исключить пути по шаблону и Шаблоны детекторов

д) Выберите уровни серьезности (критичности) и надежности:

• – уровень выбран
• – уровень не выбран

Для изменения выбора нажмите на название уровня

3. Нажмите кнопку в столбце Действия, чтобы удалить фильтр

4. Для завершения работы с фильтрами без сохранения нажмите кнопку Сброс

5. Для завершения работы с фильтрами и применения изменений нажмите кнопку Применить изменения.

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

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

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

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

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

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

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

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

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

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

Шаблоны разметки нужны для импорта/экспорта разметки. С их помощью комментарии в исходном коде будут преобразовываться в разметку на сервере истории и обратно.
Шаблон с именем DEFAULT есть всегда, его нельзя отредактировать или удалить.
Примечание: для корректного создания или изменения шаблонов разметки следует обратиться к разработчикам Svacer.

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

1. Нажмите кнопку Добавить шаблон.

Откроется окно добавления шаблона

Окно добавления шаблона разметки

2. Введите название шаблона.

3. Нажмите кнопку Добавить

Шаблон появится в списке шаблонов для разметки в правой панели формы

4. Отредактируйте поля шаблона разметки:

Редактирование шаблона разметки

5. Нажмите Сохранить.

6. Чтобы клонировать существующий шаблон разметки, нажмите кнопку в столбце Действия.

7. Чтобы удалить шаблон разметки, нажмите кнопку в столбце Действия.

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

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

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

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

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

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

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

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

API-вызовы для управления клиентами:

• GET /api/oauth/clients — получение всех клиентов для текущего пользователя или всех клиентов текущего сервера для админа
• GET /api/oauth/client?client_id={client_id} — получение клиента по id
• POST /api/oauth/client — создание нового клиента
• PUT /api/oauth/client — изменение данных клиента
• DELETE /api/oauth/client/{client_id} — удаление клиента

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

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

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

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

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

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

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

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

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

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

• копирование записей в системном логе и журнале
• выгрузка системного лога и журнала в файлы в формате .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}[^/]*$

где [^/]*$ означает, что после трех цифр и до конца строки может встречаться любой символ, кроме прямого слеша. Это позволяет исключить директории, имеющие три цифры в названии.