Інтеграція з Jira дозволяє завантажувати в ITFin задачі по проєктах та дані про трекінг годин працівників. За потреби можна під'єднати декілька Jira-акаунтів (наприклад, якщо клієнт надав вам свій Jira-акаунт для трекінгу розробників, а внутрішні операційні задачі звітуються та відстежуються за допомогою власного Jira-акаунту).

Покрокові налаштування:

Крок 1. 
Створити в Jira користувача, який має необхідні доступи до проєктів (browse projects), списку користувачів (browse users) і даних (або обрати хто це буде з наявних).

Крок 2.
В ITFin в розділі Проєкти > Інтеграції додати нове Джерело (Jira Software).

При натисканні на +Додати інтеграцію система відкриває окрему панель, де можна одразу вибрати вже наявне Джерело для створення інтеграції в межах нього. Також тут можна створити нове Джерело за допомогою нового API ключа, використовуючи іншу чи ту ж трекінг-систему.  

У випадку self-hosted Jira потрібно задати логін (email) та пароль, якщо Jira cloud - логін (email) та ключ API.

Якщо ви використовуєте Tempo - поставте відповідну відмітку та додайте API ключ згенерований в Tempo.

Крок 3.
Налаштувати інтеграцію проєктів в межах доданого джерела.

Потрібно вказати:

Як отримати API ключ з Jira?

Для того, аби отримати API ключ, не потрібно мати роль адміна в Jira, достатньо лише мати доступ до проєктів, задач тощо. Першим кроком зайдіть у налаштування свого профілю:

Перейдіть у розділ Безпека > Токен API > Створення токенів API та керування ними

Та у відкритому вікні натисніть Створити токен API

Якщо при створенні API ключа ви вказуєте дату закінчення його дії — важливо буде створити новий ключ за завершення дії поточного та оновити його в налаштуваннях інтеграції.

Як оновлюються дані з Jira?

• в момент додавання нової інтеграції ми одноразово синхронізуємо всі задачі та всі години від дати старту, яку ви вказали. В залежності від кількості даних це може зайняти від кількох хвилин до години;
• надалі кожну годину запускається автоматичний процес синхронізації, при цьому ми оновлюємо дані за 2 останні тижні. Якщо у вас відбуваються зміни в давнішому періоді - слід запускати ручну синхронізацію за відповідний місяць.

Кнопка Синхронізувати зараз виконує примусову синхронізацію в межах інтеграцій по одному Джерелу за вибраний період.

Після натискання кнопки Синхронізувати зараз запускається примусова синхронізація та кнопка деактивується на деякий час, щоб уникнути перевантаження системи зайвими діями.

Як ITFin ідентифікує користувачів 

Для ідентифікації співробітника в Jira та ITFin система використовує два параметри:

1. Ім’я користувача
2. Email

Якщо імена користувачів у Jira та ITFin будуть відрізнятися і система не зможе їх розпізнати то на рівні джерела буде список Невідомих системі користувачів і потрібно буде асоціювати користувачів 

Асоціація спрацює на рівні всіх інтеграцій, щоб застосувати це для всіх проєктів, що використовують це Джерело.

Як слідкувати за інтеграціями

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

По кожному проєкту можна натиснути та побачити окрему панель з детальною інформацією щодо синхронізації годин. Відразу можна побачити скільки годин ми отримали з трекінг-системи (скільки передає їх API) та скільки записано в ITFin (або не записано якщо немає алокації, не ідентифіковано працівника тощо).

Можна також переглянути загальний звіт по доданому джерелу, де для працівників або проєктів відображаються згруповані ворклоги за вибраний період. Це зручно для загальної перевірки коректності імпорту даних та виявлення можливих проблем.

Q&A

Як зупинити підвантаження трекінгу по інтеграції в межах проєкту?

Можна перевести інтеграцію в статус Inactive (за допомогою перемикача в колонці Status). У цьому випадку подальші синхронізації припиняться, а вже синхронізований трекінг залишиться.    

Також можна перейти в налаштування інтеграції в межах проєкту та встановити кінцеву дату.