Výhody používání JIRA konektoru
JIRA konektor rozšiřuje možnosti použití CDESK v IT firmách, ale i v jiných společnostech využívajících služby programátorů. Umožňuje totiž propojení se softwarem JIRA, který je určen k organizaci programátorské práce a řízení projektů. Díky tomuto propojení je možné propojit CDESK požadavek s existujícím JIRA úkolem, nebo vytvořit přímo z požadavku nový úkol.
V současnosti je propojení plně funkční s JIRA nainstalovanou na lokálním serveru. Spojení s cloudovou verzí JIRA dopracujeme na základě poptávky.
Nastavení propojení CDESK a JIRA
Přidání JIRA konektoru v CDESK a aktivace JIRA REST API
Aby bylo možné JIRA konektor používat, je potřeba ho nejprve přidat a nakonfigurovat. Pro přidání JIRA konektoru přejděte do Globální nastavení -> Konektory, API a následně klikněte na tlačítko + Přidat konektor.
Po kliknutí se zobrazí okno s výběrem typu konektoru. Zvolte možnost JIRA. Pro pokračování klikněte na tlačítko -> Pokračovat.
Následně se zobrazí formulář pro konfiguraci konektoru, který obsahuje tato pole:
Typ konektoru – při přidávání JIRA konektoru se v poli automaticky předvyplní JIRA( Jira software). Toto nastavení není možné měnit.
Název – název, pod kterým se konektor bude zobrazovat v seznamu konektorů.
Zapnuto – aby bylo možné konektor používat, uveďte přepínač do polohy zapnutý 
.
Výchozí projekt – toto pole se zobrazí až po synchronizaci JIRA a CDESK. Umožňuje nastavit, který projekt bude předvyplněn při zadávání nového JIRA úkolu z požadavku. Tento projekt bude také přednastaven ve filtru a při propojování požadavku s existujícím JIRA úkolem.
Výchozí filtr pro stav – toto pole se zobrazí až po synchronizaci JIRA a CDESK. Umožňuje nastavit, které JIRA úkoly podle stavu se budou ve výchozím nastavení zobrazovat v seznamu při propojování požadavku s existujícím JIRA úkolem.
JIRA REST API
Aby bylo možné CDESK JIRA konektor používat, je potřeba do vašeho JIRA serveru nainstalovat dodatečné knihovny. Ty je možné stáhnout kliknutím na tlačítko Cdesk Jira plugin. Slouží k tomu, aby CDESK server dokázal komunikovat se systémem JIRA.
Následně v části Přihlašovací údaje vyplňte adresu JIRA serveru, číslo portu (standardně se používá 443) a jméno a heslo administrátora pro přihlášení do JIRY. Po vyplnění údajů se zpřístupní tlačítko Test připojení. Po kliknutí se ve formuláři zpřístupní další pole pro spárování CDESK účtů a JIRA uživatelů. Zároveň se přepínač vedle tlačítka uvede do polohy zapnutý , což signalizuje, že synchronizace proběhla úspěšně.
Mapování JIRA účtů a CDESK uživatelů
Propojení CDESK uživatelů s JIRA konty je možné na záložce Uživatelé. Uživatel, který nebude mít své CDESK konto propojené s JIRA kontem, nebude moci z CDESK vytvářet nové JIRA úkoly ani propojovat požadavky s existujícími JIRA úkoly.
Po úspěšné synchronizaci se v záložce zobrazí seznam všech uživatelů JIRA. V pravém horním rohu je umístěn nástroj umožňující listovat mezi jednotlivými stránkami seznamu. Konkrétního uživatele je možné vyhledat pomocí pole pro vyhledávání.
Pro propojení s uživatelem v CDESK klikněte na ikonu 
na konci řádku uživatele, kterého chcete propojit, a následně ve sloupci Cdesk uživatel vyberte požadovaného uživatele. Nastavení uložíte kliknutím na ikonu 
, která se nachází na konci řádku uživatele.
Pokud potřebujete nastavené propojení upravit, klikněte na ikonu na konci řádku daného uživatele. Následně se zobrazí pole jako při nastavování propojení kont, přičemž můžete vybrat nového CDESK uživatele. V případě, že chcete propojení odstranit, klikněte na ikonu 
.
Výběr společností pro párování JIRA úkolů
Propojování s JIRA úkoly je možné pouze na požadavcích zákazníků, kteří jsou vybráni na záložce Společnosti v JIRA konektoru. Pro přiřazení společnosti klikněte na tlačítko + Přidat společnost.
Po kliknutí se zobrazí seznam společností, které jsou registrovány v Adresář -> Společnosti. Společnost vyberete kliknutím na její název, čímž se zařadí do seznamu přiřazených společností. Společnost může mít přiřazeno pouze jedno JIRA prostředí. CDESK požadavky vázané na společnost budou mít přístup k přiřazenému JIRA prostředí.
V případě, že potřebujete společnost ze seznamu odebrat, klikněte na ikonu na konci řádku dané společnosti.
Mapování JIRA projektů s CDESK zakázkami
CDESK JIRA konektor umožňuje přenést plnění z CDESK do worklogu JIRA. To se zajistí propojením JIRA úkolu s účetními položkami pod zakázkami. Plnění, která mají propojení přes účetní položku na JIRA úkol, budou synchronizována do worklogu. Abyste toho dosáhli, je potřeba propojit JIRA projekty s CDESK zakázkami a také je potřeba zapnout párování JIRA úkolů s účetními položkami.
Propojení JIRA projektů se zakázkami se nastavuje na záložce Projekty v JIRA konektoru.
V horní části záložky se nachází přepínač Povolit párování JIRA úkolů s účetními položkami zakázky. Uvedením přepínače do polohy zapnutý se zajistí, že pokud mají plnění nastavenou stejnou účetní položku jako je na propojené zakázce, čas zapsaný na těchto plněních se bude přenášet i do worklogu JIRA úkolu. V případě, že je vypínač uveden v poloze vypnutý 
, takový přenos nebude fungovat.
V záložce se po synchronizaci načtou všechny JIRA projekty. Pro vytvoření nové CDESK zakázky, která bude propojena s JIRA projektem, klikněte na ikonu menu 
na konci řádku daného projektu a vyberte možnost Propojit s novou zakázkou. Po kliknutí se zobrazí formulář pro zadání nové zakázky. Více informací o vytváření zakázek najdete v samostatném článku.
Po založení zakázky se její název zobrazí ve sloupci CDESK zakázka.
Pro propojení s existující zakázkou klikněte na ikonu menu na konci řádku daného projektu a vyberte možnost Propojit s existující zakázkou. Po kliknutí se zobrazí okno se seznamem zakázek. Zakázku vyberete kliknutím na její název.
Po úspěšném propojení zakázky s JIRA projektem je možné nastavit propojení konkrétního JIRA úkolu s účetní položkou. Začněte dvojklikem na název propojené zakázky ve sloupci CDESK zakázka. Po kliknutí se zobrazí seznam všech JIRA úkolů patřících pod daný JIRA projekt. V horní části okna se nachází pole pro vyhledávání, které umožňuje vyhledat konkrétní JIRA úkol. V seznamu je také možné používat pokročilý filtr, který umožňuje vyfiltrovat JIRA úkoly podle vámi zadaných kritérií.
Po vyhledání konkrétního úkolu je možné nastavit propojení s novou nebo existující účetní položkou. Pro propojení s novou účetní položkou klikněte na ikonu menu na konci řádku daného JIRA úkolu a vyberte možnost Propojit s novou účetní položkou. Po kliknutí se zobrazí formulář pro zadání nové účetní položky. Po zadání parametrů nové účetní položky klikněte na tlačítko Uložit.
Pro propojení s existující účetní položkou klikněte na ikonu menu na konci řádku daného JIRA úkolu a vyberte možnost Propojit s existující účetní položkou.
Po kliknutí se ve sloupci CDESK účetní položka zobrazí výběr účetních položek dostupných pro zákazníka, který je nastaven na vybrané zakázce. Pokud účetní položka pochází z jiné zakázky, než je vybraná, ale zákazník ji má dostupnou, v závorce za názvem dané účetní položky se nachází informace o tom, z jaké zakázky byla účetní položka převzata. Účetní položku v seznamu vyberete kliknutím.
Po výběru účetní položky je potřeba toto nastavení uložit kliknutím na ikonu menu na konci řádku daného JIRA úkolu a následně výběrem možnosti Uložit.
Po uložení propojení účetní položky s JIRA úkolem se název účetní položky zobrazí ve sloupci CDESK účetní položka.
V případě, že potřebujete propojení s účetní položkou zrušit, klikněte na ikonu menu na konci řádku daného JIRA úkolu a vyberte možnost Zrušit propojení s účetní položkou.
Pokud potřebujete zrušit propojení přímo se zakázkou, klikněte na ikonu menu na konci řádku daného projektu a vyberte možnost Zrušit propojení se zakázkou.
Notifikace o změnách na připojeném JIRA úkolu
Po propojení CDESK požadavku s JIRA úkolem může uživatel CDESK dostávat notifikace o změnách provedených na JIRA úkolu. Aktivace těchto notifikací a nastavení toho, jaké změny se mají notifikovat, se konfigurují v záložce Webhook v JIRA konektoru.
Uvedením přepínače Aktualizace změn JIRA tasků do polohy zapnutý 
se zajistí, že CDESK bude dostávat informace z JIRA o změnách provedených na úkolech. Toto propojení je důležité z toho důvodu, aby CDESK mohl následně uživatelům odesílat notifikace. Pokud je tento přepínač vypnutý , toto propojení nebude fungovat a v konečném důsledku nebudou moci být ani odesílány žádné notifikace. Pro nastavení toho, kdy se notifikace budou odesílat, klikněte na tlačítko + Přidat pravidlo.
Po kliknutí se zobrazí pole pro zadání parametrů pravidla:
Název – zadejte název, který bude sloužit ke krátké charakteristice pravidla.
Událost – vyberte ze seznamu událost, při které budou odcházet notifikace. Na výběr jsou tyto možnosti:
- Změna stavu na – notifikace odejde při změně stavu JIRA úkolu. Při výběru této možnosti se zobrazí pole pro výběr stavu, který pokud bude v JIRA úkolu nastaven, tak uživatel bude notifikován. Jde o stavy, které máte nastaveny v JIRA. V případě, že v tomto druhém poli nevyberete žádný konkrétní stav, notifikace budou odesílány při jakékoli změně stavu.
- Změna řešitele – notifikace bude odeslána při změně řešitele na JIRA úkolu.
Akce – vyberte možnost Odeslání notifikace.
Projekty – vyberte projekt, v rámci kterého budou notifikovány změny na JIRA úkolech. Pro jedno pravidlo je možné vybrat více projektů.
Pravidlo uložíte kliknutím na ikonu , která se nachází na konci řádku daného pravidla.
CDESK umožňuje vytvořit více pravidel pro odesílání notifikací o změnách na JIRA úkolu. Všechna vytvořená pravidla se zobrazují v seznamu na záložce Webhook v JIRA konektoru. Pokud potřebujete uložené pravidlo upravit, klikněte na ikonu na konci řádku daného pravidla. V případě, že chcete pravidlo odstranit, klikněte na ikonu X.
Nastavením pravidla na záložce Webhook se nastaví pouze podmínky, kdy budou notifikace odesílány. Avšak k tomu, aby uživatel dostal notifikaci, je potřeba ještě zapnout notifikování z JIRA konektoru v Globální nastavení -> Notifikace -> Základní nastavení -> část Požadavky -> pole Jira konektor. Ve sloupci Příjemci notifikací je potřeba nastavit role, které budou notifikovány, a následně zapnout přepínač ve sloupci E-mail. Pro Jira konektor jsou v současnosti dostupné pouze mailové notifikace.
Zadávání JIRA úkolu přes požadavky v CDESK
Poté co je JIRA konektor nakonfigurován, ho lze použít k vytváření nových JIRA úkolů z požadavků, nebo k propojování požadavků s existujícími úkoly. Tyto úkony lze provádět pouze na uložených požadavcích. Také musí být na zákazníka, který byl vybrán při konfiguraci JIRA konektoru na záložce Společnosti.
Přidávání i propojování s JIRA úkoly se provádí na záložce Jira v CDESK požadavku. Pokud se záložka v seznamu nezobrazuje, zkontrolujte oprávnění v: Uživatelé a skupiny -> Uživatelé -> konkrétní uživatel -> záložka Oprávnění -> Požadavky -> Přístup k záložkám -> Jira.
Vytvoření nového JIRA úkolu
Pro vytvoření nového JIRA úkolu, který bude propojen s požadavkem, klikněte v záložce Jira na tlačítko +Vytvořit.
Po kliknutí se zobrazí formulář obsahující následující pole:
Požadavek – v poli se automaticky předvyplní číslo a název požadavku, ze kterého je JIRA úkol vytvářen. Kliknutím na ikonu 
je možné zobrazit detail daného požadavku. Opětovným kliknutím na ikonu 
se detail zavře.
Projekt – vyberte projekt, do kterého bude JIRA úkol zařazen. V poli může být předvyplněn projekt, který jste při konfiguraci konektoru nastavili v poli Výchozí projekt.
Typ – vyberte typ JIRA úkolu. Po výběru typu požadavku se zobrazí další pole, jaká se pro daný typ používají v JIRA.
Přílohy – v této části je možné k JIRA úkolu přidat přílohy. Také se zde přenesou přílohy přidané na původní CDESK požadavek. Pokud potřebujete některou z příloh odstranit, klikněte na ikonu koše.
Nový JIRA úkol vytvoříte kliknutím na tlačítko Uložit, které se nachází v pravém dolním rohu formuláře. Ve vytvořeném JIRA úkolu se nachází informace o propojení s CDESK požadavkem s možností prokliku na daný požadavek.
Propojení s existujícím JIRA úkolem
Pro propojení požadavku s existujícím JIRA úkolem klikněte v záložce Jira na tlačítko + Připojit.
Po kliknutí se zobrazí modální okno s výběrem JIRA úkolů. V seznamu může být předvyplněn filtr obsahující stav úkolů a projekt, který jste mohli nastavit při konfiguraci JIRA konektoru v polích Výchozí projekt a Výchozí filtr pro stav. Propojení vytvoříte kliknutím na název JIRA úkolu.
Po propojení se v JIRA úkolu nachází informace o propojení s CDESK požadavkem s možností prokliku na daný požadavek.
Zobrazení a práce s propojenými JIRA úkoly v CDESK
Informace o propojeném JIRA úkolu se zobrazuje i přímo v seznamu požadavků, kde je možné přidat sloupce JIRA-ID a JIRA Fix version. Práce se seznamem požadavků je popsána v samostatném textu Seznam požadavků. Kliknutím na údaj ve sloupci JIRA-ID se v novém okně prohlížeče zobrazí propojený JIRA úkol.
Po otevření požadavku se v záložce Jira zobrazuje seznam všech propojených JIRA úkolů. V seznamu se zobrazují tyto sloupce:
- JIRA-ID
- Projekt
- Název
- Stav
- Řešitel
- Verze s opravou
- Poslední změna
- Poslední příspěvek
V případě potřeby je možné zrušit vazbu s JIRA úkolem. Pro zrušení vazby klikněte na ikonu menu na konci řádku daného úkolu a vyberte možnost Zrušit vazbu.
