¶ Dropbox
Pro integraci factorify se službou Dropbox je potřeba v ní nejdříve vytvořit aplikaci.
- Přihlašte se do účtu Dropbox a přejděte na stánku https://www.dropbox.com/developers/apps/create.
- Pro krok Choose an API vyberte Scoped access.
- Pro krok Choose the type of access you need vyberte Full Dropbox.
- Zadejte jméno aplikace a klikněte na Create app.
Budete přesměrování na stránku aplikace. Nyní je potřeba ji správně nakonfigurovat.
Pokuď nepotřebujete produkční status klikněte na Enable additional users aby aplikaci mohli používat I další uživatelé.
V sekci Redirect URIs přidejte adresu <adresa-factorify-prostředí>/dropbox-authorization. Například tedy https://test.factorify.cloud/ui/dropbox-authorization. Toto bude klíč dropbox.factorifyRedirectUrl.
Poznamenejte si hodnoty
App key – toto bude klíč dropbox.appKey
App secret – toto bude klíč dropbox.appSecret
V Permissions záložce musí být zatrženy alespoň oprávnění na files.metadata.write a files.content.write ze sekce Files and folders a sharing.write ze sekce Collaboration.
Kontaktní osobě z factorify předejte hodnoty dropbox.appKey, dropbox.appSecret a dropbox.factorifyRedirectUrl.
K autorizaci do Dropboxu slouží agenda Autorizace Dropboxu, kterou najdete v Nastavení -> Globální. Je nutné oprávnění SYSTEM_CONTROL. Autorizace se provede pouze pod jedním účtem a je platná pro všechny uživatele ve FY.
Po úspěšné autorizaci je token uložen ve volném atributu na Globálních parametrech.
Pokud se změní např. Permissions v nastavení dropbox aplikace, tak bude potřeba znovu autorizovat.
Vzhledem k interní povaze této aplikace uvidíte toto upozornění. Pokud chcete integraci používat, klikněte Continue.
Zde souhlaste s tím že bude mít aplikace vytvořená v první sekci přístup k vašemu Dropbox účtu a poté budete přesměrováni na stránku dropbox.factorifyRedirectUrl.
Poté co bude potvrzena autorizace pro Dropbox můžete pokračovat v používání factorify.
V Globálních parametrech je potřeba vytvořit volný atribut s kódem DROPBOX_REFRESH_TOKEN typu text a nastavie pouze pro čtení. Do tohoto volného atributu se pak ukládá refresh token.
¶ BPM funkce
| funkce | popis, příklad |
|---|---|
milt.copyFolderOnDropbox(String copyFrom, String copyTo) |
zkopíruje obsah adresáře copyFrom do adresáře copyTo a vrací sdílenou url k novému adresáři. Pokud adresář copyTo neexistuje, tak se automaticky vytvoří.copyFrom - relativní cesta vzorováho adresáře, ze kterého se zkopíruje obsah, např. 'HOME/project template'copyTo - relativní cesta adresáře, do kterého se zkopíruje obsah vzorového adresáře, např. 'HOME/projekty 2025/123 Hrad' |
milt.getDropboxSharedLink(String relativePath) |
vrací sdílenou url adresáře podle 'relativePath' |