Integrace

  • API dokumentace

    Aplikace Sloneek má svou API dokumentaci (specifikaci). Pokud budete potřebovat bližší informace, kontaktujte nás.

  • Synchronizace s Outlookem
    Kalendářové události Absencí ve Slonekovi propojíte se svým Microsoft účtem.

     

     Pod vaším Avatarem klikněte na Profil a vyberte záložku Nastavení rozhraní. Přihlaste se ke svému účtu.

    Snímek obrazovky 2024-05-03 v 7.26.50


     Povolte možnost zápisu do Outlook kalendáře. Pak už stačí jen vybrat kalendáře, které chcete synchronizovat.

    Snímek obrazovky 2023-10-29 v 10.01.22

     

    Propíší se jen ty události, které se do aplikace zapíší PO propojení Microsoft a Sloneeka.

    Do kalendářů se propíší jen SCHVÁLENÉ události.

    Přihlašovací email do Sloneeka a Microsoft účtu se musí shodovat.

    Pozor také na to, že do Outlook kalendáře se propisují pouze události absence, nikoliv aktivity (tedy např. služební cesty nebo homeoffice).

     
  • Integrace s aplikací Slack

    Sloneek má se Slackem k dispozici 3 druhy integrací:

     

    Denní souhrny absencí

    Do aplikace Slack můžete přenášet denní souhrn absencí v celé firmě.

    digit-one_31-fe0f-png-3 Vyberte kanál, do kterého chcete souhrn absencí zasílat. Klikněte pravým tlačítkem myši a otevřete detail kanálu. Na záložce Integrations klikněte na položku Ad an App.
    Slack_channel

    Slack_channel_detail

    digit-two_32-fe0f-png-3 Nainstalujete do Slacku Incoming Webhooks. Pokud již nainstalováno máte, rovnou můžete kliknout na "View"
    Instalace WebHook

    digit-three_33-fe0f-png-1 Pro instalaci musíte mít ve Slacku oprávnění Admin.  

    Add-to-slack

    V nastavení Web Hooku vyberete kanál, do kterého budete report absencí zasílat, a kliknete na "Add Incoming WebHooks integration"
    Připojení WebHooku

    digit-four_34-fe0f-png Z návazné obrazovky zkopírujte URL
    Kopírování URL

    5 Vložte do Sloneeka do Slack integrace v Reporty a nastavení / Integrace / Slack. Vyberte dny ve kterých se budou odesílat zprávy ze Sloneeka do Slacku. Uložte.

    723DE104-D120-48B1-B4F7-96B9CC6B3CA3_1_201_a


    Individuální reporty a schvalování absencí

    Pro integraci musíte mít ADMIN oprávnění jak pro SLACK Workspace, tak pro Sloneeka.

    Integraci mohou využívat všichni bez rozdílu rolí.

    E-mail, který se hlásíte do Slack, musí být totožný s emailem do Sloneeka! Tento požadavek je platný jak pro integraci, tak pro její využívání všemi uživateli!

     

    Postup integrace

    digit-one_31-fe0f-png-3 Pro integraci přidejte ve Slacku jako aplikaci Sloneek. Integraci provedete v Jiné / Integrace / Slack.

    Snímek obrazovky 2023-10-29 v 9.15.09

    Pohled po instalaci

    Slack_instalace_CZ 2 2

    Otevřete aplikaci Slack. Přidejte aplikaci Sloneek do firemního workspace.

    Slack_instalace_integrace_cz

    digit-two_32-fe0f-png-3 Všem uživatelům se pak ve vašem firemním kanálu ukáže ikona Sloneeka.

    Slack_integrace

    Individuální reporty, jak je získat

    right-from-bracket-solid Do příkazového řádku vpisujete pokyny pro výpisy ve formátu:

     /sloneek-[attendance | timetracking | vacations]-[month | week | day]-[monthNumber]

    • month - číslo měsíce (index)
    • week - pouze aktuální týden
      • kontrola aktuálního týdne při spuštění příkazu a odeslání hlášení (příklady)
          • Pokud jsem na začátku týdne (pondělí), započítá se pouze pondělí
          • Pokud jsem uprostřed týdne (středa), do výpočtů se zahrne (pondělí, úterý, středa).
          • Pokud jsem na konci týdne, bude zahrnut celý týden.
    • day - získáte zprávu pro dnešek

    Příklad: 

    /sloneek-absence-month 3 - provede výpis absence za třetí měsíc aktuálního roku.

    /sloneek-timetracking-week  - provede výpis aktivit time trackingu podle klíče výše

    /sloneek-attendance-day  - provede výpis docházky za dnešní den

     

    Schvalování absencí

    Do Sloneek kanálu přijdou všechny události Absencí a Aktivit, které má daný Týmový manažer / Administrátor / Vlastník účtu určeny ke schválení.

    Slack_approvals

     

    Spuštění a zastavení Time trackingu

    right-from-bracket-solid Do příkazového řádku vpisujete pokyn pro spuštění time trackingu ve formátu:

     /sloneek-timetracking-start

    slack-tt-startright-from-bracket-solid Pro zastavení time trackingu vpisujete do příkazového řádku pokyn ve formátu:

     /sloneek-timetracking-stop

    slack-tt-stop

     

  • Integrace s JIRA

    Sloneek je s aplikací JIRA integrován pro přenos aktivit pomocí timetrackingu.

     

    Propojení s účtem JIRA

    Rozsah integrace


    Propojení s účtem JIRA

    V sekci Můj profil přejděte do záložky Oznámení a Integrace. Poté klikněte na tlačítko Připojte svůj účet Jira.

    Snímek obrazovky 2024-01-24 v 8.29.44

    POZOR: E-maily používané pro přihlášení do Sloneeka a JIRA musí být totožné. 

    JIRA účet můžete připojit také přímo z okna při trackování nové aktivity ve Sloneekovi:

    Snímek obrazovky 2023-02-17 v 17.16.05


    Rozsah integrace

    right-from-bracket-solid Při zakládání time trackingu aktivity vybíráte přímo z úkolů ve vašem JIRA účtu. Po založení aktivity můžete přímo z jejího detailu prokliknout na úkol ve vašem JIRA účtu.

    Muj-film-8

     

    right-from-bracket-solid  Při schvalování aktivit má manažer možnost přímo ze Sloneeka nahlédnout do konkrétního úkolu v JIRA.

    C09C24D7-FED7-4D11-8310-F0F716118A22_1_201_a

     

    right-from-bracket-solid  Schválená aktivita time trackingu se automaticky propíše do Work logu úkolu v JIRA.

    JIRA-work-log

    Pokud schválenou aktivitu ve Sloneekovi smažete, smaže se i v úkolu v JIRA.

     

    right-from-bracket-solid  Report událostí aktivit obsahuje proklik přímo do úkolu v JIRA.

    35C3B0F3-FB14-4EC4-A757-B48F226D9CCE_1_201_a

     

  • Integrace se systémem Ice Warp

    Pokud využíváte systém Ice WARP, máte možnost přenášet události absencí ze Sloneeka do kalendářů Ice Warp.

    Požádejte na podpoře o individuální úpravu nastavení svého účtu. V rámci této úpravy obdržíte URL adresu (vzor: vasefirma.icewarp.cz) a tu pak vložíte do Sloneeka v záložce Nastavení / Ostatní / Integrace.

    Snímek obrazovky 2023-10-29 v 9.15.16

     

  • Synchronizace s Google kalendářem

    Kalendářové události Absencí ve Slonekovi propojíte se svým Google účtem tak, že:

     

     v menu kliknete na kliknete na MŮJ PROFIL a vyberte záložku Nastavení rozhraní. Přihlaste se ke svému účtu.

    Snímek obrazovky 2024-05-03 v 7.25.07

     

     povolte možnost zápisu do Google kalendáře. Pak už stačí jen vybrat kalendáře, které chcete synchronizovat.

    FC34235A-D207-4CBA-AC79-575AD41CC8A3_1_201_a

     

    Propíší se jen ty absence, které se do aplikace zapíší PO propojení Google a Sloneeka.

    Do kalendářů se propíší jen SCHVÁLENÉ události absence.

    Přihlašovací e-mail do Sloneeka a Google účtu se musí shodovat.

    POZOR! Pokud má uživatel pro sdílený firemní kalendář v nastavení firemního Google účtu nastavená práva "READ ONLY", nedojde k propsání událostí ze Sloneeka do Google kalendáře. 

    Pozor také na to, že do Google kalendáře se propisují pouze události absence, nikoliv aktivity (tedy např. služební cesty nebo homeoffice).

     

  • MFA (Víceúrovňové ověřování)

    MFA přidává k uživatelským účtům další úroveň zabezpečení tím, že vyžaduje více forem identifikace.

    💎 Služba MFA je dostupná pouze pro balíček Enterprise.

    Nastavení MFA

    Majitel účtu společnosti (nikoliv standardní administrátor) může nastavení MFA provést ze sekce Integrace / Přihlášení.

    Zvolit lze mezi dvěma možnostmi:

    1. dobrovolným MFA, kdy si všichni uživatelé mohou vybrat, zda chtějí víceúrovňové ověřování při přihlášení používat
    2. povinným MFA, kdy všichni uživatelé při přihlášení do účtu musí víceúrovňové ověřování používat

    Snímek obrazovky 2023-10-29 v 9.13.23

    Postup při přihlášení

    Samotné MFA pak ve Sloneekovi zahrnuje dva faktory:

    1. Věc, kterou uživatel dobře zná (heslo do aplikace)
    2. Prostředek ověření (telefon pro zaslání ověřovací SMS)

    Ve chvíli, kdy se tedy uživatel s aktivovaným MFA bude poprvé přihlašovat do aplikace (od momentu aktivace MFA), zadá své telefonní číslo, na které mu má přijít ověřovací SMS:

    Snímek obrazovky 2023-10-21 v 10.52.08

    Kód následně jednoduše zadá do připravené kolonky a bezpečně se přihlásí do aplikace:

    Snímek obrazovky 2023-10-21 v 10.52.45

    Při příštím přihlášení již není třeba znovu zadávat své telefonní číslo. Kód uživateli automaticky přijde na jeho telefonní číslo.

    Reset MFA

    Pokud je to zapotřebí, majitel účtu může kdykoliv resetovat MFA pro:

    • daného uživatele (v jeho kartě v záložce Oznámení a integrace / MFA)
    • všechny uživatele hromadně (v sekci Nastavení / Integrace / Přihlášení po kliknutí na tlačítko Reset)

    Bezpečnostní opatření

    Každý uživatel má 5 přihlašovacích pokusů na správné zadání kódu z SMS. Po překročení limitu se jeho účet uzamkne. Obnova probíhá tak, že majitel účtu může uživateli resetovat MFA a tím mu umožnit se znovu přihlásit.

    Funkce MFA je dostupná také pro přihlašování z mobilní appky. Administrátoři účtu zároveň nevidí zadaná telefonní čísla, na které si uživatelé nechávají zaslat kódy.

     

  • Integrace s OKTA

    Využívejte svůj Okta účet k přihlašování do Sloneeka

    Pokud vaše firma využívá systém OKTA, můžete pro přihlášení do Sloneeka využít SSO (Single Sign On) přihlašovací údaje z tohoto systému.

    Octa_CZ

    Nastavení integrace provedete v Reporty a nastavení / Integrace

    Pokud chcete, aby přihlašování přes OKTA bylo jedinou možností pro přihlášení, musí být ostatní způsoby přihlášení vypnuté. 
    off

    Integrace CZ

     

  • Synchronizace uživatelů s Google Workspace
    V případě, že využíváte firemní Google účet můžete zautomatizovat import uživatelů a zároveň udržovat uživatelskou databázi automatizovaně stále aktivní.

     

    CO BUDETE POTŘEBOVAT:

    👉  musíte mít ADMIN oprávnění k vašemu firemnímu Google Workspace účtu

    👉  musíte mít ADMIN oprávnění k firemnímu účtu ve Sloneekovi

     

    Postup propojení

     v Uživatelé / Seznam a správa propojte přihlášením Google Workspace účet

    Snímek obrazovky 2023-10-29 v 9.21.06

     přidělte Sloneekovi oprávnění pro sdílení dat

    v části Integrace nastavte pravidla synchronizace a aktivace/deaktivace a rozsah povolení této integrace.

     

    Pokud události (také) přenášíte do sdíleného firemního kalendáře, ujistěte se, že každý uživatel má v nastavení Google účtu POVOLEN ZÁPIS DO TOHOTO KALENDÁŘE. využít můžete návodu ZDE.

    Propojení uživatelských Google kalendářů si každý uživatel provede podle návodu zde.

     
  • Synchronizace s Microsoft Active Directory
    Pokud používáte firemní účet Microsoft, můžete import uživatelů automatizovat a zároveň udržovat databázi uživatelů vždy aktuální.

     

    CO BUDETE POTŘEBOVAT:

    👉 musíte mít na svém firemním účtu Microsoft oprávnění ADMIN.

    👉 musíte mít na svém firemním účtu Sloneek oprávnění ADMIN.

     

    Proces připojení

    digit-one_31-fe0f-png-2 v části Integrace nastavte pravidla synchronizace a aktivace/deaktivace a rozsah povolení této integrace.

    Ve službě Microsoft Active Directory můžete své zaměstnance rozdělit do několika skupin. V aplikaci Sloneek pak nastavíte, které z těchto skupin chcete synchronizovat.

    digit-two_32-fe0f-png-3 v části Uživatelé / Přehled a správa propojte účet Microsoft přihlášením a proveďte import pro vybrané skupiny uživatelů. Můžete také nastavit, zda chcete všechny uživatele přímo aktivovat, nebo ne.

    Snímek obrazovky 2023-10-29 v 9.18.23

    digit-three_33-fe0f-png-2 udělte společnosti Sloneek oprávnění ke sdílení dat.

    Každý uživatel připojí své kalendáře Microsoft podle pokynů zde.