Integráció a JIRA-val

A Jira-integráció a Jira-feladatokat megjeleníti a FlexiProject projekt ütemtervében. Minden projekt egy vagy több Jira-projektből tölthet le feladatokat, a letöltött feladatok listáját pedig feladattípusok vagy JQL-szűrő szűkíti. A Jira-feladatok az ütemtervben szinkronban maradnak a Jira rendszerrel; a mezőik csak olvashatók.

Az integrációt a rendszeradminisztrátor kapcsolja be és konfigurálja a Rendszerbeállítások > JIRA menüpontban (lásd: Rendszerbeállítások). A Jira-felhasználók és a FlexiProject-felhasználók összekapcsolása lehetővé teszi, hogy az ütemterv és az erőforrás-terheltség megmutassa a Jira-feladatok tulajdonosait.

Csatlakozás a Jira rendszerhez

A kapcsolódási kulcs a Jira rendszerben

1. A Jira rendszerben kattintson az avatarra a jobb felső sarokban, és válassza a Fiók kezelése pontot.
2. Lépjen a Biztonság fülre, és az API-token szakaszban kattintson az API-tokenek létrehozása és kezelése lehetőségre.
3. Kattintson az API-token létrehozása gombra, adjon meg egy nevet (például „FlexiProject”), és kattintson a Létrehozás gombra.
4. Másolja ki a létrehozott kulcsot. A Jira csak egyszer mutatja meg.

Az integráció bekapcsolása a FlexiProject alkalmazásban

1. Nyissa meg a Rendszerbeállítások pontot (főmenü), és lépjen a JIRA oldalra. Megjelenik az Integráció a JIRA-val kártya.
2. Állítsa az integrációt Engedélyezve állásba.
3. Töltse ki a Kiszolgáló címe mezőt — azt a címet, amelyen a szervezet Jira rendszere megnyílik, például https://name.atlassian.net.
4. Töltse ki a Felhasználói e-mail mezőt — ugyanazzal az e-mail-címmel, amellyel a kulcsot létrehozó felhasználó be van jelentkezve.
5. Illessze be a kimásolt kulcsot a Kulcs mezőbe.
6. Kattintson a Mentés gombra. Helyes adatok esetén ez az üzenet jelenik meg: A kapcsolat a JIRA szerverrel helyes; helytelen adatok esetén: Nem sikerült csatlakozni a JIRA szerverhez vagy Helytelen JIRA szerver cím.

Az Ellenőrizze a kapcsolatot gombbal bármikor ellenőrizheti a kapcsolat állapotát.

Megjegyzés: ha az integrációt Kikapcsolva állásba kapcsolja, törlődik a projektek összes Jira-kapcsolata és az összes Jira-feladat az ütemtervekből. Ez nem vonható vissza, az újbóli bekapcsoláshoz pedig a projekteket újra össze kell kapcsolni.

Jira-felhasználók összekapcsolása

A kapcsolati paraméterek alatt található a Felhasználók táblázat a Jira neve, ID Jira és Felhasználó (az összekapcsolt FlexiProject-felhasználó) oszlopokkal. A táblázat feletti szűrő szűkíti a listát. Aktív kapcsolat esetén a FlexiProject folyamatosan megpróbálja összekapcsolni a Jira-felhasználókat a FlexiProject-felhasználókkal az e-mail-címek egyezése alapján. Ha a Jira megosztja az e-mail-címet, és ugyanez a cím szerepel a FlexiProject rendszerben, az összekapcsolt felhasználó avatarja és neve a Jira-név mellett jelenik meg. Az, hogy a Jira megosztja-e a címeket, a globális biztonsági beállításaitól és a Jira-felhasználó adatvédelmi beállításaitól függ.

Az automatikusan létrehozott kapcsolatok maguktól frissülnek. A kézzel hozzáadottak nem: vezetéknév vagy e-mail-cím változása után kézzel kell kijavítani őket.

Kézi összekapcsolás

1. Vigye az egérmutatót egy olyan sor fölé, amelyhez nincs összekapcsolt felhasználó, és kattintson a hárompontos szimbólumra.
2. Válassza az Összekötés lehetőséget. Megnyílik a Felhasználó összekapcsolása ablak.
3. Jelölje ki a FlexiProject-felhasználót, és kattintson a Mentés gombra.

Kapcsolat eltávolítása

1. Vigye az egérmutatót egy összekapcsolt felhasználót tartalmazó sor fölé, és kattintson a hárompontos szimbólumra.
2. Válassza a Szétkapcsolás lehetőséget. Megjelenik a kérdés: Biztos, hogy el akarja távolítani a linket?
3. Erősítse meg a Mentés gombbal.

A Jira-felhasználók listájának importálása

1. Hozzon létre CSV-fájlt a felhasználókról az Atlassian adminisztrációs felületén (admin.atlassian.com), a felhasználók lapján, az exportálás paranccsal. A fájlnak tartalmaznia kell a User id, User name és email mezőket.
2. Kattintson a táblázat fejléce alatti Jira felhasználók importja gombra. Megnyílik az importálási ablak.
3. Válassza ki a fájlt, vagy húzza az ablakba, majd kattintson a Mentés gombra. A Jira-felhasználók listája frissül, a megtalált kapcsolatok pedig automatikusan kitöltődnek.

A hibás értékeket tartalmazó sorokat a rendszer kihagyja, az alkalmazás pedig az importálás után felsorolja őket; a hibás fájl a helytelen CSV-formátumról szóló üzenettel végződik.

Jira-feladatok a projekt ütemtervében

Projekt összekapcsolása a Jira rendszerrel

1. Nyissa meg a projektet, az Ütemterv fület.
2. Kattintson a Beállítások gombra, és válassza a Csatlakozás a JIRA-hoz parancsot (az elem akkor látható, ha az integráció be van kapcsolva). Megnyílik az Integráció a JIRA-val ablak.
3. Töltse ki a Jira Projektkulcs mezőt. Ha több Jira-projektből szeretne feladatokat letölteni, a kulcsokat vesszővel elválasztva adja meg.
4. Kattintson a Kapcsolódj gombra. Megnyílik az Import a JIRA-ból ablak.
5. Az Adatok letöltése részben válassza ki az adatok letöltésének módját: Feladatok típusa (csak egy Jira-projekt esetén) vagy JQL szűrő (lásd: JQL szűrő).
6. Feladattípusok esetén: jelölje be a feladattípusokat a hierarchiaszinteken (legalább egy típust — különben megjelenik a Legalább egy szintet meg kell jelölni üzenet), majd kattintson a Mentés gombra. A feladattípusok közötti függőségeket a rendszer lehetőség szerint feladathierarchiává alakítja az ütemtervben.

Sikeres letöltés esetén a Jira-feladatok megjelennek a projektben, a projekt neve mellett pedig Jira-ikon látható; rákattintva a Jira-projekt új lapon nyílik meg. A letöltés sikertelen is lehet, például ha a kapcsolatban megadott felhasználónak nincs jogosultsága, vagy a JQL szintaktikai hibát tartalmaz (Hiba a JQL lekérdezésben). Ilyenkor az alkalmazás üzenetet jelenít meg. A nem létező vagy olyan kulcs, amelyhez nincs hozzáférése, ezzel az üzenettel végződik: Helytelen projektkulcs, a projekt nem létezik, vagy nincs hozzáférése hozzá.

A feladatok letöltési módjának módosítása

Ugyanez a Csatlakozás a JIRA-hoz parancs megnyitja az Import a JIRA-ból ablakot egy már összekapcsolt projekthez, ahol módosíthatja a feladattípusokat vagy a JQL-lekérdezést.

Jira-feladatok eltávolítása a projektből

1. Nyissa meg az Import a JIRA-ból ablakot a Csatlakozás a JIRA-hoz paranccsal.
2. Kattintson a Törlés gombra, és erősítse meg az ablakban, amelynek címe A JIRA link eltávolítása. Az üzenet arra figyelmeztet, hogy a kapcsolat törlése az ütemterv összes kapcsolatát törli, és visszafordíthatatlan.

A törlés után a Jira-feladatok eltűnnek az ütemtervből, a projekt pedig többé nincs a Jira rendszerhez kapcsoltként megjelölve.

JQL szűrő

A JQL (Jira Query Language) lehetővé teszi, hogy pontosan azokat a Jira-feladatokat töltse le egy projektbe, amelyekre szüksége van, akár több Jira-projektből egyszerre.

1. A Jira rendszerben készítsen szűrőt a Szűrők eszközben. A JQL-kód akkor látható, ha a szűrő nézetét az alapról JQL-re váltja.
2. Másolja ki a JQL-kódot.
3. A FlexiProject alkalmazásban, az Import a JIRA-ból ablakban válassza a JQL szűrő lehetőséget, és illessze be a kódot a szövegmezőbe.
4. Kattintson a Mentés gombra.

A szintaktikai hibás lekérdezést a rendszer elutasítja, ezzel az üzenettel: Hiba a JQL lekérdezésben. A szűrő csak azt határozza meg, mely feladatok kerülnek az ütemtervbe; minden szinkronizáláskor a szűrő eredményén kívüli feladatok eltűnnek az ütemtervből.

Jira-feladatok az ütemtervben

A Jira-feladatok a megőrzött szerkezetükkel az ütemterv végére kerülnek, és az ütemtervben Jira-ikont viselnek. Időszakos szinkronizálással maguktól frissülnek; a Jira rendszerből származó mezők — Név, Leírás, Haladás, Tulajdonos és a feladathierarchia — csak olvashatók. Egy ilyen feladat előrehaladását és tulajdonosait nem módosíthatja (az alkalmazás ezt jelzi: A JIRA-ból származó feladatok státuszát nem lehet megváltoztatni. illetve A JIRA-ból származó feladatok tulajdonosainak megváltoztatása nem lehetséges.), és az ilyen feladatokat a projekt klónozásakor nem másolja a rendszer. Jira-feladat nem lehet FlexiProject-feladatok szülője. A Jira szülőfeladat alatti feladatok sorrendje módosítható, a Jira összesítő feladatok pedig alfeladataikkal együtt beilleszthetők az ütemterv szerkezetébe.

Összekapcsolt projektben az ütemterv három további oszlopot tartalmaz: Jira azonosító (kattintásra a feladat új lapon nyílik meg a Jira rendszerben), Jira állapot és Jira típus. A feladat előrehaladása a Jira állapotkategóriájából következik: teendő — 0%, folyamatban — 50%, kész — 100%.

A feladat tulajdonosa a felhasználók összekapcsolásából származik (lásd: Jira-felhasználók összekapcsolása). Ha egy Jira-felhasználó össze van kapcsolva egy FlexiProject-felhasználóval, az ütemterv megmutatja az avatarját és a nevét, a felhasználó pedig hozzáadódik a projekthez. Összekapcsolás nélkül szürke avatarikon látható a Jira-névvel. Az ütemtervet a Projekt ütemterve oldal írja le.