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.
Pre cloudovú verziu Jira (adresa v tvare nazov.atlassian.net) slúži samostatný konektor. Podrobnejší popis je dostupný v časti dokumentácie JIRA Cloud.
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:
- Otvorte Globálne nastavenia → Konektory, API a kliknite na tlačidlo Pridať konektor.
- V okne s výberom typu konektora vyberte možnosť JIRA on-premise a kliknite na tlačidlo Pokračovať.
- Vyplňte pole Názov a nastavte polia Metóda autentifikácie a Prístup CDESK do JIRY.
- 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.
- 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.
- 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.
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.
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:
- Na konci riadka používateľa Jira kliknite na ikonu ceruzky.
- V stĺpci Cdesk používateľ vyberte používateľa. Ponúkajú sa len riešitelia.
- Nastavenie uložte kliknutím na ikonu diskety na konci riadka.
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.
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ť.
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.
Spoločnosť sa zo zoznamu odoberie kliknutím na ikonu X na konci riadka spoločnosti.
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.
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.
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.
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ť.
Úloha sa s existujúcou účtovnou položkou prepojí týmto postupom:
- Na konci riadka úlohy kliknite na ikonu menu a vyberte možnosť Prepojiť s existujúcou účtovnou položkou.
- 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.
- Na konci riadka úlohy kliknite na ikonu menu a vyberte možnosť Uložiť.
Po uložení sa názov účtovnej položky zobrazí v stĺpci Cdesk účtovná položka.
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.
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.
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:
- 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.
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.
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.
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.
Po kliknutí sa zobrazí formulár s týmito poľami:
- 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.
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.
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.
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.
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.
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.
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á?
Ďakujeme za spätnú väzbu.