Dosys:Integrace JOBKA: Porovnání verzí
(→Odkazy) |
|||
| (Není zobrazeno 14 mezilehlých verzí od stejného uživatele.) | |||
| Řádek 1: | Řádek 1: | ||
{{DISPLAYTITLE:Integrace se systémem JOBKA}} | {{DISPLAYTITLE:Integrace se systémem JOBKA}} | ||
{{VERSIONINFO|Dosys|5.1.1. | {{VERSIONINFO|Dosys|5.1.1.12}} | ||
== Přehled == | == Přehled == | ||
Systém [https://www.jobka.cz JOBKA] nabízí vysoce konfigurovatelnou mobilní aplikaci pro komunikaci se zaměstnanci firmy. Integrace se systémem DOSYS zajišťuje prezentaci docházkových dat v mobilní aplikaci, předávání oznámení zaměstnanci do mobilní aplikace a import požadavků, zadaných zaměstnancem v aplikaci (například žádost o dovolenou). | Systém [https://www.jobka.cz JOBKA] nabízí vysoce konfigurovatelnou mobilní aplikaci pro komunikaci se zaměstnanci firmy. Integrace se systémem DOSYS zajišťuje prezentaci docházkových dat v mobilní aplikaci, předávání oznámení zaměstnanci do mobilní aplikace a import požadavků, zadaných zaměstnancem v aplikaci (například žádost o dovolenou). | ||
== Konfigurace == | == Konfigurace == | ||
Obecné parametry integrace se nastavují v [[{{NAMESPACE}}:Konfigurace#Integrace_se_systémem_JOBKA|konfiguraci]] aplikace. [[{{NAMESPACE}}:Konfigurační soubor|Konfigurační soubor]] aplikace pak obsahuje nastavení přístupu k API jobka a pro speciální případy i přístup k aplikaci JOBKA. | |||
== Export dat docházky == | == Export dat docházky == | ||
Do systému JOBKA lze exportovat měsíční data docházky, denní data docházky a plán směn. Vzhledem k tomu, že prezentace docházkových dat v systému JOBKA není pevně dána, je možné (a někdy i nutné) export dat uzpůsobit pro konkrétní implementaci zákazníka JOBKA. Dosys | Do systému JOBKA lze exportovat měsíční data docházky, denní data docházky a plán směn. Vzhledem k tomu, že prezentace docházkových dat v systému JOBKA není pevně dána, je možné (a někdy i nutné) export dat uzpůsobit pro konkrétní implementaci zákazníka JOBKA. Dosys podporuje následující způsoby exportu dat. | ||
=== Export pomocí naplánované úlohy DOSYS === | === Export pomocí naplánované úlohy DOSYS === | ||
[[{{NAMESPACE}}:Naplánované úlohy| | Příkazy konzoly, volané pomocí [[{{NAMESPACE}}:Naplánované úlohy|naplánované úlohy]] systému DOSYS používají pro uložení dat API systému JOBKA. Zápis dat do JOBKY je vždy prováděn v inkrementálním režimu, proto je nutné před importem zajistit smazání existujících dat pomocí příkazu ''jobka:clearData''. | ||
V případě multi-tennant instalace JOBKA, kdy je nutné do jedné instance JOBKA nahrávat data z více instancí systému DOSYS je nutné postupovat následně. | |||
* vytvořit jednu naplánovanou úlohu, která zajistí smazání všech dat JOBKA. Plán spuštění nastavit tak, aby se spustila jako první. | |||
* v každé instanci systému Dosys vytvořit naplánované úlohy, zajišťující export dat. Plán spuštění nastavit tak, aby se každá instance spouštěla v jiném čase, s minimálním odstupem 5 minut. | |||
=== Export dat pomoci API === | === Export dat pomoci API === | ||
| Řádek 20: | Řádek 24: | ||
== Upozornění prostřednictvím aplikace JOBKA == | == Upozornění prostřednictvím aplikace JOBKA == | ||
Pro každého zaměstnance existuje v systému JOBKA unikátní e-mailová adresa. Všechny zprávy na tuto adresu doručené jsou předány jako upozornění do aplikace JOBKA v mobilním telefonu. Tohoto využívá systém DOSYS, který pomocí [[{{NAMESPACE}}:Naplánované úlohy|naplánované úlohy]] umí převzít e-mailové adresy z API JOBKA a uložit je do [[{{NAMESPACE}}:Zaměstnanci|zaměstnance]] do pole ''E-mail pro upozornění''. | Pro každého zaměstnance existuje v systému JOBKA unikátní e-mailová adresa. Všechny zprávy na tuto adresu doručené jsou předány jako upozornění do aplikace JOBKA v mobilním telefonu. Tohoto využívá systém DOSYS, který pomocí příkazu [[{{NAMESPACE}}:Naplánované úlohy|naplánované úlohy]] ''jobka:importEmails'' umí převzít e-mailové adresy z API JOBKA a uložit je do [[{{NAMESPACE}}:Zaměstnanci|zaměstnance]] do pole ''E-mail pro upozornění''. | ||
== Import žádostí o dovolenou == | == Import žádostí o dovolenou == | ||
{{ | Systém DOSYS podporuje import [[{{NAMESPACE}}:Požadavky|žádostí]] o dovolenou ze systému JOBKA. | ||
=== Import nových žádostí === | |||
Systém získává žádosti prostřednictvím API JOBKA. Systém JOBKA zajistí pouze přijetí žádosti, schvalování a odesílání upozornění zaměstnancům zajišťuje systém DOSYS. Informace o změně stavu žádosti jsou předávány zpět do aplikace JOBKA. | |||
=== Import schválených žádostí === | |||
Toto řešení využívá existujícího systému schvalování v systému JOBKA. Schválené žádosti importuje nestandardně pomocí volání formuláře přímo z aplikace JOBKA (JOBKA aktuálně nepodporuje přístup k těmto žádostem pomocí API). Vyžaduje tedy nastavení přístupu k aplikaci JOBKA v konfiguračním souboru. | |||
Jedná se o dočasné řešení a bude v dalších verzích aplikace odstraněno. | |||
== Odkazy == | == Odkazy == | ||
[[{{NAMESPACE}}:Konfigurační soubor|Konfigurační soubor]] | |||
[[{{NAMESPACE}}:Domovská stránka|Domovská stránka]] | [[{{NAMESPACE}}:Domovská stránka|Domovská stránka]] | ||
Aktuální verze z 10. 10. 2024, 12:43
Dosys 5.1.1.12
Přehled
Systém JOBKA nabízí vysoce konfigurovatelnou mobilní aplikaci pro komunikaci se zaměstnanci firmy. Integrace se systémem DOSYS zajišťuje prezentaci docházkových dat v mobilní aplikaci, předávání oznámení zaměstnanci do mobilní aplikace a import požadavků, zadaných zaměstnancem v aplikaci (například žádost o dovolenou).
Konfigurace
Obecné parametry integrace se nastavují v konfiguraci aplikace. Konfigurační soubor aplikace pak obsahuje nastavení přístupu k API jobka a pro speciální případy i přístup k aplikaci JOBKA.
Export dat docházky
Do systému JOBKA lze exportovat měsíční data docházky, denní data docházky a plán směn. Vzhledem k tomu, že prezentace docházkových dat v systému JOBKA není pevně dána, je možné (a někdy i nutné) export dat uzpůsobit pro konkrétní implementaci zákazníka JOBKA. Dosys podporuje následující způsoby exportu dat.
Export pomocí naplánované úlohy DOSYS
Příkazy konzoly, volané pomocí naplánované úlohy systému DOSYS používají pro uložení dat API systému JOBKA. Zápis dat do JOBKY je vždy prováděn v inkrementálním režimu, proto je nutné před importem zajistit smazání existujících dat pomocí příkazu jobka:clearData.
V případě multi-tennant instalace JOBKA, kdy je nutné do jedné instance JOBKA nahrávat data z více instancí systému DOSYS je nutné postupovat následně.
- vytvořit jednu naplánovanou úlohu, která zajistí smazání všech dat JOBKA. Plán spuštění nastavit tak, aby se spustila jako první.
- v každé instanci systému Dosys vytvořit naplánované úlohy, zajišťující export dat. Plán spuštění nastavit tak, aby se každá instance spouštěla v jiném čase, s minimálním odstupem 5 minut.
Export dat pomoci API
Datové soubory docházky JOBKA lze získat pomocí REST API aplikace DOSYS. Získané soubory lze nahrát na SFTP server JOBKA, ze kterého si je importuje systém JOBKA.
Ruční export dat
Pomocí funkce Vyhodnocení / Export dat / Export docházky do systému JOBKA lze získat datové soubory, které lze následně nahrát na SFTP server JOBKA, ze kterého si je importuje systém JOBKA.
Upozornění prostřednictvím aplikace JOBKA
Pro každého zaměstnance existuje v systému JOBKA unikátní e-mailová adresa. Všechny zprávy na tuto adresu doručené jsou předány jako upozornění do aplikace JOBKA v mobilním telefonu. Tohoto využívá systém DOSYS, který pomocí příkazu naplánované úlohy jobka:importEmails umí převzít e-mailové adresy z API JOBKA a uložit je do zaměstnance do pole E-mail pro upozornění.
Import žádostí o dovolenou
Systém DOSYS podporuje import žádostí o dovolenou ze systému JOBKA.
Import nových žádostí
Systém získává žádosti prostřednictvím API JOBKA. Systém JOBKA zajistí pouze přijetí žádosti, schvalování a odesílání upozornění zaměstnancům zajišťuje systém DOSYS. Informace o změně stavu žádosti jsou předávány zpět do aplikace JOBKA.
Import schválených žádostí
Toto řešení využívá existujícího systému schvalování v systému JOBKA. Schválené žádosti importuje nestandardně pomocí volání formuláře přímo z aplikace JOBKA (JOBKA aktuálně nepodporuje přístup k těmto žádostem pomocí API). Vyžaduje tedy nastavení přístupu k aplikaci JOBKA v konfiguračním souboru.
Jedná se o dočasné řešení a bude v dalších verzích aplikace odstraněno.