Построение отчетов по данным YouTrack через REST API

29.06.22

Учетные задачи - Консолидация данных

Подсистема для построения гибких отчетов в 1С по данным из YouTrack.

Скачать файл

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование По подписке [?] Купить один файл
Построение отчетов по данным YouTrack через REST API, конфигурация:
.cf 115,40Kb
8
8 Скачать (5 SM) Купить за 3 050 руб.
Построение отчетов по данным YouTrack через REST API, расширение конфигурации:
.cfe 46,25Kb
2
2 Скачать (5 SM) Купить за 3 050 руб.

YouTrack - удобная система для багтрекинга и управления проектами. У неё есть множество плюсов, но есть и очевидный минус. Отчеты, предоставляемые YouTrack'ом не отличаются гибкостью в настройке и удобством в использовании. Данная разработка решает эту проблему с помощью механизма СКД.

 

Возможности подсистемы

  • В отчете можно получить все данные шапки по задачам (issue) из YouTrack, комментарии, а также отмеченное время работы над задачами.
  • В настройках можно указать произвольный фильтр задач в виде запроса на языке YouTrack, чтобы заранее фильтровать получаемые данные. Это также может быть полезно с точки зрения ограничения доступа к данным.
  • Для каждого получаемого поля можно обозначить его поведение на уровне группировки отчета - суммировать числовые поля, брать максимальное/минимальное/среднее значение, количество записей.
  • По щелчку на поле "ID" можно сразу попасть в YouTrack.
  • Простые настройки, которые нужно сделать перед началом работы. А также простая модификация настроек при изменении состава полей в YouTrack.

 

Интерфейс

 

 

Отчет стандартного вида, находится в подсистеме YouTrack - Отчеты - Отчет YT. В настройках (в рамке) можно корректировать группировки, поля, отборы. У отчета четыре предопределённых варианта (по кнопке "Выбрать вариант"):

 

 

  • Основной - по умолчанию выведено только поле ID задачи. В быстрых настройках можно добавлять поля и группировки.
  • Комментарии - Выведена группировка по ID задачи со всеми комментариями к каждой.
  • Работы по задачам - По каждой задаче выведены все отмеченные в TouTrack работы: автор, дата, комментарий.
  • Произвольный - для настройки собственных вариантов через "Изменить вариант". Возможности настройки ограничены только функциональностью СКД.

Настройки отчета по кнопке Изменить вариант:

 

 

Внедрение и настройка

Внедрение и настройка разработки состоит из четырёх этапов:

1. Подсистему можно внедрить в двух вариантах: как часть конфигурации или как отдельное расширение. Разработка автономна, для неё не требуется БСП.

2. Получение токена для подключения к YouTrack. Для этого нужно зайти в YouTrack - Профиль пользователя - Безопасность аккаунта - Новый токен. Скопируйте выданный токен, он пригодится на следующем этапе.

 

 

3. В подсистеме YouTrack нужно открыть обработку Сервис - Настройки публикации YT. В открывшейся форме последовательно указать:

 

 

  • Путь к YouTrack.
  • Токен, полученный ранее.
  • Часовой пояс.
  • Число задач в пачке, которые YouTrack позволяет получить через API за один вызов. 

Нажать кнопку Установить.

4. Открыть пункт меню YouTrack - Настройки полей YT. 

 

 

В поле Запрос можно указать фильтр по задачам, по которому отчет будет получать данные из YouTrack. Фильтр указывается в нотации языка запросов YouTrack. Далее нужно нажать кнопку Заполнить, чтобы получить все поля, которые будут затем использоваться в отчете. 

Внимание! Если у пользователя YouTrack, токен которого вы используете, нет прав администратора, поля придётся заполнить вручную.

 

 

Правила заполнения таблицы полей:

  • Колонка Поле должна содержать точное наименование поля из Youtrack.
  • В колонке Представление можно указать представление поля, именно так оно будет называться в отчете. Если представление не указано - будет использоваться наименование поля.
  • В колонке Тип указывается тип, к которому будет приведено значение поля, полученного из Youtrack.
  • В колонке Роль указывается роль поля:

    "Поле" - поле можно будет использовать для вывода значения и в группировке (если тип поля не "Строка неограниченная").

    "Ресурс" - значения поля на разных уровнях группировки будут агрегироваться указанным способом. Например, на уровне группировки будет сумма подчиненных строк. Или максимальное значение.

После заполнения таблицы нужно нажать кнопку Записать и закрыть.

 

Техническая информация

  1. Разработано на платформе 8.3.19.
  2. Версия YouTrack 2022.1. На остальных не тестировалось.

отчеты youtrack подсистема rest api

См. также

WEB-интеграция Администрирование веб-серверов Платные (руб)

Веб-портал обеспечивает удобный доступ к конфигурации 1С:ITIL(ИТИЛ), 1С:ITILIUM, Управление IT-отделом 8 через интернет с любого устройства посредством браузера, увеличивая эффективность работы пользователей и снижая нагрузку на сервер. Быстрая инсталляция портала за пару часов, удобный и интуитивно понятный интерфейс и безопасность данных помогут упростить работу с порталом и ускорить выполнение бизнес-процессов компании.

128000 руб.

19.12.2023    2845    3    0    

11

WEB-интеграция Анализ продаж Системный администратор Программист Пользователь Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Управленческий учет Платные (руб)

Модуль "Подсистема интеграции AmoCRM с 1С" позволяет обеспечить единое информационное пространство, в котором пользователи могут эффективно управлять клиентской базой, следить за статусами сделок и поддерживать актуальность данных как в AmoCRM, так и в 1С.

60000 руб.

07.05.2019    34911    68    45    

27

Оптовая торговля Розничная торговля WEB-интеграция 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

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

57600 руб.

26.11.2024    2602    2    3    

5

WEB-интеграция Программист Бизнес-аналитик Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

Модуль "Экспортер" — это расширение для 1С, предназначенное для автоматизации процессов выгрузки данных. Оно позволяет эффективно извлекать, преобразовывать и передавать данные из систем 1С в интеграционную платформу Spot2D. Подсистема упрощает настройку, снижает количество ручных операций и обеспечивает удобный контроль данных.

14400 руб.

20.12.2024    978    5    2    

7

Сайты и интернет-магазины WEB-интеграция Системный администратор Программист Пользователь Платформа 1С v8.3 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020    19198    23    22    

20

WEB-интеграция Программист Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021    18964    54    50    

31

WEB-интеграция Программист Руководитель проекта Платформа 1С v8.3 1C:Бухгалтерия 1С:Франчайзи, автоматизация бизнеса Платные (руб)

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки.

24000 руб.

27.09.2024    4389    3    2    

4
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. PLAstic 296 30.06.22 09:52 Сейчас в теме
Жаль, что больше не актуально. :) Джетбрейнс ушли из РФ, как и Атлассиан. Гудбай, америка, ооо...

Не нашёл раздела "Настройка синхронизации сущностей". Получается, мы должны использовать эту функциональность как отдельностоящую конфу без возможности интеграции с чем бы то ни было. Я в своё время прикрутил это к ДО, у нас там был учёт трудозатрат.
Рекомендую добавить в описание и реализацию получение идов объектов YT для возможности синхронизации с чем угодно из парка 1С. Это повысит ценность статьи. Не все умеют в API.
McFlaren; +1 Ответить
2. McFlaren 12 30.06.22 19:28 Сейчас в теме
(1)
Ну почему же не актуально) Может, кто-то не из России заинтересуется, а может, кто-то использует YouTrack локально. Есть же такая опция)
По поводу синхронизации. Эта разработка - не полная синхронизация. Это - универсальный отчёт для получения данных напрямую из YT. Поэтому можно прикручивать его к любой конфе, не важно какие сущности там есть.
Я как раз ставил перед собой задачу максимального упрощения для пользователя визуализации данных из YT. Без постоянного обращения к техническим специалистам вроде "У меня в YT одни данные, а в 1С другие, разберитесь с синхронизацией") И решением было отказаться от синхронизации сущностей, получать данные напрямую в момент запроса. Из минусов подхода - поля в отчете только примитивных типов. Вместо отбора "Исполнитель = Иванов И.И. (Ссылка на справочник Исполнителей)" будет отбор "Исполнитель Содержит "Иванов И.И." (Строка)". Из плюсов - нет лага синхронизации, нет коллизий синхронизации, нет усложнения интерфейса всеми сущностями (в том числе доп. полями, конечно). Для целей получения отчёта - разумный компромисс.
Если же нужна полная синхронизация - сделаю отдельную публикацию, такой опыт тоже есть. Но, как вы и сказали, вопрос в актуальности)
11. Vovan58 64 27.11.23 16:14 Сейчас в теме
(1) Все качается. И как не актуально? Уж способ купить найдёте :)
3. vavka 6 20.01.23 16:47 Сейчас в теме
Существует в природе описание API YT?
4. McFlaren 12 20.01.23 17:49 Сейчас в теме
(3) Да
https://www.jetbrains.com/help/youtrack/devportal/youtrack-dev-portal.html
Там специфическая навигация, но разобраться можно.
Ponommax; vavka; +2 Ответить
5. пользователь 31.01.23 20:41
Сообщение было скрыто модератором.
...
6. XGRAF 07.07.23 14:19 Сейчас в теме
есть необходимость не читать, а программно создавать задачи(Issues) задним числом
через API получается это делать из 1С, но загвоздка с датой, её нельзя менять, она устанавливается текущей датой
не сталкивались ли вы с такой проблемой, возможно есть идеи как её можно изменить?
7. McFlaren 12 07.07.23 18:07 Сейчас в теме
(6)
Да, сталкивался, поле даты создания Read-Only. Решение - обходной путь в виде создания отдельного кастомного поля для нужной даты, которую можно менять. Могу лишь предположить, что команда YT решила, что создание задач задним числом - нонсенс)
8. terminalshik 13.08.23 19:41 Сейчас в теме
Всем привет!
Подскажите пожалуйста, возможно ли получать информацию по затраченному времени не по конкретным задачам, а как то сразу по всем за период? В API ничего подобного не удалось найти, кроме как api/issues/{задача}/timeTracking.
9. McFlaren 12 14.08.23 17:05 Сейчас в теме
(8)
Да, в разработке я как раз использовал отдельный метод
https://www.jetbrains.com/help/youtrack/devportal/resource-api-workItems.html
api/workItems?query=...
Попробуйте его.
terminalshik; +1 Ответить
10. terminalshik 14.08.23 19:46 Сейчас в теме
(9)
Спасибо большое!
Уже вышел на этот метод, через консоль разработчика в браузере.
А теперь, благодаря вам, вижу и его описание.
Оставьте свое сообщение