Rossum API

Jelikož nepotřebujeme a ani nechceme mít plný přístup k API zákazníka, je zapotřebí v první řadě vytvořit uživatele s oprávněním pouze pro čtení, kterého budeme používat pro předávání pověření ke stažení originálního dokumentu. Aktuální verze uživatelského rozhraní ukrývá správu uživatelů pod položkou Správa uživatelů v menu uživatele (vpravo nahoře).

Zde už stačí tlačítkem Přidat uživatele (vpravo nahoře) zobrazit dialogové okno pro přidání nového uživatele, zadat Jméno a příjmení (tip: aktuálně není nijak kontrolován formát tohoto pole, takže lze pro lepší odlišení od ostatních uživatelů použít generické jméno, např. Sofa nebo Spouštěcí události) a E-mail, který slouží pro přihlášení a na který dorazí pozvánka s odkazem na nastavení hesla, a vybrat roli Čtenář. Volba Přiřadit uživatele ke všem frontám by měla zůstat nezaškrtnutá.

Pokud již máme fronty vytvořené dopředu, je snazší k nim uživateli udělit přístup/oprávnění na záložce Správa přístupů v konfiguraci uživatele.

Při konfiguraci u zákazníka je vhodnější vytvořit pro každou agendu vlastní frontu, ve speciálních případech může být pro jednu agendu/rozšíření front více, např. z důvodu nastavení oprávnění pro různé uživatele, rozdílné legislativy zpracovávaných dokumentů, úpravě schéma vytěžených datových polí apod. V aktuální verzi uživatelského rozhraní lze frontu přidat tlačítkem Přidat a volbou Přidat frontu na záložce Dokumenty (v záhlaví seznamu front vlevo nahoře), případně změnit nastavení existující fronty tlačítkem Nastavení fronty (v záhlaví aktuální fronty uprostřed nahoře).

V dialogovém okně pro přidání fronty stačí zadat název fronty do pole Název a vybrat výchozí schéma vytěžených datových polí. Pokud máme více pracovních prostorů, lze správný vybrat volbou Workspace.

Aby bylo možné v Sofa stahovat originální dokumenty, je nutné nastavit oprávnění uživateli vytvořeném v kroku Konfigurace uživatele s oprávněním pouze pro čtení. V aktuální verzi uživatelského rozhraní najdeme tuto volbu na záložce Správa přístupů.

Pokud zákazník vyžaduje automatický export vytěžených dat, potom je možné výchozí manuální export vypnout v nastavení fronty. V aktuální verzi uživatelského rozhraní najdeme tuto volbu na záložce Základní nastavení v sekci Záložka "Potvrzené". Zde stačí přepnout volbu Používat záložku "Potvrzené" do stavu vypnuto.

Pro export vytěžených dat do Sofa je nutné nakonfigurovat v Rossumu rozšíření typu Webhook pro každou spouštěcí událost. Pro praktické použití má smysl pouze konfigurace 1:1, tzn. jedno rozšíření pro jednu spouštěcí událost. V aktuální verzi uživatelského rozhraní lze rozšíření přidat/konfigurovat na záložce Rozšíření » Moje rozšíření, kde vpravo nahoře najdeme tlačítko Vytvořit rozšíření, případně můžeme kliknout na již existující rozšíření pro změnu nastavení.

Vzhledem k rozsáhlosti nastavení rozšíření zde chybí snímek obrazovky.

Pro vytvoření nového rozšíření je nutné zadat název rozšíření do pole Jméno, vybrat událost spuštění typu Obsah dokumentu » Exportování (jiné typy událostí nejsou aktuálně podporovány a generovaly by zbytečně chybová hlášení do logu), vybrat frontu, resp. fronty pro konfigurovanou spouštěcí událost, vybrat typ rozšíření typu Webhook a nastavit URL a sdílený tajný klíč z nastavení spouštěcí události v Sofa. Pro konfiguraci přístupu k originálnímu dokumentu je ještě nutné v pokročilých nastavení vybrat vlastníka tokenu v sekci Přístup k Rossum API z rozšíření, bez toho nebude možné stáhnout originální dokument a spouštěcí událost vždy selže! Ze seznamu uživatelů proto stačí vybrat uživatele vytvořeného v kroku Konfigurace uživatele s oprávněním pouze pro čtení.