Integrace RichPear Home

Scrape

Scrape načítá hodnoty z webové stránky a převádí je na senzory. Hodí se pro jednoduché veřejné hodnoty, které nejsou dostupné přes oficiální API.

Začít nastavení Zpět na integrace

Doména: scrape
Kategorie: Senzory
Komunikace: lokální i cloudová komunikace
Nastavení: průvodce integrací

Co návod pokrývá

Návod popisuje praktické zapojení integrace Scrape 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 průvodce integrací
kontrola entit: senzory
bezpečné použití v automatizacích
řešení běžných provozních potíží

Příprava

Vyberte stabilní stránku a ověřte, že její obsah smíte používat. Připravte selektor, šablonu a interval dotazování tak, aby zbytečně nezatěžoval cílový web.

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

Integraci nastavte ručně nebo přes podporovaný průvodce podle konkrétního použití. Po uložení ověřte, že senzor získává správnou část stránky a že se hodnota převádí na očekávaný formát.

Tahle integrace se v běžném provozu přidává přes průvodce v části Nastavení, Zařízení a služby.

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

Scrape může vytáhnout text z HTML a použít šablony pro úpravu hodnoty. Nejlepší je držet senzor jednoduchý a nepokoušet se parsovat složité aplikace s dynamickým obsahem.

Podle typu integrace očekávejte hlavně tyto entity nebo funkce: senzory. 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

Nastavte rozumný interval aktualizace a počítejte s tím, že změna webu může senzor rozbít. Důležité automatizace doplňte podmínkou dostupnosti a záložní hodnotou.

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íží

Když senzor přestane fungovat, zkontrolujte HTML stránky, selektor a případné blokování požadavků. Pokud stránka vyžaduje JavaScript, jednoduché načtení nemusí stačit.

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 Scrape 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.