Dropbox
Aplikace Requestor nabízí v rámci možnosti integrace se službami třetích stran napojení na cloudové úložiště Dropbox. Po nastavení a úspěšném propojení se u komentářů požadavků objeví nové tlačítko pro přidání přílohy ke zprávě, které umožní výběr (případně nahrání a následný výběr) souboru přímo z úložiště Dropbox.
Charakter služby Dropbox (v době tvorby tohoto návodu) umožňuje využití integrace jak pro osobní, tak skupinové (firemní) účty. Výběrem konkrétního souboru dojde zároveň k vytvoření veřejného odkazu, který ve výchozím nastavení opravňuje kohokoli s tímto odkazem ke čtení (zobrazení) a stažení souboru.
Konfigurace integrace zahrnuje nastavení na straně samotné služby Dropbox a následné nastavení v aplikaci Requestor.
Dropbox: Registrace aplikace
Prvním krokem je registrace aplikace přímo v rámci služby Dropbox. Za tímto účelem využijeme platformu DBX (DBX Platform for Developers), ve které přejdeme do sekce App Console (vyžaduje přihlášení ke službě), v ní pak klikneme na tlačítko Create app. Alternativně můžeme využít přímý odkaz:
URL: https://www.dropbox.com/developers/apps/create
Na stránce v prvním kroku vybereme Scoped access.
Ve druhém kroku (Choose the type of access you need) vybereme Full Dropbox. Ve třetím kroku zvolíme vhodný název aplikace (např. Requestor).
Poté klikneme v pravé spodní části stránky na tlačítko Create app.
Název aplikace v rámci služby Dropbox musí být jedinečný. Zvolením příliš obecného názvu se může stát, že název využívá již jiný zákazník, a v takovém připadě je potřeba zvolit nějaký méně univerzální název. V názvu zároveň nesmí být obsaženo slovo Dropbox.
Takto nějak vypadá situace, kdy vybereme příliš obecný název:
Je tedy potřeba do názvu přidat například název společnosti, nebo nějaký jiný text, který bude v rámci celého Dropboxu jedinečný.
Po vytvoření aplikace budeme automaticky přesměrováni do jejího nastavení, kde v primární záložce Settingsvyhledáme sekci OAuth 2 a v ní vyplníme Redirect URIs - přidáme adresu aplikace Requestor (na screenshotu níže je pouze příklad), klikneme na Add (dojde k přidání adresy) a ujistíme se, že hodnota Allow public clients je nastavena na Allow.
Stejným způsobem přidáme i doménu v sekci Chooser / Saver / Embedder domains.
Na této záložce si ještě zkopírujeme App key, což je hodnota, která se nachází nad sekcí OAuth 2.
Nyní přejdeme do záložky Permissions.
Zde je potřeba v sekci Files and folders povolit files.metadata.read a files.content.read, dále pod OpenID Scopes v sekci Connect mít zaškrtnuté volby profile, openid a email.
Jakmile budeme mít vše nastavené, klikneme na Submit na liště ve spodním okraji stránky.
V tento okamžik je možné integraci otestovat (konfigurace v aplikaci Requestor je popsaná v další části návodu).
Aby bylo možné nově vytvořenou aplikaci ve službě Dropbox plně využívat, je nutné kromě výše uvedeného přejít také do záložky Branding, kde je potřeba přidat požadované informace a grafické prvky.
Posledním krokem pak bude v hlavní záložce Settings kliknout na tlačítko Apply for production, čímž dojde k odstranění omezení využití aplikace pro konkrétní uživatele, které se aplikuje ve fázi Development. Aktuální požadavky služby Dropbox pro produkční využití aplikace naleznete v Reference Guide - Developers.
Requestor: Aktivace integrace
Ve druhé fázi konfigurace přejdeme do aplikace Requestor, kde v administraci přejdeme do kategorie Integrace/Aplikace a klikneme na Dropbox.
V nově otevřeném okně aktivujeme rozšíření a vložíme App key, který jsme si zkopírovali během konfigurace služby Dropbox. Potvrdíme tlačítkem Uložit.
Tím je konfigurace integrace na straně aplikace Requestor dokončena.
Přiložení přílohy k požadavku
Ve chvíli, kdy máme provedená všechna potřebná nastavení v předchozích částech tohoto návodu, máme nově možnost přidávat ke komentářům v požadavcích přílohy z úložiště Dropbox.
Pod textem komentáře se po aktivaci integrace bude zobrazovat nové tlačítko, na které klikneme:
Otevře se nám nové okno (v prohlížeči je potřeba mít povolená vyskakovací okna, dále je nutné přihlášení ke službe Dropbox), ve kterém máme možnost procházet dokumenty, vybrat soubor, který chceme přiložit, a pro potvrzení kliknout na tlačítko Choose.
Tímto způsobem máme možnost přiložit jeden či více dokumentů. Přiložené dokumenty jsou standardně viditelné u komentáře, včetně textu v závorce, který signalizuje fakt, že jsme přiložili dokument ze služby Dropbox.
Takto je následně komentář viditelný všem uživatelům, kteří mají potřebná oprávnění k zobrazení daného požadavku. Autor komentáře, který přidal přilohu, má také možnost přílohu odstranit.
Přílohy je možné standardně editovat i při editaci komentáře (včetně možnosti přidat další přílohy, i třeba z různých jiných zdrojů).