Obsah

Instalace add-onu

Pozor na oprávnění

Instalaci je nutné provádět pod uživatelem, který na to má práva- tedy s uživatelem, který má práva administrátora

v opačném případě nebudete schopni addon do vaši JIRA přidat

Přihlásíme se do požadované JIRA, kam požadujeme addon nainstalovat
Z vrchní lišty JIRA vybereme ikonu "správa" a zvolíme položku Add-ons (rozšíření) v submenu
V okně pro hledání nových addonů (Find new Add-ons) vyhledáme "FarAway"
U add-onu "Onlio FarAway" vybereme "Free Trial"
Přihlásíme se svým AtlassianID a obdržíme klíč pro trial verzi addonu

Instalace addonu zajistí

Instalaci souborů
Vytvoření výchozích uživatelských skupin pro FarAway
Vytvoření služby FarAwayUpdateJob
Vytvoření nastavitelného uživatelského sloupce
Zařazení administrátorů do rolí "Editors"
Základní nastavení add-onu včetně propojení s databází

Aktualizace addonu se dají stáhnout z Atlassian marketplace a administrátora na ně upozorňuje JIRA Universal Plugin Manager

Další nastavení

Pro používání addonu je nutné uživatelům přiřadit oprávnění addon využívat- tzn. umístit je do příslušných skupin v JIRA anebo Organizační struktury addonu
Aby se zobrazovalo upozornění na chybějícího řešitele úlohy (assignee), je potřeba nastavit v administraci JIRA uživatelské pole "FarAway: Assignee Warning" a kdo jej uvidí (role WarningViewers)

Uživatelé, kteří mohou přidávat absence je potřeba:

přidat do JIRA skupiny "FARAWAY_USERS" (kterou addon automaticky vytváří při instalaci)
druhou variantou je v nastavení addonu změnit hodnotu "Use org. structure" na true a uživatele poté definovat přímo v Organizační struktuře (v nastavení addonu- tj. Administrace - Settings)

Administrace addonu

Pro přístup do administrace addonu:

Vybereme ikonu správa v horní navigační lišty produktu JIRA- , dále Add-ons (doplňky)
V levém sloupci vybereme požadovanou možnost v sekci "ONLIO FARAWAY"

Licencování

Po vypršení trial verze je třeba koupit licenci, pokud chybí nelze do addonu vkládat nová data a měnit nastavení.

lze použít jak Onlio licenci, koupenou u Onlio, a.s., tak Atlassian licenci, koupenou na Atlassian Marketplace
při použití Onlio licence musí být prázdné pole License key, kam se vkládá Atlassian licence (níže)- Administrace, Doplňky, správa doplňků, Onlio licence se vkládá přímo do nastavení addonu- položka "Onlio license"

Onlio licence

Pokud si přejeme využívat Onlio licenci, přejdeme do administrace JIRA a správy doplňků (addonů), u nastavení FarAway necháme pole pro licenci prázdné (toto pole slouží pro využití Atlassian licence), Onlio licence se zádává přímo v konfiguračním okně FarAway (ukázka níže)

(administrace addonů)

(nastavení Atlassian licence vs Onlio licence)

→ Obrazovka s licencí

(nastavení Onlio licence)

Atlassian licence

Pokud si přejeme využít licenci addonu z Atlassian Marketplace, pak přejdeme do správy addonů, a zde standardním způsobem vyplníme licenci

(administrace addonů)

(nastavení Atlassian licence)

Nastavení (Settings)

Zde je možnost měnit konfigurační položky addonu

Vysvětlivky:

Nastavení	Popis	Uživatele definuje	Název JIRA Group (výchozí nastavení)
Vacation	Uživatelé, kteří právě chybí a mají dovolenou (nejsou přítomni)	System	INT-OUT
Outworking	Uživatelé, kteří sice chybí, ale pracují (Homeoffice)	System	INT-OUT-WORKING
Editors	Uživatelé, kteří mohou přidávat/měnit/mazat záznamy i ostatních uživatelů.	Administrátor	INT-OUT-EDITORS
Viewers	Uživatelé, kteří vidí záznamy o dovolených.	Administrátor	INT-OUT-VIEWERS
WarningViewers	Uživatelé, kterým se může zobrazovat varování o nepřítomnosti.	Administrátor	jira-developers
Project Vacation	Klíč projektu, do kterého se vytváří úlohy pro zadané absence (V případě nevyplnění nejsou vytvářeny)
Typ úlohy	Typ úloh, které se vytváří v projektu pro absence (Bug, Task...)
začátek nepřítomnosti	Pokud je nastaveno pole "Project vacation", tak lze ve vzniklých úlohách zobrazit pole s datem začátku absence. Uvádí se název custom fieldu- typu Datepicker
Konec nepřítomnosti	Pokud je nastaveno pole "Project vacation", tak lze ve vzniklých úlohách zobrazit pole s datem konce absence. Uvádí se název custom fieldu- typu Datepicker
Důvod nepřítomnosti	Pokud je nastaveno pole "Project vacation", tak lze ve vzniklých úlohách zobrazit pole s důvodem nepřítomnosti, které se do Faraway zadá Uvádí se název custom fieldu (textové pole)
Zástupce	Pokud je nastaveno pole "Project vacation", tak lze ve vzniklých úlohách zobrazit pole se zástupcem, který se do Faraway zadá Uvádí se název custom fieldu (user picker)
Nadřízený	Pokud je nastaveno pole "Project vacation", tak lze ve vzniklých úlohách zobrazit pole snadřízeným, který se do Faraway zadá Uvádí se název custom fieldu (user picker)
Zástupce jako řešitel	Pokud je pro záznam Faraway definován zástupce a hodnota zde je nastavena na true, poté se řešitel vzniklého issue absence nastaví na zástupce, jinak na nadřízeného
Použít org. strukturu	Příznak, zda se má pro oprávnění využívat definovaná organizační struktura (true), v opačném případě (false) se využívá uživatelská skupina "FARAWAY_USERS" (uvedení uživatelé mají možnost tvořit záznamy o své nepřítomnosti)
Postykovatel org. struktury	Můžete používat organizační strukturu jak z addonu Faraway, tak z addonu Onlio Timesheets Zde je nastavení, která bude použitá

Do uživatelských skupin Homeoffice a Vacation nevkládejte uživatele. Jedná se o pomocné interní skupiny addonu

Číselníky

Zaměstnanci mohou chybět z různých důvodů, v číselnících lze definovat výčty hodnot, kvůli kterým důvodům to je. Kromě definice lze také nastavit, zda daný typ nepřítomnosti je pracovní, či zda během této nepřítomnosti zaměstnanec nepracuje.

"Pracovní" uvádí, zda v tomto stavu zaměstnanec pracuje, např. Homeoffice atp.
"Zakázat" jestli lze či nelze zadávat do tohoto stavu (hodnota může být v číselníku definovaná, ale nemusí být povolená k zadání)

Organizační struktura

Sekce sloužící k definici množiny uživatel, kteří mohou využívat Faraway addon pro zadávání absencí, druhou variantou je využití skupiny FARAWAY_USERS. K přepnutí mezi skupinou a organizační strukturou slouží příznak Použít org. strukturu v konfiguraci addonu.

lze zde přidávat uživatele, kteří jsou již zavedeni v JIRA
k daným záznamům lze doplňovat další údaje- od informativních (zaměstnán od, oddělení) až po ty funkční (nadřízený)

Uživatelská pole (Custom fields)

Add-on používá několik polí vlastního typu, které je nutné předem definovat- např. odkaz na vytvoření záznamu při pokusu vytvořit issue absence přímo z nabídky pro vytvoření issue, nebo pole, které notifikuje o absenci aktuálně přiřazeného řešitele:

pro údaje od kdy a do kdy platí nepřítomnost
pro zástupce zaměstnance po dobu jeho nepřítomnosti

Postup pro správu custom fieldů- konkrétně vytvoření fieldu pro varovné okno notifikující o absenci řešitele (assignee):

Přihlásíme se jako uživatel s administrátorskými právy
Vybereme ikonu správy , dále Issues (úlohy)
Vybereme ve sloupci vlevo Custom fields (vlastní pole) v sekci fields (pole)
Vybereme "Add custom field"
Vybereme "Vše"
Zadáme např. "FarAway: Assignee Warning"
Vyplňte název a popis pole
Nakonec vyberte Obrazovky, kde pole chcete zobrazovat

Intelligent assignee

pokud je toto pole definováno, v případě nepřítomnosti assignee (řešitele) daného issue obsahuje hodnotu jeho zástupce

Služby

Při instalaci vzniká služba Onlio FarAway Update Job. Ta provádí pravidelné aktualizace stavů uživatelů Homeoffice a Vacation.

Addons (public)

FarAway 2.x konfigurace