Kalendáře a úkoly

CalDAV

CalDAV připojí WebDAV kalendář do RichPear Home jako kalendářové entity a podle podporované služby také jako seznam úkolů.

Přidat CalDAV Zpět na integrace

Doména: caldav
Entity: kalendář, úkoly
Obnova dat: zhruba každých 15 minut
Přístup: URL serveru a přihlašovací údaje

Ukázka v RichPear Home

Screenshoty ukazují české rozhraní RichPear Home při vyhledání integrace a při prvním bezpečném kroku nastavení.

Vyhledání CalDAV v RichPear Home — Vyhledání CalDAV v katalogu integrací.

Nastavení CalDAV v RichPear Home — Formulář pro URL serveru a přihlašovací údaje CalDAV.

Co integrace přidá

Kalendářová entita umožní spouštět automatizace podle začátku nebo konce události. Seznam úkolů ukazuje počet aktivních nedokončených položek.

Integrace je určená pro služby kompatibilní s CalDAV. Ověřený typ nasazení zahrnuje Baikal, iCloud Calendar, Nextcloud, OwnCloud a Synology Calendar; fungovat mohou i jiné služby dodržující CalDAV.

Co si připravit

CalDAV URL serveru, například https://caldav.icloud.com/.
Uživatelské jméno, pokud ho server vyžaduje.
Heslo nebo aplikační heslo podle poskytovatele.
U soukromých serverů platný certifikát nebo vědomé rozhodnutí, jak řešit ověření SSL.

Příprava před přidáním

RichPear Home otevřete na http://rphome.local:8123. Pokud adresa v síti neodpoví, použijte http://IP-ADRESA:8123.

U iCloud účtu použijte aplikační heslo, pokud ho účet pro připojení externí aplikace vyžaduje. Nepoužívejte cizí účty ani veřejně sdílené přístupové údaje.

Neexistuje univerzální veřejný testovací účet pro běžné CalDAV služby. Pro ověření používejte vlastní účet nebo vlastní testovací server.

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte CalDAV a pokračujte podle průvodce.

Průvodce se ptá na URL CalDAV serveru a přihlašovací údaje. Po dokončení otevřete detail integrace a zkontrolujte vytvořené kalendáře a případné seznamy úkolů.

První načtení dat nemusí být okamžité. WebDAV entity se obnovují přibližně každých 15 minut.

Ruční konfigurace

Pokud vaše instalace používá ruční konfiguraci, lze CalDAV přidat do konfiguračního souboru. Tato varianta nepodporuje seznamy úkolů.

calendar:
  - platform: caldav
    username: uzivatel
    password: !secret caldav
    url: https://nextcloud.example.com/remote.php/dav

Volbou calendars lze omezit načítané kalendáře. Volba custom_calendars vytvoří kalendáře podle regulárního výrazu v názvu, popisu nebo místě události; nelze ji kombinovat s calendars.

U ruční konfigurace nejsou celodenní události ve výchozím stavu podporované. U vlastních kalendářů vytvořených přes custom_calendars se celodenní události zohledňují.

Použití v automatizacích

Kalendářové události používejte hlavně přes trigger na začátek nebo konec události. Podmínky a akce mohou pracovat s údaji z události, například názvem, popisem, místem a časy.

Atributy kalendářové entity popisují jen jednu nejbližší nebo aktivní událost. Pro spolehlivý provoz automatizací je vhodnější trigger události než čtení samotného stavu entity.

Příklady použití

Rozsvícení světla na začátku události s konkrétním názvem.
Odeslání oznámení několik minut před začátkem události.
Zastavení přehrávače po konci události.

Řešení problémů

Pokud se kalendáře nenačtou, ověřte URL serveru, uživatelské jméno, heslo, dostupnost serveru, certifikát a případné požadavky poskytovatele na aplikační heslo.

U automatizací netestujte události založené méně než 15 minut před plánovaným časem. Data se načítají v intervalu a příliš blízká testovací událost se nemusí stihnout propsat.

Chyby hledejte v Nastavení → Systém → Logy podle domény caldav.