...
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. Tuto metodu zvolíte vypnutím obou přepínacích tlačítek, které vidíte napravo.
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 , která 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.
| Info |
|---|
Obě možnosti autentizace jsou podrobně popsány v následujících kapitolách. Pro účely této dokumentace jsou dostupné metody autentizace popsány ve dvojicích, ale můžete je libovolně kombinovat. Při přechodu z jedné metody na druhou je pouze potřeba se ujistit, že jsou vyplněny všechny požadované přístupové údaje. Při přechodu z autentizace pomocí vložení tokenu na autentizaci pomocí souhlasu uživatele je navíc potřeba použít obě funkce Autorizovat Tempo a Autorizovat Jira. |
| Note |
|---|
V případě, že byste si naše řešení nainstalovali, nastavili na autentizaci OAuth 2.0 a několik měsíců jej nepoužili, se může stát, že po takto dlouhé prodlevě se již API tokeny automaticky neobnoví, což by znamenelo, že nebudete moci stahovat nové worklogy. V takové situaci stačí použít naše akce Autorizovat Tempo a Autorizovat Jira, které jsou k dispozici v Průvodci asistovaným nastavením i v Nastavení Tempo integrace. |
...
Autentizace pomocí souhlasu uživatele (OAuth 2.0
...
Číslo pole Account
...
)
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.
| Tip |
|---|
Při zadávání těchto informací se ujistěte, že jste správně zadali všechna lomítka. Zde je příklad pro kontrolu vaší adresy: https://businesscentral.dynamics.com/tenant/environmentName/OAuthLanding.htm |
po úpravě vyměnit screenshot
...
Přístupové údaje k Jira a Tempo
...
| Tip |
|---|
Po úspěšném vygenerování obou přístupových údajů Tempo a jejich zadání do průvodce nastavením klikněte na tlačítko Autorizovat Tempo v pravém dolním rohu okna průvodce.  Úspěšnost akce poznáte podle toho, že se zobrazí níže uvedená hláška.Po schválení připojení k aplikacím Jira a .  |
Čí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í.
...
| Note |
|---|
Pozor, v průběhu nastavování všech kroků na této stránce, je nutné dodržet pořadí, v jakém jdou jednotlivé sekce za sebou a zvolit odpovídající akce pro autorizaci, jinak se vám číslo pro účet Tempo nevyplní správně.
|
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 Basic, nechte ponechte obě přepínací tlačítka na třetí stránce průvodce nastavením vypnutá.
...
Při použití metody Basic autentizace Autentizace pomocí vložení tokenu bude obrazovka nastavení vypadat takto:
...
Číslo pole Account
...
Přístupové údaje k Jira a Tempo
Poté Nyní můžete pokračovat přejít k nastavení připojení k systému Jira.
...
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.
...
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.
Co se týká doby platnosti, systém vám může nabídnout až 365 dní pro každý token, nejdelší období, které si však obvykle můžete vybrat, je 90 dní (a kratší, pokud chcete tokeny obnovovat častěji)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.
| Info |
|---|
Pokud potřebujete obnovit platnost svého tokenu Tempo, můžete tak učinit pomocí funkce Regenerate, která je dostupná z nabídky se třemi tečkami na řádku s tokenem, nebo můžete vytvořit nový token. |
...
...
Čí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í.
...
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 přednastavit definovat datum, po kterém již nebudou stahovány worklogy z předchozího měsíce.Pokud se budeme řídit příkladem ze screenshotu níže, kde jsme si určili, že další období začíná 5. den následujícího měsíce, předpokládejme, že je březen a vy chcete stáhnout worklogy za únor. Toto je možné provádět až do 5. března, pokud stáhnete 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.
| Info |
|---|
Pokud provedete změny ve worklozích předchozího měsíce v systému Tempo po datu začátku dalšího období, budete muset upravené worklogy stáhnout ručně. |
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 worklogy záznamy za březenaktuá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.
...