Інтеграція з Jira

Інтеграція з Jira показує завдання з Jira в графіку проєкту FlexiProject. Кожен проєкт може отримувати завдання з одного чи кількох проєктів Jira, а список отриманих завдань звужується за типами завдань або за JQL-фільтром. Завдання Jira залишаються синхронізованими з Jira в графіку; їхні поля доступні лише для читання.

Адміністратор вмикає інтеграцію та налаштовує її в розділі Системні налаштування > JIRA (див. Системні налаштування). Зв’язування користувачів Jira з користувачами FlexiProject дає змогу графіку та завантаженню ресурсів показувати власників завдань Jira.

Підключення до Jira

Ключ підключення в Jira

1. У Jira клацніть аватар у верхньому правому куті та виберіть Керувати обліковим записом.
2. Перейдіть на вкладку Безпека і в розділі Токен API натисніть Створити й керувати токенами API.
3. Натисніть Створити токен API, введіть назву (наприклад, «FlexiProject») і натисніть Створити.
4. Скопіюйте згенерований ключ. Jira показує його лише один раз.

Увімкнення інтеграції у FlexiProject

1. Відкрийте Системні налаштування (головне меню) і перейдіть на сторінку JIRA. З’явиться картка Інтеграція з JIRA.
2. Перемкніть інтеграцію на Ввімкнено.
3. У полі Адреса сервера введіть адресу, за якою відкривається Jira вашої організації, наприклад https://name.atlassian.net.
4. У полі E-mail користувача введіть ту саму адресу, під якою у Jira працює користувач, що згенерував ключ.
5. Вставте скопійований ключ у поле Ключ.
6. Натисніть Зберегти. За правильних даних з’явиться повідомлення Підключення до сервера JIRA є правильним; за неправильних — Не вдалося підключитися до сервера JIRA або Неправильна адреса сервера JIRA.

Кнопка Перевірити підключення перевіряє стан підключення в будь-який момент.

Примітка: вимкнення інтеграції через Вимкнено видаляє всі зв’язки проєктів із Jira та всі завдання Jira з графіків. Це не можна скасувати, а щоб увімкнути інтеграцію знову, проєкти доведеться зв’язувати заново.

Зв'язування користувачів Jira

Під параметрами підключення розташована таблиця Користувачі зі стовпцями Ім’я Джира, Ідентифікатор Jira і Користувач (пов’язаний користувач FlexiProject). Фільтр над таблицею звужує список. За активного підключення FlexiProject постійно намагається зв’язати користувачів Jira з користувачами FlexiProject, зіставляючи адреси електронної пошти. Якщо Jira надає адресу електронної пошти й така сама адреса є у FlexiProject, поруч з іменем Jira з’являються аватар і ім’я пов’язаного користувача. Чи надає Jira адреси, залежить від її глобальних налаштувань безпеки та від налаштувань приватності користувача Jira.

Зв’язки, створені автоматично, оновлюються самі. Додані вручну — ні: після зміни прізвища чи адреси електронної пошти їх потрібно виправити вручну.

Зв’язування вручну

1. Наведіть курсор на рядок без пов’язаного користувача й натисніть символ із трьома крапками.
2. Виберіть Підключити. Відкриється вікно Пов’язати користувача.
3. Виберіть користувача FlexiProject і натисніть Зберегти.

Видалення зв’язку

1. Наведіть курсор на рядок із пов’язаним користувачем і натисніть символ із трьома крапками.
2. Виберіть Від’єднати. З’явиться запитання Ви впевнені, що хочете видалити посилання?.
3. Підтвердьте кнопкою Зберегти.

Імпорт списку користувачів Jira

1. Згенеруйте файл CSV із користувачами в адміністративній панелі Atlassian (admin.atlassian.com) на вкладці користувачів командою експорту. Файл має містити поля User id, User name та email.
2. Натисніть Імпорт користувачів Jira під заголовком таблиці. Відкриється вікно імпорту.
3. Виберіть файл або перетягніть його у вікно й натисніть Зберегти. Список користувачів Jira оновиться, а знайдені зв’язки заповняться автоматично.

Рядки з неправильними значеннями пропускаються, а застосунок показує їх списком після імпорту; неправильний файл завершується повідомленням про хибний формат CSV.

Завдання Jira в графіку проєкту

Зв’язування проєкту з Jira

1. Відкрийте проєкт, вкладка Графік.
2. Натисніть Налаштування і виберіть Підключення до JIRA (пункт з’являється після ввімкнення інтеграції). Відкриється вікно Інтеграція з JIRA.
3. Введіть Ключ проєкту Jira. Щоб отримувати завдання з кількох проєктів Jira, введіть ключі через кому.
4. Натисніть Пов’язати. Відкриється вікно Імпорт з JIRA.
5. У частині Завантаження даних виберіть спосіб отримання даних: Тип завдань (лише з одним проєктом Jira) або JQL-фільтр (див. JQL-фільтр).
6. Для типів завдань: позначте типи завдань на рівнях ієрархії (принаймні один тип — інакше з’явиться повідомлення Принаймні один рівень повинен бути позначений), потім натисніть Зберегти. Залежності між типами завдань, коли це можливо, перетворюються на ієрархію завдань у графіку.

Після успішного завантаження завдання Jira з’являються в проєкті, а поруч із назвою проєкту — іконка Jira; клацання на ній відкриває проєкт Jira в новій вкладці. Завантаження може не вдатися, наприклад, якщо користувач, указаний у підключенні, не має прав або JQL містить синтаксичну помилку (Помилка в JQL-запиті). Тоді застосунок показує повідомлення. Ключ, якого не існує або до якого ви не маєте доступу, завершується повідомленням Недійсний ключ проєкту, проєкт не існує або недоступний.

Зміна способу отримання завдань

Та сама команда Підключення до JIRA відкриває вікно Імпорт з JIRA для вже пов’язаного проєкту, де можна змінити типи завдань або JQL-запит.

Видалення завдань Jira з проєкту

1. Відкрийте вікно Імпорт з JIRA командою Підключення до JIRA.
2. Натисніть Видалити і підтвердьте у вікні Видалення прив’язки до JIRA. Повідомлення попереджає, що видалення прив’язки видаляє всі зв’язки в графіку й що ця дія незворотна.

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

JQL-фільтр

JQL (Jira Query Language) дає змогу отримати в проєкті саме ті завдання Jira, які вам потрібні, зокрема з кількох проєктів Jira одночасно.

1. У Jira підготуйте фільтр в інструменті Фільтри. Код JQL стає видимим після перемикання вигляду фільтра з базового на JQL.
2. Скопіюйте код JQL.
3. У FlexiProject у вікні Імпорт з JIRA виберіть JQL-фільтр і вставте код у текстове поле.
4. Натисніть Зберегти.

Запит із синтаксичною помилкою відхиляється з повідомленням Помилка в JQL-запиті. Фільтр впливає лише на те, які завдання потрапляють у графік; під час кожної синхронізації завдання поза результатом фільтра зникають із графіка.

Завдання Jira в графіку

Завдання Jira потрапляють у кінець графіка зі збереженою структурою й мають у графіку іконку Jira. Вони оновлюються автоматично під час періодичної синхронізації; поля, що надходять із Jira, — Назва, Опис, Прогрес, Власник та ієрархія завдань — доступні лише для читання. Змінити прогрес чи власників такого завдання не можна (застосунок повідомляє Неможливо змінити статус завдань, що походять з JIRA і Неможливо змінити власників завдань, що походять з JIRA), а під час клонування проєкту такі завдання не копіюються. Завдання Jira не може бути батьківським для завдань FlexiProject. Завдання під батьківським завданням Jira можна переупорядковувати, а підсумкові завдання Jira разом із їхніми підзавданнями можна вставляти в структуру графіка.

Для пов’язаного проєкту в графіку є три додаткові стовпці: Jira ID (клацання відкриває завдання в Jira в новій вкладці), Статус Jira і Тип Jira. Прогрес завдання випливає з категорії статусу в Jira: до виконання — 0%, у процесі — 50%, виконано — 100%.

Власник завдання походить зі зв’язування користувачів (див. Зв’язування користувачів Jira). Коли користувача Jira пов’язано з користувачем FlexiProject, графік показує його аватар і ім’я, а користувача додано до проєкту. Без зв’язку ви бачите сіру іконку аватара з ім’ям Jira. Графік описано в розділі Графік проєкту.