Preskočiť na obsah
Beta verzia novej dokumentácie. Prejsť na starú verziu
Domov Konektory JIRA on-premise konektor

JIRA on-premise konektor

Naposledy aktualizované

JIRA on-premise konektor slúži na prepojenie CDESK so systémom Jira Software nainštalovaným na vlastnom serveri (on-premise). Umožňuje prepojiť požiadavku v CDESK s existujúcou úlohou v Jire alebo vytvoriť z požiadavky novú úlohu. Čas z plnení je možné prenášať do worklogu v Jire a zmeny úloh v Jire sa prenášajú späť do CDESK.

V jednej inštancii CDESK je možné pridať viac konektorov JIRA on-premise, napríklad pre viac serverov Jira.

Poznámka

Pre cloudovú verziu Jira (adresa v tvare nazov.atlassian.net) slúži samostatný konektor. Podrobnejší popis je dostupný v časti dokumentácie JIRA Cloud.

Princíp fungovania konektora JIRA on-premise
Obrázok: Princíp fungovania konektora JIRA on-premise

Nastavenie prepojenia CDESK a JIRA

Konektor sa pridáva v globálnych nastaveniach v zozname konektorov do externých systémov. Najprv sa vyplnia prihlasovacie údaje k serveru Jira a po úspešnom teste pripojenia sa konektor vytvorí. Až v uloženom konektore sa zobrazia záložky na prepojenie používateľov, spoločností a projektov a nastavenie notifikácií.

Pridanie JIRA konektora v CDESK

Konektor sa pridáva v sprievodcovi pridaním konektora. Pri pridávaní sa otvorí formulár s týmito poľami:

  • Typ konektora – automaticky sa predvyplní JIRA on-premise (Jira Software). Pole nie je možné meniť.
  • Názov – názov, pod ktorým sa konektor zobrazuje v zozname konektorov.
  • Zapnuté – konektor je možné používať len pri zapnutom prepínači. Predvolene je zapnutý.
  • Ignorovať SSL certifikát – vypne overovanie certifikátu servera Jira, napríklad pri pripojení cez IP adresu. Predvolene je vypnutý.
  • Metóda autentifikácie – spôsob prihlásenia CDESK do Jiry. Možnosť Meno a heslo (predvolená) zobrazí polia prihlasovacích údajov. Možnosť OAuth zobrazí tlačidlo Nastaviť OAuth so sprievodcom na vytvorenie tokenu v Jire.
  • Automatická tvorba Summary podľa požiadavky – pri novej úlohe sa pole Summary (názov úlohy) predvyplní názvom požiadavky. Predvolene je zapnutý.
  • Prístup CDESK do JIRY – určuje, pod akým účtom používatelia CDESK pracujú v Jire. Možnosti sú opísané v časti Mapovanie JIRA účtov a CDESK používateľov.
  • Predvolený projekt – projekt predvyplnený pri novej úlohe z požiadavky a vo filtri pri prepájaní s existujúcou úlohou. Pole sa zobrazí v uloženom konektore po úspešnom teste pripojenia.
  • Predvolený filter pre stav issue – stav úloh, ktoré sa predvolene zobrazia pri prepájaní požiadavky s existujúcou úlohou. Pole sa zobrazí za rovnakej podmienky ako Predvolený projekt.
  • Predvolený filter pre stav epic – stav, podľa ktorého sa filtrujú epicy pri výbere epicu v novej úlohe.

JIRA REST API – aby bolo možné konektor používať, je potrebné do servera Jira nainštalovať doplnok, ktorý umožní komunikáciu so serverom CDESK. Doplnok (súbor CdeskPlugin.jar) sa stiahne kliknutím na tlačidlo Cdesk Jira plugin.

Konektor sa pridáva týmto postupom:

  1. Otvorte Globálne nastavenia → Konektory, API a kliknite na tlačidlo Pridať konektor.
  2. V okne s výberom typu konektora vyberte možnosť JIRA on-premise a kliknite na tlačidlo Pokračovať.
  3. Vyplňte pole Názov a nastavte polia Metóda autentifikácie a Prístup CDESK do JIRY.
  4. V riadku Prihlasovacie údaje vyplňte polia JIRA Server, port, Administrator a Heslo. Port je povinný a nepredvypĺňa sa, obvykle ide o port 443.
  5. Kliknite na tlačidlo Test pripojenia. Tlačidlo je aktívne po vyplnení servera, portu, používateľa a pri novom konektore aj hesla. Pri chybe sa zobrazí hlásenie s dôvodom.
  6. Po úspešnom teste kliknite na tlačidlo Vytvoriť. Bez úspešného testu konektor nie je možné uložiť.

Po uložení a úspešnom teste sa vo formulári zobrazia záložky Používatelia, Spoločnosti, Projekty a Webhook a polia predvoleného projektu a stavu.

Formulár nového konektora JIRA on-premise s poľami Metóda autentifikácie a Prístup CDESK do JIRY
Obrázok: Formulár nového konektora JIRA on-premise s poľami Metóda autentifikácie a Prístup CDESK do JIRY

Mapovanie JIRA účtov a CDESK používateľov

Spôsob práce používateľov v Jire určuje pole Prístup CDESK do JIRY. Na výber sú tieto možnosti:

  • Administrátorský účet – CDESK pracuje pod účtom z prihlasovacích údajov konektora a používateľov CDESK je potrebné prepojiť s účtami Jira na záložke Používatelia. Táto možnosť je predvolená.
  • Spoločný účet – všetci používatelia pracujú v Jire pod jedným účtom. Mapovanie sa nepoužíva a akcie riadia oprávnenia CDESK.
  • Vlastný token – každý používateľ zadá vo svojom profile v časti Jira polia Jira login a Vlastný token a uloží ich. CDESK zobrazí „Token uložený“ alebo „Token neplatný“.

Prepojenie používateľov CDESK s účtami Jira sa nastavuje na záložke Používatelia. Používateľ CDESK bez prepojeného účtu Jira má k Jire prístup len na čítanie, nemôže teda vytvárať úlohy ani prepájať požiadavky.

Obrázok: Záložka Používatelia v JIRA konektore

Na záložke sa zobrazí zoznam používateľov Jira s vyhľadávaním a stránkovaním. Zoznam má stĺpce Meno, Stav, E-mail, Prístup (plný prístup alebo len čítanie), Automatické vytvorenie plnenia a Cdesk používateľ. Pri režime Vlastný token sa mapovanie nastavuje v profile používateľa a pri režime Spoločný účet sa tabuľka nezobrazuje.

Používateľ Jira sa s používateľom CDESK prepojí týmto postupom:

  1. Na konci riadka používateľa Jira kliknite na ikonu ceruzky.
  2. V stĺpci Cdesk používateľ vyberte používateľa. Ponúkajú sa len riešitelia.
  3. Nastavenie uložte kliknutím na ikonu diskety na konci riadka.
Obrázok: Prepojenie JIRA účtu s CDESK používateľom

Prepojenie je možné upraviť ikonou ceruzky na konci riadka, kde je možné vybrať iného používateľa CDESK. Prepojenie sa odstráni kliknutím na ikonu X.

Obrázok: Odstránenie prepojenia medzi JIRA kontom a CDESK používateľom

V stĺpci Automatické vytvorenie plnenia je možné nastaviť, či sa z worklogu používateľa v Jire automaticky vytvorí v CDESK fakturačné alebo interné plnenie. Plnenie vznikne len vtedy, keď je úloha v Jire prepojená práve s jednou požiadavkou.

Výber spoločností pre párovanie JIRA úloh

Prepájanie s úlohami Jira je možné iba na požiadavkách zákazníkov, ktorí sú vybraní na záložke Spoločnosti v konektore. Spoločnosť sa pridá kliknutím na tlačidlo + Pridať spoločnosť.

Obrázok: Tlačidlo pre pridanie spoločnosti medzi priradené spoločnosti

Po kliknutí sa zobrazí zoznam aktívnych spoločností z Adresár → Spoločnosti, ktoré ešte nemajú priradený iný JIRA konektor. Je možné vybrať viac spoločností naraz alebo kliknúť na tlačidlo Pridať všetky spoločnosti. Spoločnosť môže mať priradené len jedno prostredie Jira. Požiadavky viazané na spoločnosť majú prístup k priradenému prostrediu Jira.

Obrázok: Zoznam priradených spoločností na záložke Spoločnosti v JIRA konektore

Spoločnosť sa zo zoznamu odoberie kliknutím na ikonu X na konci riadka spoločnosti.

Obrázok: Ikona pre odstránenie zo zoznamu priradených spoločností

Mapovanie JIRA projektov s CDESK zákazkami

Konektor umožňuje prenášať plnenia z CDESK do worklogu v Jire. Prenos zabezpečí prepojenie úlohy Jira s účtovnou položkou zákazky. Plnenia, ktoré sú cez účtovnú položku prepojené s úlohou Jira, sa synchronizujú do worklogu. Na záložke Projekty je preto potrebné prepojiť projekty Jira so zákazkami CDESK a zapnúť párovanie úloh s účtovnými položkami.

Obrázok: Záložka Projekty v JIRA konektore

V hornej časti záložky sa nachádza prepínač Povoliť párovanie jira úloh s účtovnými položkami zákazky. Ak je prepínač zapnutý a plnenie má nastavenú rovnakú účtovnú položku ako prepojená zákazka, čas z plnenia sa prenesie aj do worklogu úlohy v Jire. Pri vypnutom prepínači prenos nefunguje.

Na záložke sa po úspešnom teste pripojenia načítajú všetky projekty Jira. Zoznam projektov má stĺpce Skratka, Názov, Typ a Cdesk zákazka. Projekt môže byť prepojený s viacerými zákazkami.

Prepojenie s novou zákazkou – nová zákazka prepojená s projektom sa vytvorí cez ikonu menu na konci riadka projektu možnosťou Prepojiť s novou zákazkou. Po kliknutí sa zobrazí formulár novej zákazky a po jej založení sa názov zákazky zobrazí v stĺpci Cdesk zákazka. Viac informácií o vytváraní zákaziek je dostupných v časti dokumentácie Vytvorenie zákazky.

Obrázok: Tlačidlo pre vytvorenie novej zákazky, ktorá bude prepojená s JIRA projektom
Obrázok: JIRA projekt s prepojenou zákazkou

Prepojenie s existujúcou zákazkou – existujúca zákazka sa prepojí cez ikonu menu na konci riadka projektu možnosťou Prepojiť s existujúcou zákazkou. V okne so zoznamom zákaziek je možné vybrať aj viac zákaziek naraz.

Obrázok: Tlačidlo pre prepojenie JIRA projektu s existujúcou zákazkou

Prepojenie úlohy s účtovnou položkou – prepojenie konkrétnej úlohy s účtovnou položkou sa nastavuje cez menu na štítku zákazky v stĺpci Cdesk zákazka možnosťou Prepojiť účtovné položky. Možnosť je dostupná len pri zapnutom párovaní. Zobrazí sa zoznam úloh projektu s vyhľadávaním a pokročilým filtrom. Úloha sa s novou účtovnou položkou prepojí cez ikonu menu na konci riadka úlohy možnosťou Prepojiť s novou účtovnou položkou. Po vyplnení formulára novej účtovnej položky sa položka uloží kliknutím na tlačidlo Uložiť.

Obrázok: Tlačidlo pre prepojenie JIRA úlohy s novou účtovnou položkou

Úloha sa s existujúcou účtovnou položkou prepojí týmto postupom:

  1. Na konci riadka úlohy kliknite na ikonu menu a vyberte možnosť Prepojiť s existujúcou účtovnou položkou.
  2. V stĺpci Cdesk účtovná položka vyberte účtovnú položku. Ponúkajú sa položky dostupné pre zákazníka vybranej zákazky. Ak položka pochádza z inej zákazky, názov tejto zákazky je uvedený v zátvorke za názvom položky.
  3. Na konci riadka úlohy kliknite na ikonu menu a vyberte možnosť Uložiť.
Obrázok: Tlačidlo pre prepojenie JIRA úlohy s existujúcou účtovnou položkou
Obrázok: Výber existujúcich účtovných položiek pre prepojenie s JIRA úlohou
Obrázok: Uloženie prepojenia existujúcej účtovnej položky s JIRA úlohou

Po uložení sa názov účtovnej položky zobrazí v stĺpci Cdesk účtovná položka.

Obrázok: Prepojenie CDESK účtovnej položky s JIRA úlohou

Zrušenie prepojenia – prepojenie úlohy s účtovnou položkou sa zruší cez ikonu menu na konci riadka úlohy možnosťou Zrušiť prepojenie s účtovnou položkou. Prepojenie projektu so zákazkou sa zruší v menu na štítku zákazky možnosťou Zrušiť prepojenie so zákazkou.

Obrázok: Tlačidlo pre zrušenie prepojenia účtovnej položky s JIRA úlohou
Obrázok: Tlačidlo pre zrušenie prepojenia JIRA projektu s existujúcou zákazkou

Notifikácie o zmenách na pripojenej JIRA úlohe

Po prepojení požiadavky s úlohou Jira môže používateľ CDESK dostávať notifikácie o zmenách na tejto úlohe. Zmeny úloh v Jire sa do CDESK prenášajú cez webhook, ktorý sa nastavuje na záložke Webhook v konektore.

Obrázok: Záložka Webhook

Prepínač Aktualizácia zmien JIRA taskov v CDESK zapne prenos zmien z Jiry. Bez tohto prenosu CDESK o zmenách nevie a notifikácie neodosiela. Prepínač sa zobrazí len vtedy, keď má účet z konektora v Jire administrátorské práva. Inak záložka zobrazí návod na manuálne nastavenie webhooku v Jire (Nastavenia JIRA → Systém → WebHooks) s adresou a zoznamom udalostí.

Kedy sa majú notifikácie odosielať, určujú pravidlá. Pravidlo sa pridá kliknutím na tlačidlo + Pridať pravidlo a má tieto polia:

Obrázok: Tlačidlo pre vytvorenie nového pravidla odosielania notifikácií z JIRA úloh
  • Názov – krátka charakteristika pravidla.
  • Udalosť – udalosť v Jire, pri ktorej sa odošle notifikácia. Na výber sú tieto možnosti:
    • Zmena stavu na – notifikácia sa odošle pri zmene stavu úlohy na stav vybraný v ďalšom poli. Ponúkajú sa stavy nastavené v Jire. Ak sa stav nevyberie, notifikácia sa odošle pri každej zmene stavu.
    • Zmena riešiteľa – notifikácia sa odošle pri zmene riešiteľa úlohy.
  • Akcia – akcia pravidla, Odoslanie notifikácie.
  • Projekty – projekty, ktorých sa pravidlo týka. Je možné vybrať viac projektov. Ak sa nevyberie žiadny projekt, pravidlo platí pre všetky projekty.

Pravidlo sa uloží kliknutím na ikonu diskety na konci riadka pravidla.

Obrázok: Nastavenie pravidla pre odosielanie notifikácií z JIRA úlohy

Pravidiel je možné vytvoriť viac a všetky sa zobrazujú v zozname na záložke Webhook. Pravidlo sa upraví kliknutím na ikonu ceruzky a odstráni kliknutím na ikonu X na konci riadka pravidla.

Obrázok: Ikony pre odstránenie a editáciu pravidla o odosielaní notifikácií

Pravidlo na záložke Webhook určuje len podmienky odoslania. Aby používateľ notifikáciu dostal, je potrebné v Globálne nastavenia → Notifikácie → Základné nastavenia v časti Požiadavky zapnúť notifikáciu Jira konektor, v stĺpci Príjemcovia notifikácií nastaviť príjemcov a zapnúť stĺpec E-mail. Predvoleným príjemcom je riešiteľ požiadavky. Pre JIRA konektor sú dostupné iba e-mailové notifikácie.

Obrázok: Nastavenie notifikácií pre JIRA konektor

Zadávanie JIRA úlohy cez požiadavky v CDESK

Nakonfigurovaný konektor umožňuje vytvárať z požiadaviek nové úlohy v Jire alebo prepájať požiadavky s existujúcimi úlohami. Požiadavka musí byť na zákazníka vybraného na záložke Spoločnosti v konektore.

Nové úlohy aj prepojenie s existujúcimi sa vytvárajú na záložke Jira v požiadavke. Záložka sa zobrazí až v uloženej požiadavke. Ak sa záložka nezobrazuje, skontrolujte oprávnenie v Používatelia a skupiny → Používatelia, v detaile používateľa na záložke Oprávnenia → Požiadavky → Prístup k záložkám → Jira. Predvolene ho majú Administrátori, Operátori a Riešitelia.

Vytvorenie novej JIRA úlohy

Nová úloha prepojená s požiadavkou sa vytvorí kliknutím na tlačidlo + Vytvoriť na záložke Jira.

Obrázok: Tlačidlo pre vytvorenie novej JIRA úlohy

Po kliknutí sa zobrazí formulár s týmito poľami:

Obrázok: Formulár pre vytvorenie novej JIRA úlohy z požiadavky
  • Požiadavka – automaticky sa predvyplní číslo a názov požiadavky, z ktorej sa úloha vytvára. Kliknutím na ikonu šípky je možné zobraziť a znova skryť stručný detail požiadavky.
  • Projekt – projekt, do ktorého bude úloha zaradená. Môže byť predvyplnený projekt z poľa Predvolený projekt v nastavení konektora.
  • Typ – typ úlohy v Jire. Po výbere typu sa zobrazia ďalšie polia, ktoré sa pre daný typ používajú v Jire.
  • Prílohy – prílohy úlohy. Prenesú sa sem aj prílohy požiadavky. Prílohu je možné odstrániť kliknutím na ikonu koša.

Pole Summary sa predvyplní názvom požiadavky, ak je to v konektore zapnuté. Úlohu je možné zaradiť do epicu a do popisu vložiť údaj „Kto žiada“. Úloha sa vytvorí kliknutím na tlačidlo Vytvoriť v pravom dolnom rohu formulára. V úlohe v Jire sa zobrazí odkaz na požiadavku v CDESK.

Obrázok: JIRA úloha vytvorená z CDESK požiadavky

Prepojenie s existujúcou JIRA úlohou

Požiadavka sa s existujúcou úlohou prepojí kliknutím na tlačidlo + Pripojiť na záložke Jira.

Obrázok: Tlačidlo pre prepojenie existujúcej JIRA úlohy s požiadavkou

Po kliknutí sa zobrazí okno s výberom úloh, v ktorom môže byť predvyplnený filter podľa polí Predvolený projekt a Predvolený filter pre stav issue z nastavenia konektora. Prepojenie sa vytvorí kliknutím na názov úlohy. V úlohe v Jire sa potom zobrazí odkaz na požiadavku v CDESK.

Obrázok: Zoznam JIRA úloh pre prepojenie s CDESK požiadavkou

Komentár z diskusie požiadavky je možné odoslať aj do Jiry. Riadi to oprávnenie Jira komentár v diskusii požiadavky.

Zobrazenie a práca s prepojenými JIRA úlohami v CDESK

Informácia o prepojenej úlohe sa zobrazuje aj priamo v zozname požiadaviek. Do zoznamu je možné pridať stĺpce JIRA-ID, JIRA Fix versions, JIRA Sprint, JIRA Labels, JIRA Riešiteľ, JIRA Posledná zmena a JIRA Posledný príspevok. Kliknutím na údaj v stĺpci JIRA-ID sa úloha otvorí v novom okne prehliadača. Práca so zoznamom požiadaviek je opísaná v časti dokumentácie Zoznam požiadaviek.

Obrázok: Požiadavka s prepojením na JIRA úlohu v zozname požiadaviek

Na záložke Jira v požiadavke sa zobrazuje zoznam prepojených úloh. Zobrazené stĺpce je možné vybrať v nastavení tabuľky. Dostupné sú stĺpce JIRA-ID, Projekt, Názov, Typ, Stav, Priorita, Riešiteľ, Fix version, Zmenené, Posledný príspevok, Komponent a Riešenie.

Obrázok: Pripojené JIRA úlohy na požiadavke

Väzba s úlohou sa zruší cez ikonu menu na konci riadka úlohy možnosťou Zrušiť väzbu. Pred zrušením CDESK zobrazí potvrdenie, pretože väzba sa zruší aj na strane Jiry.

Obrázok: Tlačidlo pre zrušenie väzby s JIRA úlohou

Synchronizácia a worklog

Údaje medzi CDESK a Jirou sa prenášajú tromi spôsobmi:

  • Webhook – zmeny úloh a worklogov v Jire sa do CDESK prenesú hneď, ak je webhook nastavený.
  • Nočná synchronizácia – každý deň o 2:00 CDESK pri prepojených úlohách aktualizuje stav, riešiteľa, fix version, sprint, labels a posledný komentár a prenesie worklogy do plnení. Synchronizácia sa zapne automaticky, ak existuje zapnutý JIRA konektor.
  • Plnenia do worklogu – plnenie sa zapíše do worklogu v Jire, ak je zadané na zákazku cez účtovnú položku prepojenú s úlohou, alebo ak je v plnení vybraná úloha v poli Jira úloha. CDESK zobrazí, či sa záznam v Jire podarilo vytvoriť, upraviť alebo vymazať.

Bola táto stránka užitočná?