...
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. |
...
V tomto kroku je třeba získat ID pole účtu Tempo přidruženého k vašim projektům Jira. Tuto hodnotu získáte jednoduše pomocí akce xx.tak, že přejdete do libovolného projektu v systému Jira, otevřete libovolný task nebo issue v tomto projektu, kliknete na něj pravým tlačítkem myši a z kontextového menu vyberete akci Prozkoumat, která otevře vývojářský režim v prohlížeči.
Vyberte nástroj pro průzkum jednotlivých prvků uživatelského rozhraní v levém horním rohu okna nástroje pro vývojáře a poté najeďte na pole Tempo Account, které obsahuje název účtu Tempo přiřazeného k projektu. Toto pole se nachází v části Details na daném tasku.
Nástroj pro kontrolu prvků UI umožňuje vybrat prvek uživatelského rozhraní v jedné části obrazovky a zobrazit odpovídající kód HTML v okně nástroje pro vývojáře. Následně vyhledejte hodnotu property s názvem customfield, která má podobu pětimístného čísla.
...
| Tip |
|---|
Vzhledem k tomu, že se nejedná o jediné customfield property v kódu, ujistěte se, že je nástroj pro kontrolu prvků zaměřen na správnou oblast obrazovky. Pokud akci Prozkoumat nemůžete najít, doporučujeme ověřit, jak je pojmenována vývojářská konzole ve vašem prohlížeči, jelikož se názvy této funkcionality mohou lišit. Je však k dispozici ve všech hlavních prohlížečích |
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 |
|---|
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 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 metodu autentizace Basic, nechte obě přepínací tlačítka na třetí stránce průvodce nastavením vypnutá.
...
ID pole Tempo účtu přidruženého k projektům Jira lze získat stejným způsobem jako u autentizační metody OAuth 2.0, k získání této hodnoty stačí použít akci xxautentizace pomocí vložení tokenu. Podrobné pokyny najdete v příslušné části dokumentace.
Přístupové údaje k Jira a 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.
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. |
...
Po schválení připojení k aplikacím Jira a 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.
...