Integrace s JIRA

Integrace s Jira zobrazuje úkoly z Jira v harmonogramu projektu FlexiProject. Každý projekt může stahovat úkoly z jednoho nebo z několika projektů Jira a seznam stažených úkolů se zužuje podle typů úkolů nebo filtrem JQL. Úkoly z Jira zůstávají v harmonogramu synchronizované s Jira; jejich pole jsou jen ke čtení.

Správce integraci zapíná a nastavuje v Nastavení systému > JIRA (viz Nastavení systému). Propojení uživatelů Jira s uživateli FlexiProject umožní, aby harmonogram a vytížení zdrojů ukazovaly majitele úkolů z Jira.

Připojení k Jira

Klíč pro připojení v Jira

1. V Jira klikněte na avatar v pravém horním rohu a zvolte Spravovat účet.
2. Přejděte na záložku Zabezpečení a v části Token API klikněte na Vytvořit a spravovat tokeny API.
3. Klikněte na Vytvořit token API, zadejte název (například „FlexiProject“) a klikněte na Vytvořit.
4. Zkopírujte vygenerovaný klíč. Jira ho zobrazí pouze jednou.

Zapnutí integrace ve FlexiProject

1. Otevřete Nastavení systému (hlavní menu) a přejděte na stránku JIRA. Zobrazí se karta Integrace s JIRA.
2. Přepněte integraci na Zapnuto.
3. Zadejte Adresa serveru — adresu, na které se otevírá Jira vaší organizace, například https://name.atlassian.net.
4. Zadejte E-mail uživatele — stejný, jakým je přihlášen uživatel, který klíč vygeneroval.
5. Do pole Klíč vložte zkopírovaný klíč.
6. Klikněte na Uložit. Při správných údajích se zobrazí zpráva Připojení k serveru JIRA je správné, při nesprávných Nepodařilo se připojit k serveru JIRA nebo Nesprávná adresa serveru JIRA.

Tlačítko Zkontrolujte připojení zjistí stav připojení kdykoli.

Poznámka: vypnutí integrace volbou Vypnuto odstraní z harmonogramů všechna propojení projektů s Jira i všechny úkoly z Jira. Tuto akci nelze vrátit a po opětovném zapnutí je nutné projekty propojit znovu.

Propojení uživatelů Jira

Pod parametry připojení je tabulka Uživatelé se sloupci Název systému Jira, ID Jira a Uživatel (propojený uživatel FlexiProject). Filtr nad tabulkou zužuje seznam. Při aktivním připojení se FlexiProject snaží propojit uživatele Jira s uživateli FlexiProject podle e-mailových adres. Pokud Jira e-mailovou adresu sdílí a stejná adresa existuje ve FlexiProject, objeví se vedle názvu z Jira avatar a jméno propojeného uživatele. Zda Jira adresy sdílí, závisí na jejím globálním nastavení zabezpečení a na nastavení soukromí uživatele Jira.

Propojení vytvořená automaticky se aktualizují sama. Propojení přidaná ručně se neaktualizují: po změně příjmení nebo e-mailové adresy je musíte opravit ručně.

Ruční propojení

1. Najeďte myší na řádek bez propojeného uživatele a klikněte na symbol tří teček.
2. Zvolte Připojit. Otevře se okno Propojení uživatele.
3. Vyberte uživatele FlexiProject a klikněte na Uložit.

Odebrání propojení

1. Najeďte myší na řádek s propojeným uživatelem a klikněte na symbol tří teček.
2. Zvolte Odpojit. Zobrazí se otázka Určitě chcete odkaz odstranit?
3. Potvrďte tlačítkem Uložit.

Import seznamu uživatelů Jira

1. V panelu správy Atlassian (admin.atlassian.com) vygenerujte na záložce uživatelů příkazem exportu soubor CSV s uživateli. Soubor musí obsahovat pole User id, User name a email.
2. Klikněte na Dovoz uživatelů Jira pod záhlavím tabulky. Otevře se okno importu.
3. Vyberte soubor nebo ho přetáhněte do okna a klikněte na Uložit. Seznam uživatelů Jira se aktualizuje a nalezená propojení se vyplní automaticky.

Řádky s nesprávnými hodnotami se přeskočí a aplikace je po importu vypíše; nesprávný soubor skončí zprávou o chybném formátu CSV.

Úkoly z Jira v harmonogramu projektu

Propojení projektu s Jira

1. Otevřete projekt, záložku Harmonogram.
2. Klikněte na Nastavení a zvolte Připojení k JIRA (položka je viditelná po zapnutí integrace). Otevře se okno Integrace s JIRA.
3. Zadejte Klíč k projektu z Jira. Chcete-li stahovat úkoly z několika projektů Jira, zadejte klíče oddělené čárkami.
4. Klikněte na Propojit. Otevře se okno Dovoz z JIRA.
5. V části Stahování dat zvolte způsob stahování dat: Typ úkolů (pouze s jedním projektem Jira) nebo Filtr JQL (viz Filtr JQL).
6. U typů úkolů: zaškrtněte typy úkolů na úrovních hierarchie (alespoň jeden typ — jinak se zobrazí zpráva Musí být označena alespoň jedna úroveň) a potom zvolte Uložit. Závislosti mezi typy úkolů se v harmonogramu převedou na hierarchii úkolů, pokud je to možné.

Pokud stažení uspěje, úkoly z Jira se objeví v projektu a vedle názvu projektu se zobrazí ikona Jira; kliknutím na ni se projekt Jira otevře na nové záložce. Stažení se může nezdařit, například když uživatel zadaný v připojení nemá oprávnění nebo když má JQL syntaktickou chybu (Chyba v dotazu JQL). Aplikace pak zobrazí zprávu. Klíč, který neexistuje nebo ke kterému nemáte přístup, skončí zprávou Nesprávný klíč projektu, projekt neexistuje nebo k němu nemáte přístup.

Změna způsobu stahování úkolů

Stejný příkaz Připojení k JIRA otevře u již propojeného projektu okno Dovoz z JIRA, ve kterém změníte typy úkolů nebo dotaz JQL.

Odstranění úkolů z Jira z projektu

1. Otevřete okno Dovoz z JIRA příkazem Připojení k JIRA.
2. Klikněte na Odstranit a potvrďte v okně Odstranění odkazu na JIRA. Zpráva upozorňuje, že odstranění odkazu smaže všechna propojení v harmonogramu a že je nevratné.

Po odstranění úkoly z Jira z harmonogramu zmizí a projekt už není označen jako propojený s Jira.

Filtr JQL

JQL (Jira Query Language) umožňuje stáhnout do projektu přesně ty úkoly z Jira, které potřebujete, i z několika projektů Jira najednou.

1. V Jira připravte filtr v nástroji Filtry. Kód JQL je vidět po přepnutí zobrazení filtru ze základního na JQL.
2. Zkopírujte kód JQL.
3. Ve FlexiProject v okně Dovoz z JIRA zvolte Filtr JQL a vložte kód do textového pole.
4. Klikněte na Uložit.

Dotaz se syntaktickou chybou je odmítnut zprávou Chyba v dotazu JQL. Filtr ovlivňuje pouze to, které úkoly se dostanou do harmonogramu; při každé synchronizaci úkoly mimo výsledek filtru z harmonogramu zmizí.

Úkoly z Jira v harmonogramu

Úkoly z Jira se zařadí na konec harmonogramu se zachovanou strukturou a mají v harmonogramu ikonu Jira. Aktualizují se automaticky při pravidelné synchronizaci; pole, která pocházejí z Jira — Název, Popis, Pokrok, Majitel a hierarchie úkolů — jsou jen ke čtení. Pokrok ani majitele takového úkolu nezměníte (aplikace hlásí Není možné měnit stav úkolů pocházejících ze systému JIRA. a Není možné měnit vlastníky úkolů pocházejících z JIRA) a takové úkoly se při klonování projektu nekopírují. Úkol z Jira nemůže být nadřazeným úkolem úkolů FlexiProject. Pořadí úkolů pod nadřazeným úkolem z Jira můžete měnit a souhrnné úkoly z Jira s jejich dílčími úkoly lze vložit do struktury harmonogramu.

U propojeného projektu má harmonogram tři další sloupce: Jira ID (kliknutím se úkol otevře v Jira na nové záložce), Stav Jira a Typ Jira. Pokrok úkolu vyplývá z kategorie stavu v Jira: k provedení — 0 %, probíhá — 50 %, hotovo — 100 %.

Majitel úkolu vychází z propojení uživatelů (viz Propojení uživatelů Jira). Když je uživatel Jira propojen s uživatelem FlexiProject, harmonogram ukazuje jeho avatar a jméno a uživatel je přidán do projektu. Bez propojení vidíte šedou ikonu avatara s názvem z Jira. Harmonogram je popsán v části Harmonogram projektu.