Разделы документации
Коннекторы
TestRail
Подключение TestRail к Charo — API-ключ, выбор проектов и тонкая настройка пагинации.
Что индексируется
- Тест-кейсы TestRail по проектам, с метаданными: приоритет, оценка трудозатрат, статус автоматизации; идентификаторы полей преобразуются в читаемые значения.
Коннектор работает и с облачным TestRail (*.testrail.io), и с
инсталляцией TestRail Server в вашем контуре.
Предварительные требования
- TestRail с включённым API (Administration → Site Settings → API → Enable API).
- Учётная запись с доступом на чтение нужных проектов.
Получение учётных данных
- В TestRail откройте My Settings → API Keys и создайте ключ.
- В Charo заполните: TestRail Base URL (например,
https://yourcompany.testrail.ioили адрес вашего сервера), «Имя пользователя или email TestRail» и «API-ключ TestRail».
Настройка в Charo
| Поле | Что указать |
|---|---|
| Идентификаторы проектов | необязательно: ID проектов через запятую; пусто — все проекты |
Расширенные поля (обычно менять не нужно):
| Поле | Что означает |
|---|---|
| Размер страницы кейсов | сколько кейсов забирать за запрос (по умолчанию 250) |
| Макс. страниц | предохранитель от бесконечного обхода (по умолчанию 10000) |
| Лимит символов документа | обрезка очень длинных кейсов (по умолчанию 200000) |
Синхронизация прав
Не поддерживается: управляйте доступом видимостью коннектора и группами (см. «Права доступа»).
Ограничения и частота обновления
- Обновления забираются инкрементально по расписанию коннектора.
- Скорость ограничена лимитами API TestRail (на облачном тарифе — жёстче).
Устранение неполадок
«401 Unauthorized»
Проверьте пару «имя пользователя/email + API-ключ» и что API включён в настройках сайта TestRail.
Индексация обрывается на больших проектах
Уменьшите «Размер страницы кейсов» — большие страницы могут упираться в таймауты сервера TestRail.