Integracja z Jira

Integracja z Jira wyświetla zadania z Jira w harmonogramie projektu FlexiProject. Każdy projekt może pobierać zadania z jednego lub kilku projektów Jira, a listę pobieranych zadań zawęża się typami zadań albo filtrem JQL. Zadania z Jira zostają w harmonogramie zsynchronizowane z Jira; ich pola tylko się odczytuje.

Integrację włącza i konfiguruje administrator w Ustawieniach systemowych > Jira (zobacz Ustawienia systemowe). Powiązanie użytkowników Jira z użytkownikami FlexiProject pozwala pokazać właścicieli zadań z Jira w harmonogramie i w obciążeniu zasobów.

Połączenie z Jira

Klucz połączenia w Jira

1. W Jira należy kliknąć awatar w prawym górnym rogu i wybrać Zarządzaj swoim kontem. Otworzy się strona konta.
2. Następnie należy przejść do zakładki Bezpieczeństwo, a w sekcji Token API kliknąć Utwórz tokeny API i nimi zarządzaj. Wyświetli się lista tokenów.
3. Po kliknięciu przycisku Utwórz token API należy wpisać nazwę (na przykład „FlexiProject”) i kliknąć Utwórz. Jira wygeneruje klucz.
4. Na koniec należy skopiować wygenerowany klucz. Jira pokazuje go tylko raz.

Włączenie integracji we FlexiProject

1. Należy otworzyć Ustawienia systemowe (menu główne) i przejść do strony Jira. Wyświetli się karta Integracja z JIRA.
2. Następnie należy przełączyć integrację na Włączony. Pojawią się pola połączenia.
3. Należy wpisać Adres serwera — adres, pod którym otwiera się Jira organizacji, na przykład https://nazwa.atlassian.net.
4. Należy wpisać adres Email użytkownika — ten sam, którym zalogowany jest użytkownik, który wygenerował klucz.
5. Skopiowany klucz należy wkleić w pole Klucz.
6. Po kliknięciu przycisku Zapisz przy poprawnych danych pojawi się komunikat Połączenie z serwerem JIRA jest poprawne, a przy błędnych — Nie udało się połączyć z serwerem JIRA albo Niepoprawny adres serwera JIRA.

Aby sprawdzić stan połączenia w dowolnej chwili, należy kliknąć przycisk Sprawdź połączenie.

Uwaga: wyłączenie integracji przełącznikiem Wyłączony usuwa wszystkie powiązania projektów z Jira i wszystkie zadania Jira z harmonogramów. Nie można tego cofnąć, a ponowne włączenie wymaga ponownego powiązania projektów.

Powiązanie użytkowników Jira

Pod parametrami połączenia jest tabela Użytkownicy z kolumnami Nazwa Jira, ID Jira i Użytkownik (powiązany użytkownik FlexiProject). Filtr nad tabelą zawęża listę. Przy aktywnym połączeniu FlexiProject na bieżąco próbuje powiązać użytkowników Jira z użytkownikami FlexiProject po zgodności adresów e-mail. Gdy Jira udostępnia adres e-mail, a taki adres jest we FlexiProject, obok nazwy Jira widać awatar i nazwę powiązanego użytkownika. To, czy Jira udostępnia adresy, zależy od jej globalnych ustawień bezpieczeństwa i od ustawień prywatności użytkownika Jira.

Powiązania powstałe automatycznie aktualizują się same. Powiązania dodane ręcznie nie: po zmianie nazwiska albo adresu e-mail trzeba je poprawić ręcznie.

Ręczne powiązanie

1. Należy najechać na wiersz bez powiązanego użytkownika i kliknąć symbol trzech kropek.
2. Po wybraniu pozycji Powiąż otworzy się okno Powiązanie użytkownika.
3. Należy wskazać użytkownika FlexiProject i kliknąć Zapisz. Powiązanie pojawi się w wierszu.

Usunięcie powiązania

1. Należy najechać na wiersz z powiązanym użytkownikiem i kliknąć symbol trzech kropek.
2. Po wybraniu pozycji Rozłącz pojawi się pytanie Czy na pewno chcesz usunąć powiązanie?
3. Po kliknięciu przycisku Zapisz powiązanie zostanie usunięte.

Import listy użytkowników Jira

1. Należy wygenerować plik CSV z użytkownikami w panelu administracyjnym Atlassian (admin.atlassian.com), w zakładce użytkowników, poleceniem eksportu. Plik musi zawierać pola User id, User name i email.
2. Po kliknięciu przycisku Import użytkowników JIRA pod nagłówkiem tabeli otworzy się okno importu.
3. Następnie należy wskazać plik albo przeciągnąć go do okna i kliknąć Zapisz. Lista użytkowników Jira zostanie zaktualizowana, a znalezione powiązania uzupełnią się automatycznie.

Wiersze z błędnymi wartościami są pomijane, a aplikacja wymienia je po imporcie; niepoprawny plik kończy się komunikatem o niepoprawnym formacie CSV.

Zadania Jira w harmonogramie projektu

Powiązanie projektu z Jira

1. Należy otworzyć projekt i przejść do zakładki Harmonogram.
2. Po kliknięciu przycisku Ustawienia należy wybrać Połączenie z JIRA (pozycja jest widoczna po włączeniu integracji). Otworzy się okno Integracja z JIRA.
3. Należy wpisać Klucz projektu Jira. Aby pobrać zadania z kilku projektów Jira, należy wpisać klucze po przecinku.
4. Po kliknięciu przycisku Połącz otworzy się okno Import z JIRA.
5. Następnie w części Pobieranie danych należy wybrać sposób pobierania: Typ zadań (tylko przy jednym projekcie Jira) albo Filtr JQL (zobacz Filtr JQL).
6. Przy typie zadań należy zaznaczyć typy zadań na poziomach hierarchii (co najmniej jeden typ — inaczej pojawi się komunikat Co najmniej jeden poziom musi być zaznaczony), a potem kliknąć Zapisz. Zależności między typami zadań zostaną zamienione na hierarchię zadań w harmonogramie, gdy to możliwe, a zadania Jira pojawią się w harmonogramie projektu.

Gdy pobranie się powiedzie, w projekcie pojawiają się zadania Jira, a obok nazwy projektu — ikona Jira; jej kliknięcie otwiera projekt Jira w nowej karcie. Pobranie może się nie udać, na przykład z powodu braku uprawnień użytkownika podanego w połączeniu albo błędu składni JQL (Błąd w zapytaniu JQL). Aplikacja pokazuje wtedy komunikat. Klucz, który nie istnieje albo do którego brakuje dostępu, kończy się komunikatem Niepoprawny klucz projektu, projekt nie istnieje lub nie masz do niego dostępu.

Zmiana sposobu pobierania

Po wybraniu polecenia Połączenie z JIRA w projekcie już powiązanym otworzy się okno Import z JIRA, w którym można zmienić typy zadań albo zapytanie JQL.

Usunięcie zadań Jira z projektu

1. Należy wybrać polecenie Połączenie z JIRA. Otworzy się okno Import z JIRA.
2. Po kliknięciu przycisku Usuń należy potwierdzić w oknie Usunięcie powiązania z JIRA. Komunikat ostrzega, że usunięcie powiązania usuwa wszystkie powiązania na harmonogramie, i że jest nieodwracalne.

Po usunięciu zadania Jira znikają z harmonogramu, a projekt przestaje być oznaczony jako połączony z Jira.

Filtr JQL

JQL (Jira Query Language) pozwala pobrać do projektu dokładnie te zadania Jira, które są potrzebne, także z kilku projektów Jira naraz.

1. W Jira, w narzędziu Filtry, należy przygotować filtr. Kod JQL pojawi się po przełączeniu widoku filtra z podstawowego na JQL.
2. Następnie należy skopiować kod JQL.
3. We FlexiProject, w oknie Import z JIRA, należy wybrać Filtr JQL i wkleić kod w pole tekstowe.
4. Po kliknięciu przycisku Zapisz do harmonogramu trafią zadania spełniające filtr.

Zapytanie z błędem składni jest odrzucane komunikatem Błąd w zapytaniu JQL. Filtr wpływa tylko na to, które zadania trafiają do harmonogramu; przy każdej synchronizacji zadania spoza wyniku filtra znikają z harmonogramu.

Zadania z Jira w harmonogramie

Zadania z Jira trafiają na koniec harmonogramu z zachowaniem struktury i mają w harmonogramie ikonę Jira. Aktualizują się automatycznie w cyklicznej synchronizacji; pola pochodzące z Jira: Nazwa, Opis, Postęp, Właściciel i hierarchia zadań są tylko do odczytu. Nie można zmienić postępu ani właścicieli takiego zadania (komunikaty Nie można zmienić statusu zadań pochodzących z JIRA i Nie można zmienić właścicieli zadań pochodzących z JIRA), a przy klonowaniu projektu takie zadania się nie kopiują. Zadanie z Jira nie może być zadaniem nadrzędnym dla zadań FlexiProject. Kolejność zadań w zadaniu nadrzędnym Jira można zmieniać, a zadania zbiorcze Jira z podrzędnymi można wstawiać w strukturę harmonogramu.

Przy powiązanym projekcie w harmonogramie są trzy dodatkowe kolumny: Jira Id (kliknięcie otwiera zadanie w Jira w nowej karcie), Status Jira i Typ Jira. Postęp zadania wynika z kategorii statusu w Jira: do zrobienia — 0%, w toku — 50%, gotowe — 100%.

Właściciel zadania pochodzi z powiązania użytkowników (zobacz Powiązanie użytkowników Jira). Gdy użytkownik Jira jest powiązany z użytkownikiem FlexiProject, w harmonogramie widać jego awatar i nazwę, a użytkownik zostaje dodany do projektu. Bez powiązania widać szarą ikonę awatara z nazwą z Jira. Harmonogram opisuje dział Harmonogram projektu.