Інтеграція з Jira дозволяє завантажувати в ITFin задачі по проєктах та дані про трекінг годин працівників. За потреби можна під'єднати декілька Jira-акаунтів (наприклад, якщо клієнт надав вам свій Jira-акаунт для трекінгу розробників, а внутрішні операційні задачі звітуються та відстежуються за допомогою власного Jira-акаунту).
Покрокові налаштування:
Крок 1.
Створити в Jira користувача, який має необхідні доступи до проєктів і даних (або обрати хто це буде з наявних).
Крок 2.
В ITFin в розділі Компанія > Налаштування > Ключі створити новий ключ. У випадку self-hosted Jira потрібно задати логін та пароль, якщо Jira cloud - логін та ключ Api.
![](/uploads/1/1/2024-03/14/c4c845d5-073c-4532-b5a1-cbebda131e6b..png)
Крок 3.
В кожному проєкті, в який будуть завантажуватися дані з Jira увімкнути інтеграцію (Проєкти > Назва проєкту > Налаштування > Додати інтеграцію).
![](/uploads/1/1/2024-03/14/ac0a15a4-8280-4197-97fd-5db704b1d004..png)
Серед облікових даних потрібно вказати:
Як отримати API ключ з Jira?
Для того, аби отримати API ключ, не потрібно мати роль адміна в Jira, достатньо лише мати доступ до проєктів, задач тощо. Першим кроком зайдіть у налаштування свого профілю:
![](/uploads/1/1/2024-02/15/b6887934-6ab8-440a-936f-521184016a0c..png)
Перейдіть у розділ Безпека>Токен API>Створення токенів API та керування ними
![](/uploads/1/1/2024-02/15/4fc00408-0b26-4e86-ba5b-99c24e4a123f..png)
Та у відкритому вікні натисніть Створити токен API
![](/uploads/1/1/2024-02/15/19a12fd9-6741-4361-a4a6-f1b2801612b9..png)
Як оновлюються дані з Jira?
-
в момент додавання нової інтеграції;
-
кожну годину, але це відбувається не миттєво і час залежить від кількості підключених Jira-інтеграцій, проєкти стають в чергу та оновлюються по черзі.
Налаштування інтеграції
Коли інтеграція успішно здійснена можемо перейти до подальших налаштувань в розділі Проєкт > Назва проєкту > Налаштування.
![](/uploads/1/1/2024-03/15/51458253-1ec8-4b16-a5a9-f375a08ce19e..png)
Опція Синхронізувати зараз дозволяє здійснити позачергову синхронізацію, наприклад, якщо було внесено зміни в Домовленості.
В кожному проєкті є таблиця з періодом та статусом синхронізації. Якщо виникає помилка при завантаженні даних, з'являється червоний трикутник з кількістю помилок.
![](/uploads/1/1/2024-02/15/160e2e8a-d20c-4335-8f37-fa56dd373fd6..png)
Натиснувши на нього можна побачити деталізацію щодо кожної помилки та зрозуміти, як її виправити, аби синхронізація була знову успішною.
![](/uploads/1/1/2024-02/15/15098456-3ab4-46bd-b92c-ad3af00488e6..png)
Для ідентифікації співробітника в Jira та ITFin система використовує два параметри:
-
Ім’я користувача
-
Email
Якщо імена користувачів у Jira та ITFin будуть відрізнятися і система не зможе їх розпізнати тут з’явиться список “not associated users”, потрібно буде обрати користувачів в ITFin, які відповідать нерозпізнаним користувачам Jira та пов’язати їх.
Ignore users - опція, яка дозволяє ігнорувати в ITFin певних користувачів які є в підв’язаній Jira, якщо користувачі не належать до команди й потрібно ігнорувати їх трекінг.
Ознайомтесь детальніше із налаштуваннями інтеграції з Jira у даному відео.