Руководство администратора

Вход в систему после установки

При установке в системе создается служебный пользователь admin (пароль Qwerty123) с правами установки. Флажок Remember me позволяет, однажды указав логин и пароль, сохранить данные, вводимые при авторизации в браузере или на устройстве.

Рекомендуем сменить пароль пользователя до начала эксплуатации системы.

Войдите в систему под пользователем с ролью "admin."

Пробный период

После установки можно использовать Test IT для работы 25 пользователей в течение 30 дней. При приобретении лицензии все данные в системе за этот период сохранятся. При авторизации пользователя с ролью администратора он увидит уведомление о том сколько времени осталось до окончания пробного периода.

Панель администратора

Для перехода в раздел Администрирование нажмите на аватар или три точки в правом верхнем углу, в выпадающем меню выберете пункт "Администрирование".

Пользователи

На вкладке "Пользователи" доступен список пользователей из AD плюс локальные пользователи, а также кнопка "Добавить" для добавления локального пользователя:

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

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

Левая колонка с элементами управления "checkbox" позволяет выбрать несколько локальных пользователей, и удалить их из системы нажатием кнопки "Удалить".

В модальном окне добавления/редактирования пользователя есть проверка валидности введённых значений.

Группы

На вкладке "Группы" доступно создание и редактирование названия и описания локальных групп, добавление и удаление пользователей в группы, фильтрация пользователей и настройка колонок:

Для добавления пользователей в текущую (выделенную в левой колонке) группу необходимо выделить нужных пользователей в правой колонке при помощи "checkbox", затем нажать на кнопку :

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

Импорт тестовой документации из TestRail

На вкладке "Импорт" доступна возможность импорта xml файлов экспортированных из TestRail. Возможна загрузка тестовой документации в новый проект, а также в существующий.

Вы можете загрузить несколько файлов одновременно и отслеживать прогресс их обработки. Когда обработка файла будет завершена - импортированный проект отобразится в списке проектов Test IT.

Test IT поддерживает стандартные типы xml выгрузок из TestRail, можно загрузить тесты с проверками и ожидаемым результатом, а также разбитые по шагам.

Интеграция с серверной JIRA

Перед интеграцией необходимо установить плагин "Test IT". Инструкция по установке находится здесь.

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

Для корректной работы интеграции с Jira нужно задать в .env файле переменную FRONTEND_URL

На вкладке "Интеграция с JIRA" доступно создание/редактирование/удаление подключений к Jira и кнопка для синхронизации всех проектов, использующих данное подключение к Jira.

Нажмите на кнопку "Создать", откроется окно с настройками соединения. В поле "Имя" введите наименование соединения, оно будет отражаться в интерфейсе Test IT. В поле "URL" введите полный адрес JIRA, с протоколом и портом (если необходимо) Поля "Логин" и "Пароль" необходимо заполнить данными учетной записи администратора JIRA

После ввода информации в поля нажмите "Тест". Если информация была введена правильно, появится возможность нажать "Сохранить". В случае ошибки в полях, возле кнопки теста появится информация об ошибке. Интеграцию с JIRA в дальнейшем можно использовать для подключения проекта Test IT к JIRA

Интеграция с облачной JIRA

Интеграция с Next Gen проектами (проекты, управляемые командой) не поддерживается.

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

Для корректной работы интеграции с Jira нужно задать в .env файле переменную FRONTEND_URL

Необходимо предварительно настроить Jira cloud: 1) Создание полей hiddenSteps и testResultId (1 раз для всей системы) а) Перейти в настройки проекта Jira / "Поля"

б) Создать поля с названиями hiddenSteps и testResultId

Тип поля - многострочное текстовое поле:

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

г) Повторить шаги выше с атрибутом testResultId.

2) Создать тип задачи (1 раз для всей системы) а) Перейти в "Настройки системы / Типы запросов".

б) Создать новый тип задачи, нажав на кнопку "Создать новый тип задачи". Имя типа задачи - TestCase.

Результат:

3) Добавить Issue type в проект (для каждого проекта) а) Перейти в настройки проекта, который планируется интегрировать с Test IT.

б) Выбрать "Типы запросов".

в) Добавить созданный тип запроса в схему.

Важно, чтобы новый Issue Type присутствовал во всех необходимых схемах, иначе дублирование работать не будет.

г) Нажать на тип запроса TestCase и добавить в него поле hiddenSteps.

4) Получить токен Jira а) Открыть панель администрирования в разделе "Настройки аккаунта".

б) Открыть раздел "Безопасность".

3) Создать токен.

Внимание! Токен нельзя будет получить после закрытия окна

5) Особенности создания интеграции с облачной Jira в административном разделе Test IT а) Логин пользователя необходимо указывать полностью (с @mail.mail). б) Пароль = токен Jira.

Системные роли

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

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

  • При помощи проставления "checkbox" пользователям и группам выдаются роли;

  • Роль админа (administrator) позволяет получить доступ ко всей функциональности системы, роль пользователя (user) необходима для входа в систему если нет роли админа, роль руководителя проектов (project manager) позволяет создавать новые проекты без доступа к административной части Test IT; при отсутствии ролей пользователь не может войти;

  • При отключении роли у пользователя (повторное нажатие на галочку в "checkbox") его сессии автоматически завершается, то есть он увидит страницу входа в систему;

  • Пользователь не может забрать роли у себя (нажатие на активный "checkbox" приводит к ошибке)

  • При добавлении пользователя через AD/LDAP к группе у которой есть права в нашей системе, синхронизация может занять 20 минут.

Проектные роли

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

Предзаданные роли: ProjectAdmin - полный доступ ко всему функционалу проекта, включая его настройку. TestManager - доступен весь функционал проекта, кроме его настроек. TestDesigner - роль для пользователей, которые работают с библиотекой тестов, доступ к остальному функционалу закрыт (кроме Запросов). Обратите внимание, у роли нет прав удаления тест-кейсов, только изменение. TestEngineer - с этой ролью специалисту будут доступны все разделы, но без права удаления сущностей. TestExecutor - роль для запуска, прохождения ручных и автотестов. Зона ответственности - вкладка "Тест-планы / Выполнение". Observer - минимальный доступ к проекту, только просмотр элементов

Разделы Test IT, к которым можно ограничить доступ:

  • Редактирование проекта - возможность создания проекта и его настройке. Доступны изменения описания проекта, добавление пользователей, пользовательских атрибутов, настройка интеграции проекта с внешним сервером (Jira)

  • Библиотека тестов - раздел, где хранится тестовая документация проекта (тест-кейсы, чек-листы, общие шаги)

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

  • Тест-планы - раздел, где хранятся тест-планы проекта, в которых можно создавать, заполнять, и распределять задачи между пользователями

  • Выполнение тестов - раздел для выполнения тест-планов, который позволяет записывать результаты прохождения тест-кейсов, а также запускать автотесты

  • Отчет по тест-плану - раздел категоризированных отчетов о результатах тест-плана

  • Дашборды - раздел сводной отчетности по проекту

  • Библиотека автотестов - раздел автоматических тестов

  • Фильтры - раздел для создания отфильтрованных запросов для поиска среди различных тест-кейсов проекта.

Права доступа к элементам Проектные права доступов выполнены в виде таблицы, где строки являются элементами Test IT, а столбцы - название роли. Для назначения или изменения права на элемент выберите нужное значение в ячейке из выпадающего списка. Право "Запрещено" ограничивает доступ пользователя к API и UI, связанными с этим элементом. В UI этот элемент будет скрыт, по прямой ссылке не будет доступен. При обращении к элементу через API появится ошибка доступа. Право "Просмотр" позволяет пользователю видеть содержимое элемента, но не изменять или удалять его. Соответствующие элементы интерфейса будут скрыты или недоступны, при обращении к элементу через API (кроме GET запросов) появится ошибка доступа. Право "Редактирование" даст пользователю возможность видеть и изменять элементы Test IT, но ограничит возможность удалять элементы. Например, можно изменить текст в шаге тест-кейса, но удалять тест-кейс полностью запрещено. Для настроек проекта это означает, что проект нельзя архивировать и восстанавливать, все остальные действия разрешены. При обращении к API запросы типа DELETE будут отдавать ошибку доступа. Право "Полный доступ" предоставляет неограниченный доступ к элементу. Для создания новой роли нажмите на кнопку "Создать роль" и введите имя роли. Роль будет создана с минимальными правами, которые можно изменить, нажав на карандаш около названия роли. Некоторые права на элементы нельзя изменить, например, нельзя запретить доступ к библиотеке тестов или ограничить доступ к "Запросам".

AD/LDAP

На вкладке "AD/LDAP" доступно редактирование соединения Active Directory (или LDAP) и кнопка для принудительной синхронизации. Чтение и синхронизация происходят каждые 5 минут.

В настройках AD/LDAP можно указывать схему пользователей и групп для поддержки большинства служб. Описание полей: Имя - имя соединения в административном разделе Test IT. Пример: "My connection". Settings / Search Base - Узел в LDAP для поиска пользователей и групп. Пример: "dc=testit,dc=software". Settings / Host - Имя хоста сервера, на котором запущен LDAP. Пример: "198.162.43.21". Settings / Ports - Порт сервера LDAP. Пример: "389". Settings / Distinguished Name - Имя пользователя для подключения к серверу LDAP. Пример: "[email protected]". Settings / Password - Пароль пользователя. Пример: "Qwerty123". SSL - Подключение с помощью защищенного протокола. User Schema / User Name - Атрибут имени пользователя (sAMAccountName). Пример: "AntonIvanov". User Schema / Distinguished Name - Атрибут уникального имени пользователя. Пример: "CN=Антон Иванов ,OU=TestIT ,DC=testit,DC=software". User Schema / Display Name - Атрибут, используемый при загрузке полного имени пользователя. Пример: "Антон Иванов". User Schema / First Name - Атрибут, используемый при загрузке имени пользователя. Пример: "Антон". User Schema / Last Name - Атрибут, используемый при загрузке фамилии пользователя. Пример: "Иванов". User Schema / Email - Атрибут, используемый при загрузке email. Пример: "[email protected]". User Schema / Membership - Атрибут членства пользователя в группе. Пример: "CN=MyGroup,OU=Testit,DC=testit,DC=software". User Schema / Id - Атрибут, используемый для отслеживания личности пользователя при его переименовании. Пример: "878ce8b7-2713-41a9-a765-5e3905ab5ef2". User Schema / Common Name - Атрибут, используемый при загрузке имени пользователя. Пример: "Антон Иванов". User Schema / Filter - Фильтр, используемый при поиске объектов пользователя. Пример: "(&(userAccountControl=*)(!(objectClass=computer)))". Group Schema / Members - Атрибут, используемый при загрузке членов группы из группы. Пример: "member". Group Schema / Name - Атрибут имени группы. Пример: "LittleGroup". Group Schema / Id - ID группы. Пример: "878ce8b7-2713-41a9-a765-5e3905ab5ef2". Group Schema / Common Name - Атрибут, используемый при загрузке имени группы. Пример: "MyLittleGroup". Group Schema / Filter - Фильтр, используемый при поиске объектов групп. Пример: "(groupType=*)".

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

User Schema: Пример фильтра для пользователей из одной группы:

(&(objectCategory=Person)(sAMAccountName=*)(memberOf=CN=Group-Sonya,OU=Sonya-test,OU=podrazdelenie2,OU=Podrazdelenie1,DC=mtest,DC=ru))

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

(&(objectCategory=Person)(sAMAccountName=*)(memberOf:1.2.840.113556.1.4.1941:=CN=Group-Sonya,OU=Sonya-test,OU=podrazdelenie2,OU=Podrazdelenie1,DC=meistertest,DC=ru))

Group Schema: Фильтр для одной группы (имя начинается с ..) :

(&(objectCategory=group)(name=Group-Sonya*))

На странице подключений AD/LDAP можно создать несколько подключений, а также выбрать подключение по умолчанию.

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

Авторизация OpenID Connect

Test IT позволяет авторизоваться с помощью внешнего провайдера, поддерживающего протокол OpenID Connect.

Для создания такого подключения нужно задать необходимые поля, базовый домен сервиса который используем для авторизации и endpoint для получения конфигурации OpenID Connect.

Помимо этого задаются идентификатор и секретный ключ приложения, полученные от провайдера. А также scope необходимые для получения информации о пользователях от внешней системы. Минимально необходимые scopes: openid, profile, email. Укажите Callback URL во внешней системе, заменив домен на ваш в этом примере: https://{test_it_domain}/api/auth/signin-oidc

После добавления OpenID Connect провайдера на странице логина появляется возможность авторизации с помощью него.

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

Лицензии

На вкладке "Лицензии" доступно добавление лицензионного ключа:

  • Для получения ключа обратитесь с почтового ящика, привязанного к личному кабинету на сайте Test IT на [email protected]. Укажите идентификатор сервера в теле письма или заголовке;

  • Необходимо скопировать идентификатор сервера, например нажатием на кнопку справа от него;

  • После выписывания ключа его необходимо вставить в окно, появляющееся по кнопке "Добавить";

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

Над таблицей отображается количество активных пользователей в системе - сумма активных пользователей всех лицензий со статусом “Активировано“.

Атрибуты

На вкладке "Атрибуты" доступны добавление глобальных атрибутов, шаблонов глобальных атрибутов, и превращение/замена/объединение проектных атрибутов в глобальные. Глобальные атрибуты идентичны проектным атрибутам, но применимы в рамках всей системы. Таким образом, достаточно создать глобальный атрибут один раз и можно применять его в любых проектах. В разделе "Глобальные" отображаются все доступные в системе глобальные атрибуты.

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

На плашке атрибута доступны кнопки редактирования, удаления атрибута, и отображается количество проектов, в которых используется данный глобальный атрибут. При нажатии на кнопку "Использован" появляется список проектов, где используется этот атрибут. Можно перейти в библиотеку тестов проекта в новой вкладке по клику на название проекта из списка.

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

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

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

По аналогии с глобальными атрибутами, можно посмотреть в каком проекте используется атрибут. Также, отображается статус атрибута в проекте - включен/выключен. Если проект был архивирован, то атрибуты такого проекта отображаются со значением "Использован 0". Проектные атрибуты можно отредактировать только непосредственно в редакторе атрибутов проекта. Можно сделать проектный атрибут глобальным в два клика. При преобразовании проектного атрибута в глобальный есть возможность переименовать его и изменить настройки обязательности заполнения.

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

Для упрощения работы с постоянными наборами атрибутов можно создавать шаблоны. В разделе "Шаблоны атрибутов" отображаются наборы глобальных атрибутов, которые можно использовать в любом проекте. Таким образом, в проект можно добавлять или удалять из проекта сразу несколько атрибутов, что ускоряет настройку нового проекта.

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

Для создания шаблона атрибутов нужно указать его название, выбрать необходимые атрибуты из списка слева и нажать "Сохранить". Чтобы удалить атрибут из шаблона, достаточно повторно кликнуть на его название или на иконку корзины в правой части плашки добавленного в шаблон атрибута. Также, при создании шаблона доступен поиск глобальных атрибутов по названиям.

Проекты

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

В редакторе ролей есть роль "Руководитель проектов" (Project manager). Пользователь обладающий этой ролью имеет полный доступ к созданию, редактированию, и настройкам проекта, но без доступа к панели администрирования.