Stavební entita

Calendar

Calendar poskytuje kalendářové entity pro jiné integrace. Kalendáře se zobrazují v kalendářovém panelu a slouží hlavně pro automatizace podle začátku nebo konce události.

Použít v automatizaci Zpět na integrace

Doména: calendar
Typ: stavební entita
Nastavení: přes kalendářovou integraci
Čtení dat: typicky v intervalu kolem 15 minut

Kalendář doplňuje externí službu

Kalendářovou entitu nepřidáváte samostatně. Vytvoří ji integrace, která umí připojit kalendářovou službu nebo lokální kalendář.

RichPear Home není plnohodnotná náhrada osobního kalendáře. Kalendářové entity slouží pro přehled událostí, jednoduché úpravy tam, kde je zdrojová integrace podporuje, a hlavně pro automatizace.

Možné zdroje

Externí kalendář připojený přes podporovanou integraci.
Vlastní kalendářová platforma dostupná přes CalDAV.
Jednoduchý lokální kalendář určený pro automatizace.

Zobrazení a správa událostí

Kalendáře najdete v kalendářovém panelu v postranním menu RichPear Home. Pokud konkrétní integrace podporuje zápis, lze v panelu přidávat nové události.

Na dashboard lze přidat kalendářovou kartu, která ukazuje nadcházející události z jednoho nebo více kalendářů.

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

Stav kalendářové entity

Stav on znamená, že kalendář má právě aktivní událost. Stav off znamená, že aktivní událost není.

Stav může být také unavailable, když entita není dostupná, nebo unknown, když stav ještě není známý. Atributy entity obvykle popisují jen jednu nejbližší nebo aktivní událost.

Používejte trigger události

Pro automatizace používejte kalendářový trigger na začátek nebo konec události. Lze přidat offset, například spuštění 15 minut před začátkem.

triggers:
  - trigger: calendar
    event: start
    entity_id: calendar.osobni
    offset: -00:15:00

Pokud mohou začít dvě události současně, nepoužívejte režim automatizace single. Vhodnější je režim, který dovolí více běhů, například frontu nebo paralelní zpracování.

Při testování neplánujte události méně než 15 minut od aktuálního času. Kalendáře se načítají v intervalu a příliš blízká událost se nemusí stihnout propsat.

Akce a podmínky

Akce calendar.create_event vytvoří novou událost v kalendáři, pokud to zdrojová integrace podporuje. Akce calendar.get_events načte události z kalendáře ve zvoleném časovém rozsahu.

Podmínka calendar.is_event_active ověří, zda má jeden nebo více kalendářů aktivní událost.

Pro zápis a mazání událostí vždy nejdřív ověřte, že konkrétní kalendářová integrace tyto operace podporuje.

Provozní doporučení

Pro automatizace používejte samostatný kalendář nebo stabilní názvy událostí. Osobní kalendář s volným textem může po běžné úpravě názvu nebo popisu změnit chování automatizace.

U scén, které mají platit jen v určitém čase, nastavte také chování při přesunutí nebo smazání události. Domácnost nemá zůstat v režimu, který měl platit jen pro původní termín.