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. Seznam stažených úkolů lze zúžit podle typů úkolů nebo filtrem JQL.

Úkoly z Jira v harmonogramu se s Jira pravidelně synchronizují a jejich pole jsou jen pro čtení.

Správce integraci zapíná a nastavuje v nabídce Nastavení systému na záložce JIRA (viz Nastavení systému). Propojení uživatelů Jira s uživateli FlexiProject umožní zobrazit majitele úkolů z Jira v harmonogramu a ve vytížení zdrojů.

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. Otevře se stránka účtu.
  2. Přejděte na záložku Zabezpečení a v části Token API klikněte na Vytvořit a spravovat tokeny API. Zobrazí se seznam tokenů.
  3. Klikněte na Vytvořit token API, zadejte název (například „FlexiProject“) a klikněte na Vytvořit. Jira vygeneruje klíč.
  4. Zkopírujte vygenerovaný klíč. Jira ho zobrazí pouze jednou.

Zapnutí integrace ve FlexiProject

  1. V hlavní nabídce zvolte Nastavení systému a přejděte na záložku JIRA. Zobrazí se stránka Integrace s JIRA.
  2. Přepněte integraci na Zapnuto. Zobrazí se pole pro připojení.
  3. Zadejte Adresa serveru, tedy adresu, na které se otevírá Jira vaší organizace, například https://name.atlassian.net.
  4. Zadejte E-mail uživatele. Musí to být e-mailová adresa, kterou se do Jira přihlašuje osoba, která klíč vygenerovala.
  5. Do pole Klíč vložte zkopírovaný klíč.
  6. Klikněte na Uložit. Systém ověří, že je server dostupný, a nastavení uloží. Zobrazí se zpráva Změny uloženy. Při nesprávné adrese serveru se zobrazí zpráva: Nesprávná adresa serveru JIRA

Stav připojení můžete kdykoli zkontrolovat tlačítkem Zkontrolujte připojení. Systém zobrazí zprávu: Připojení k serveru JIRA je správné nebo Nepodařilo se připojit k serveru JIRA

System settings, Jira tab with the server address, user e-mail and key fields and the Test connection button highlighted

Upozornění: 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 zapnuté integraci FlexiProject pravidelně stahuje uživatele z Jira a propojuje je 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. Uživatelé Jira bez sdílené e-mailové adresy se nestahují.

Zda Jira adresy sdílí, závisí na jejím globálním nastavení zabezpečení a na nastavení soukromí uživatele Jira.

Jira tab with the Importing Jira users button and the Users table with Jira name, Jira Id and User columns highlighted

Důležité: Propojení vytvořená automaticky se aktualizují sama. Propojení přidaná ručně systém neaktualizuje, proto je po změně příjmení nebo e-mailové adresy musíte opravit ručně.

Ruční propojení

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

Odebrání propojení

  1. Najeďte myší na řádek s propojeným uživatelem a klikněte na ikonu tří teček vedle řádku.
  2. Zvolte Odpojit. Otevře se okno Odebrat propojení s otázkou Určitě chcete odkaz odstranit?
  3. Klikněte na Uložit. Systém propojení odebere.

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.

Pravidla pro načtení souboru:

  • Povolen je jen soubor ve formátu .csv.
  • Největší velikost souboru je 25 MB.
  • Řádky s nesprávnými hodnotami se přeskočí a systém je po importu vypíše.

Úkoly z Jira v harmonogramu projektu

Propojení projektu s Jira

  1. Otevřete projekt a přejděte na 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í: Typ úkolů (jen s jedním projektem Jira) nebo Filtr JQL (viz Filtr JQL).
  6. U možnosti Typ úkolů zaškrtněte typy úkolů na úrovních hierarchie (alespoň jeden je povinný) a klikněte na Uložit. Úkoly z Jira se objeví v harmonogramu projektu se zachovanou hierarchií z Jira.

Po úspěšném stažení jsou úkoly z Jira v projektu vidět a vedle názvu projektu se zobrazí ikona Jira. Kliknutím na ni se projekt Jira otevře na nové záložce.

Pokud není zaškrtnut žádný typ úkolů, systém zobrazí zprávu: Musí být označena alespoň jedna úroveň. Pokud klíč neexistuje nebo k projektu nemáte přístup, systém zobrazí zprávu: Nesprávný klíč projektu, projekt neexistuje nebo k němu nemáte přístup.

Jira integration window of a project with the Project key field and the Link with Jira button highlighted

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

U již propojeného projektu zvolte Připojení k JIRA. Otevře se okno Dovoz z JIRA, ve kterém změníte typy úkolů nebo dotaz JQL.

Odstranění úkolů z Jira z projektu

  1. Zvolte Připojení k JIRA. Otevře se okno Dovoz z JIRA.
  2. Klikněte na Odstranit a potvrďte v okně Odstranění odkazu na JIRA. Systém zobrazí upozornění, ž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. Úkoly, které splňují filtr, se dostanou do harmonogramu.

Při syntaktické chybě v dotazu systém zobrazí zprávu: Chyba v dotazu JQL

Důležité: 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 při pravidelné synchronizaci.

Pole, která pocházejí z Jira, jsou jen pro čtení. Jsou to Název, Popis, Pokrok, Majitel a hierarchie úkolů.

U takových úkolů platí tato omezení:

  • Pokrok ani majitele úkolu nelze změnit (zprávy 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).
  • 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 lze měnit. 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.

Důležité: Pokrok úkolu vyplývá z kategorie stavu v Jira: k provedení je 0 %, probíhá je 50 % a hotovo je 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í se zobrazí šedá ikona avatara s názvem z Jira.

Harmonogram je popsán v části Harmonogram projektu.