Asistované nastavení Tempo Integrace

Asistované nastavení

Pomocí vyhledávacího panelu otevřete aplikaci Asistované nastavení. Vyhledejte položku Nastavení Tempo Integrace a spusťte ji kliknutím na její název. Poté se zobrazí průvodce nastavením. Chcete-li pokračovat, zvolte možnost Další.

Open

Výchozí hodnoty a vytváření zdrojů

V následujících dvou krocích je potřeba nastavit výchozí hodnoty, které bude systém automaticky vyplňovat při vytváření deníků projektů, a zda chcete automaticky vytvářet nové zdroje při stahování worklogů do systému Business Central.

Open

Hodnotu Výchozí Obecné účto skupiny zboží zdroje lze nastavit na libovolnou účto skupinu podle potřeb vašeho systému, např. Různé.

Autentizační metody

Jira podporuje dvě hlavní metody autentizace.

Basic autentizaci, kterou je jednodušší nastavit, ale je nutné ji každé tři měsíce obnovovat. Tuto metodu doporučujeme, pokud s naší integrací teprve začínáte a chcete si vyzkoušet její celkovou funkcionalitu a otestovat volání API.

Vzhledem k tomu, že se od metody Basic bude postupně upouštět, doporučujeme pro každodenní provoz v produkčním prostředí používat metodu OAuth 2.0 využívající tzv. bearer token. Tato metoda je bezpečnější, má o něco složitější nastavení, ale platnost tokenu je pravidelně automaticky aktualizována, aniž by na to musel uživatel myslet.

Na druhou stranu Tempo podporuje pouze OAuth 2.0 metodu.

Na základě výše uvedených možností jsme navrhli dva způsoby, jak se můžete autentizovat: Autentizace pomocí souhlasu uživatele, která odpovídá metodě autentizace OAuth 2.0 v systémech Jira i Tempo. Pokud se rozhodnete použít tuto metodu, ponechte zapnutá obě přepínací tlačítka ze snímku obrazovky výše.

Druhou možností autentizace je Autentizace pomocí vložení tokenu, která odpovídá metodě Basic autentizace v systému Jira a metodě OAuth 2.0 v systému Tempo. Pokud se rozhodnete používat tento typ autentizace, na snímku obrazovky výše vypněte obě přepínací tlačítka.

Autentizace pomocí souhlasu uživatele (OAuth 2.0)

Pokud jste zvolili tuto metodu autentizace, ponechte obě přepínací tlačítka na třetí stránce průvodce nastavením zapnutá.

Redirect URI

Redirect URI určuje adresu, na kterou Jira a Tempo přesměrují prohlížeč během procesu autentizace. Formát adresy se vždy skládá z URL adresy vašeho systému Business Central, včetně ID tenantu a názvu prostředí, a na konec je potřeba přidat /OAuthLanding.htm.

Přístupové údaje k Jira a Tempo

V tomto kroku je potřeba vyplnit přihlašovací údaje k aplikacím Jira a Tempo.

Hodnota Jira Base URL je URL adresa vaší společnosti v systému Jira, například https://my-company-jira-url.atlassian.net/.

Hodnoty vašeho Jira Client ID a Jira Client Secret můžete získat z vašeho Jira vývojářského účtu na https://developer.atlassian.com/.

Jděte do vývojářské konzole a vytvořte novou aplikaci.

Při vytváření nové aplikace pomocí tlačítka Create v pravém horním rohu obrazovky je potřeba aplikaci pojmenovat a zadat typ integrace OAuth 2.0.

Po otevření aplikace se zobrazí stránka s několika menu položkami. V části Overview není nutné nic nastavovat. V části Distribution stačí nastavit aplikaci jako soukromou výběrem možnosti Not sharing.

V části Permissions vyberte možnost Jira API a pro Jira Platform REST API zaškrtněte oprávnění View Jira issue data a View user profiles pomocí tlačítka Edit Scopes v pravém horním rohu obrazovky.

V části Authorization je potřeba zadat Callback URL, které odpovídá Redirect URI nakonfigurovanému v předchozím kroku průvodce.

V části Settings pak naleznete informace potřebné k dokončení vašeho nastavení připojení k aplikaci Jira, hodnoty vašeho Jira Client ID a Jira Client Secret.

Chcete-li získat hodnoty Tempo Client ID a Tempo Client Secret, jděte do nastavení aplikace Tempo, klikněte na Oauth 2.0 Applications v sekci Data Access v postranní nabídce nalevo a vytvořte novou aplikaci kliknutím na tlačítko v pravém horním rohu stránky.

V dalším kroku se zobrazí krátký formulář, do kterého je potřeba zadat název aplikace, redirect URI adresu, kterou jste již konfigurovali v předchozích krocích průvodce nastavením, a nastavit hodnotu Client Type na Confidential.

V dalším kroku získáte potřebné přístupové údaje. Nyní je můžete zkopírovat do průvodce nastavením v Business Central.

Číslo pole Account

V tomto kroku je třeba získat číslo pole účtu Tempo přidruženého k vašim projektům Jira. Tuto hodnotu získáte tak, že kliknete na tři tečky na řádku níže a číslo pole se samo doplní.

Po dotažení čísla pole pro účet Tempo můžete připojení otestovat pomocí našich automatizovaných testů v následující části průvodce nastavením s názvem Testy API klíčů a oprávnění.

Autentizace pomocí vložení tokenu (Basic and OAuth 2.0)

Pokud jste zvolili tuto metodu autentizace, ponechte obě přepínací tlačítka na třetí stránce průvodce nastavením vypnutá.

Při použití metody Autentizace pomocí vložení tokenu bude obrazovka nastavení vypadat takto:

Přístupové údaje k Jira a Tempo

Nyní můžete přejít k nastavení připojení k systému Jira.

Hodnota Jira Base URL je URL adresa vaší společnosti v systému Jira, například https://my-company-jira-url.atlassian.net/.

Hodnota Jira API Email je e-mail uživatelského účtu Jira, prostřednictvím kterého se bude integrace vytvářet. Pokud si nejste jisti, jakou úroveň oprávnění by měl mít váš uživatel Jira, podívejte se na naše obecná doporučení na začátku hlavní dokumentace Tempo Integrace.

Chcete-li získat Jira API klíč, přejděte do svého prostředí Jira a vyhledejte nastavení účtu Atlassian, které je dostupné přes ozubené kolečko v pravém horním rohu hlavního horizontálního menu.

Jakmile se dostanete do nastavení účtu, vyhledejte v horním horizontálním menu záložku Security a poté vyhledejte API tokens. Vytvořte nový token pomocí tlačítka Create API token button.

V dalším kroku budete vyzváni k zadání a potvrzení názvu tokenu. Na následující obrazovce se zobrazí váš Jira API klíč, který můžete zkopírovat do průvodce nastavením v Business Central.

Jakmile je nastaveno připojení k systému Jira, můžete přejít k části Nastavení připojení k Tempo.

Chcete-li získat hodnotu Tempo Access Token, jděte do nastavení aplikace Tempo, klikněte na API Integration v sekci Data Access v postranní nabídce nalevo a vytvořte nový token kliknutím na tlačítko v pravém horním rohu stránky. Do formuláře, který se zobrazí, zadejte název tokenu.

Doba platnosti může být obvykle nastavena na 30, 90 nebo 365 dní.

Poté vyberte z možností přístupu možnost Custom Access. V možnostech oprávnění, které se zobrazí níže, zaškrtněte všechna oprávnění View a oprávnění Manage ponechte nezaškrtnutá, protože integrace nebude provádět žádné změny v datech. Jakmile jsou oprávnění nastavena, potvrďte výběr.

Poté, co nastavení potvrdíte, obdržíte svůj Tempo Access token, který pak zkopírujete do průvodce nastavením v aplikaci Business Central.

Číslo pole Account

Číslo pole Tempo účtu přidruženého k projektům Jira lze získat stejným způsobem jako u autentizace pomocí souhlasu uživatele. Podrobné pokyny najdete v příslušné části dokumentace.

Po dotažení čísla pole pro účet Tempo můžete připojení otestovat pomocí našich automatizovaných testů v následující části průvodce nastavením s názvem Testy API klíčů a oprávnění.

Testy API klíčů a oprávnění

V této části budete vyzváni k zadání klíče pro jeden z vašich stávajících projektů Jira a klíče pro jeden z účtů Tempo, které používáte k logování času na tasky v rámci tohoto projektu. Poté použijte akci Otestovat API klíče v pravém dolním rohu.

Pomocí testů můžete ověřit, že má integrace přístup k vámi zadanému projektu a účtu Tempo a že může stáhnout potřebné informace. Zároveň takto můžete zjistit, zda má váš Jira uživatel dostatečná oprávnění, aby mohla integrace správně fungovat.

Pokud testy proběhnou úspěšně, bude příslušný řádek vyplněn zeleným nápisem OK. V případě chyby se zobrazí podrobnosti o daném volání API.

Testy jsou pro oba typy autentizace stejné.

Nastavení Fronty úloh

Vzhledem k tomu, že vaše worklogy budou stahovány prostřednictvím položky fronty úloh, můžete si v této části průvodce nastavením definovat datum, do kterého zůstane období předchozího měsíce otevřené, a přizpůsobit tak délku tohoto období potřebám vaší společnosti.

Na příkladu ze snímku obrazovky níže lze worklogy za předchozí měsíc stahovat až do 5. dne aktuálního měsíce, ale pokud systém stáhne worklogy po tomto datu, do vašeho Business Central se již stáhnou pouze záznamy za aktuální měsíc.

V dalším kroku budete vyzváni k vytvoření položky fronty úloh pro automatické stahování pracovních záznamů z aplikace Tempo. Když kliknete na akci Vytvořit frontu úloh v pravém dolním rohu, systém pro vás vytvoří novou položku fronty úloh a jediné, co musíte udělat, je nastavit stav položky na hodnotu Připraveno.

Pokud v systému z nějakého důvodu už fronta úloh existuje (například při změně metody autentizace), systém vás na to upozorní.

Níže naleznete příklad fronty úloh, kterou pro vás vytvoří naše integrace. Jedná se o standardní položku fronty úloh Business Central. Pokud se o ní chcete dozvědět více podrobností, nahlédněte do příslušné části hlavní dokumentace.