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

Перед тим як підключати інтеграцію, спочатку обов'язково мають бути створені необхідні проєкти та додані домовленості працівникам, в інакшому випадку години будуть підтягуватись без асоціації з юзером в ITFin. Синхронізація відбувається щодня за останні 30 днів, і якщо додати асоціацію пізніше, ніж підключення самої інтеграції, частина трекінгу може не потрапити до системи.

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

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

Крок 2.
В ITFin в розділі Компанія > Налаштування > Ключі створити новий ключ. У випадку self-hosted Jira потрібно задати логін та пароль, якщо Jira cloud - логін та ключ Api.

Крок 3.
В кожному проєкті, в який будуть завантажуватися дані з Jira увімкнути інтеграцію (Проєкти > Назва проєкту > Налаштування > Додати інтеграцію). 

Серед облікових даних потрібно вказати:

Поле 
Опис
Початок*
Дата, від якої розпочнеться підвантаження даних в ITFin
Кінець
Кінець інтеграції
Jira URL*
URL домену
Ключі*
Обрати раніше створену keychain або вручну ввести логін і пароль/API ключ

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

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

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

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

Ми радимо використовувати саме створену keychain у налаштуваннях проєктів, адже в такому разі при зміні пароля в Jira достатньо буде внести зміни в keychain в Компанія > Налаштування > Ключі, щоб оновити дані у всіх проєктах. У зворотному випадку, коли в налаштуваннях інтеграції по проєкту не задано keychain, а налаштовано інтеграцію вручну через логін і пароль/API ключ, при зміні пароля в Jira потрібно буде вносити зміни у налаштування кожного проєкту.

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

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

Налаштування інтеграції

Коли інтеграція успішно здійснена можемо перейти до подальших налаштувань в розділі Проєкт > Назва проєкту > Налаштування.

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

Перша синхронізація розпочинається відразу після додавання інтеграції і опція Sync now з'явиться після її завершення.

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

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

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

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

Якщо імена користувачів у Jira та ITFin будуть відрізнятися і система не зможе їх розпізнати тут з’явиться список “not associated users”, потрібно буде обрати користувачів в ITFin, які відповідать нерозпізнаним користувачам Jira та пов’язати їх.

Ignore users - опція, яка дозволяє ігнорувати в ITFin певних користувачів які є в підв’язаній Jira, якщо користувачі не належать до команди й потрібно ігнорувати їх трекінг.

ITFin враховує обмеження з agreements, тому для коректного відображення трекінгу важливо, щоб там було вірно задано по працівниках Start date, тип Billable/NonbillableAllocation тощо.  Внесені зміни в Agreement будуть показані в трекінгу після чергової синхронізації з Jira.

Ознайомтесь детальніше із налаштуваннями інтеграції з Jira у даному відео.


Останній раз змінено