Import dat z REST API

Do různých agend systému GIRITON lze importovat záznamy z jiných podnikových systémů také přes REST API. Nabízí-li váš podnikový systém možnost číst z něj záznamy pomocí REST API, můžete v GIRITONu přidat plánovanou úlohu, která bude tyto záznamy přes REST API pravidelně stahovat a do GIRITONu je importovat.

Novou plánovanou úlohu přidáte ve webové aplikaci GIRITON přes Menu uživatel -> Správa -> Plánované úlohy -> Přidat -> Import z REST API.

Následně v dialogu zadejte agendu, do které budete v GIRITONu importovat záznamy (například Personalistika, Projekty, ...).

Do pole Adresa zadejte URL adresu daného REST API, ze kterého se mají záznamy načítat.

Do pole JSON cesta zadejte název pole v JSON odpovědi, ve které leží jednotlivé záznamy. Pole bude buď prázdné, anebo sem patří obvykle něco jako record, entries nebo result, dle konkrétního REST API.

Do tabulky Hlavička můžete zadat HTTP headers, které se mají v REST API požadavku předat. Sem často patří token, který se u daného REST API použije pro ověření.

Klikněte na Další.

Importér při importu pozná, které záznamy už v GIRITONu existují a u těch pouze aktualizuje případná změněná políčka. Záznamy, které v GIRITONu ještě neexistují, nově založí. To, podle kterého políčka pozná importér nový resp. existující záznam, nastavujete ve volbě Záznamy spárovat pomocí.

V tabulce Náhled importovaných dat vidíte, jaká data jsou na daném REST API k dispozici a jak jsou pojmenované sloupce, ve kterých jsou jednotlivé hodnoty uloženy.

V tabulce Mapování importovaných dat na pole v GIRITONu pak nastavujete párování, která data z REST API se mají propsat do jakých políček dané agendy v GIRITONu. Vyberte tedy odpovídající nastavení.

Nakonec klikněte na Další.

V posledním kroku zobrazí importér, co bude provedeno. Tedy kolik záznamů bude přidáno a kolik aktualizováno, pokud import provedete. V tomto kroku pečlivě zkontrolujte navrhované změny a případně revidujte nastavení importéru klikem na Zpět.

Pokud vše vypadá v pořádku, klikněte na Přidat. Tím se provede přidání této plánované úlohy, nikoli její spuštění. Plánovaná úloha je navíc ve výchozím stavu deaktivovaná, to znamená, že se automaticky nespouští.

Nově založenou plánovanou úlohu vyberte a klikněte Spustit ručně. Zobrazí se opět dialog s informacemi, kolik záznamů bude přidáno popř. upraveno. Klikem na Importovat data se provede import dat do vybrané agendy.

Pokud jste s výsledkem spokojeni, můžete u této Plánované úlohy aktivovat zatržítko Aktivní a uložit změny. Tím se bude Plánovaná úloha spouštět automaticky každých několik minut.