Integrace RichPear Home

Šablona RSS feedu

Šablona RSS feedu umožňuje vystavit vybraná data z RichPear Home jako RSS. Hodí se pro interní přehledy, stavové výpisy nebo jednoduchý odběr událostí v jiných nástrojích.

Začít nastavení Zpět na integrace

Doména: rss_feed_template
Kategorie: Rozhraní
Komunikace: lokální i cloudová komunikace
Nastavení: ruční konfigurace

Co návod pokrývá

Návod popisuje praktické zapojení integrace Šablona RSS feedu v RichPear Home. Zaměřuje se na to, co je potřeba připravit, jak zkontrolovat vytvořené entity a jak integraci používat bez zbytečného rizika.

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

Hlavní body

příprava zařízení, účtu nebo lokální služby
nastavení přes ruční konfigurace
kontrola entit: entity podle konkrétního nastavení integrace
bezpečné použití v automatizacích
řešení běžných provozních potíží

Příprava

Rozmyslete si, jaká data mají být ve feedu veřejná nebo interní. Do šablony nedávejte tokeny, osobní údaje, přesnou polohu ani citlivé stavy domácnosti.

Před přidáním integrace si připravte názvy místností, zařízení a účel použití. Pokud jde o zařízení, které něco fyzicky ovládá, nejdřív ověřte ruční ovládání mimo automatizace.

Lokální adresa systému

Při práci v místní síti používejte http://rphome.local:8123. Pokud se lokální jméno nepřeloží, otevřete systém přes http://IP-ADRESA:8123.

Nastavení v RichPear Home

Integrace se nastavuje ručně pomocí šablony. Po uložení konfigurace otevřete výslednou URL a ověřte, že RSS validně obsahuje položky, nadpisy a datumy.

Tahle integrace vyžaduje ruční konfiguraci. Po úpravě konfigurace vždy proveďte kontrolu nastavení a až potom restart nebo znovunačtení příslušné části systému.

Integrace obsahuje také volby. Po prvním přidání proto otevřete detail integrace a projděte dostupné možnosti, zejména intervaly, režimy a povolené entity.

Po změně nastavení ověřte stav v detailu integrace i na konkrétní entitě. Automatizaci zapojte až ve chvíli, kdy se hodnota nebo ovládání chová opakovaně stejně.

Entity a funkce

Šablona může sestavit položky z entit a jejich atributů. Držte výstup stručný, stabilní a čitelný pro RSS klienty.

Podle typu integrace očekávejte hlavně tyto entity nebo funkce: entity podle konkrétního nastavení integrace. Skutečný seznam závisí na modelu zařízení, oprávnění účtu a dostupnosti služby.

Každou důležitou entitu pojmenujte podle skutečné místnosti nebo účelu. Pomůže to při pozdějším ladění automatizací i při běžném používání dashboardu.

Provoz a automatizace

Feed používejte spíš pro čtení stavů než pro řízení domácnosti. Pokud je feed dostupný mimo místní síť, chraňte ho reverzní proxy nebo jiným řízením přístupu.

Hodnoty sledujte alespoň jeden běžný provozní cyklus, aby bylo jasné, jak rychle se mění a kdy mohou být dočasně nedostupné.

U akcí, které ovlivňují zařízení, nejdřív proveďte ruční test. Do automatizace přidejte podmínku dostupnosti entity a rozumnou prodlevu, aby krátký výpadek nezpůsobil chybnou reakci.

Řešení potíží

Při chybě výstupu nejdřív zjednodušte šablonu a ověřte jednotlivé entity. Neplatné znaky nebo prázdná data mohou způsobit, že RSS klient položky nenačte.

Při potížích postupujte od nejjednodušší kontroly: zařízení nebo služba, síť, přístupové údaje, potom až automatizace.

Pokud integrace používá účet nebo vzdálenou službu, ověřte také stav účtu a limity služby. Pokud používá lokální komunikaci, začněte IP adresou, portem, dosahem a firewallem.

Kontrola po nasazení

Po nastavení integrace Šablona RSS feedu sledujte alespoň jeden běžný provozní cyklus. U cloudových služeb počítejte se zpožděním, u lokálních zařízení ověřte chování po restartu routeru, zařízení i RichPear Home.

Do automatizací vkládejte jen hodnoty, které jste viděli v reálném provozu. Důležité akce doplňte podmínkou dostupnosti entity, režimem domácnosti a ruční možností zásahu.

Před předáním běžným uživatelům ověřte názvy entit, práva uživatelů a chování při nedostupnosti služby. U zařízení, která něco fyzicky spínají nebo řídí, ponechte dostupné i ruční ovládání mimo RichPear Home.

Hotový provozní test

Integrace je připravená pro běžné použití, když se entity aktualizují, názvy odpovídají skutečným zařízením a automatizace mají ošetřený výpadek nebo nedostupný stav.