Downloader

Co integrace přidá

Integrace poskytuje akci downloader.download_file. Stahuje soubor z URL a uloží ho do předem zvoleného adresáře.

Pokud cílový adresář neexistuje nebo do něj proces nemůže zapisovat, integrace se nenastaví.

Příprava adresáře

Vytvořte adresář pro stažené soubory a ověřte práva zápisu. Relativní cesta se bere vůči konfiguračnímu adresáři, například downloads znamená složku uvnitř konfigurace.

Nestahujte neověřené soubory do adresářů, které používají jiné služby bez kontroly obsahu.

Nastavení v RichPear Home

Otevřete Nastavení, Zařízení a služby, Přidat integraci a vyhledejte Downloader. V průvodci zadejte umístění, kam se mají soubory ukládat.

Průvodce zkontroluje existenci adresáře. Pokud neprojde, vytvořte adresář nebo opravte práva.

Použití akce

Ve Vývojářských nástrojích, Akce vyberte downloader.download_file a zadejte data.

action: downloader.download_file
data:
  url: "https://example.com/report.pdf"
  subdir: "reporty"
  filename: "posledni-report.pdf"
  overwrite: true

Události stahování

Po úspěšném dokončení vzniká událost downloader_download_completed. Při chybě vzniká downloader_download_failed. Události obsahují URL a název souboru.

trigger:
  - platform: event
    event_type: downloader_download_failed
action:
  - action: persistent_notification.create
    data:
      title: "Stahování selhalo"
      message: "Soubor se nepodařilo stáhnout."

Provoz

Pravidelně hlídejte velikost adresáře se staženými soubory. Pokud automatizace stahuje opakovaně, nastavte podadresáře a jasné názvy souborů.

Řešení problémů

Nejčastější chybou je neexistující adresář, chybějící práva nebo nedostupná URL. U chráněných endpointů použijte podporované HTTP hlavičky v parametru headers.