WebDAV

Jak to funguje?

WebDAV import umožňuje automatické stahování dokumentů ze vzdáleného WebDAV serveru do Alice. Systém periodicky kontroluje složku na WebDAV serveru, stahuje nové soubory a automaticky je nahrává do Alice jako dokumenty. Po zpracování jsou soubory přesunuty do příslušné složky podle výsledku.

Co je WebDAV?

WebDAV (Web Distributed Authoring and Versioning) je protokol, který umožňuje přístup k souborům přes HTTP/HTTPS spojení. Podporují ho například Nextcloud, ownCloud, Synology NAS, QNAP NAS a mnoho dalších úložných řešení.

Pracovní cyklus importu

graph TD
    A[Služba běží na pozadí] --> B{Čas kontroly?}
    B -->|Dle frekvence| C[Připojení k WebDAV serveru]
    C --> D[Kontrola složky pro přijaté soubory]
    D --> E{Nové soubory?}
    E -->|Ne| A
    E -->|Ano| F[Stažení souborů]
    F --> G[Nahrání do Alice jako dokument]
    G --> H{Úspěch?}
    H -->|Ano| I[Přesun do složky zpracovaných]
    H -->|Ne| J[Přesun do složky nezpracovaných]
    I --> K[Konec cyklu]
    J --> K
    K --> A

Frekvence kontroly

Můžete nastavit, jak často má Alice kontrolovat WebDAV server na nové soubory:

Frekvence	Popis
1 minuta	Kontrola každou minutu - vhodné pro urgentní dokumenty
5 minut	Kontrola každých 5 minut - standardní nastavení
15 minut	Kontrola každých 15 minut
60 minut	Kontrola každou hodinu - vhodné pro méně časté importy

Podporované typy souborů

WebDAV import podporuje všechny typy souborů, které Alice dokáže zpracovat:

Typ souboru	Přípony	Poznámka
PDF dokumenty	`.pdf`	Hlavní formát pro dokumenty
Obrázky	`.png`, `.jpg`, `.jpeg`, `.bmp`, `.tif`, `.tiff`, `.webm`, `.avif`	Naskenované dokumenty
ISDOC	`.isdoc`, `.isdocx`	Strukturovaný formát pro faktury
Strukturovaná data	`.xml`, `.json`	Datové soubory
Office dokumenty	`.doc`, `.docx`, `.xls`, `.xlsx`	Přílohy k dokumentům
Textové dokumenty	`.txt`, `.odt`	Textové soubory

Předpoklady

Před nastavením WebDAV importu se ujistěte, že:

Důležité požadavky

Máte přístup k WebDAV serveru s platným přihlašovacím jménem a heslem
Na WebDAV serveru jsou předem vytvořené 3 složky (Přijaté soubory, Zpracované soubory, Nezpracované soubory)
Alice má síťový přístup k WebDAV serveru (kontrola firewallu)
Máte administrátorská oprávnění v Alice pro nastavení importu

Nastavení

Import dokumentů z WebDAV serveru provedete následujícím způsobem:

Přidání WebDAV importu

Přejděte do sekce Nastavení > Import a klikněte na tlačítko
Vyberte WebDAV jako typ importu
Vyplňte formulář dle předlohy níže:

Konfigurace WebDAV

Popis polí

Základní nastavení

Název: Libovolný název pro toto WebDAV připojení (např. "Import z Nextcloud", "Firemní NAS")
Aktivní: Zapnutí/vypnutí importu. Pokud je vypnuto, Alice nebude kontrolovat WebDAV server.

Nahrávání do Alice

Frekvence kontroly: Jak často má Alice kontrolovat WebDAV server na nové soubory (1, 5, 15 nebo 60 minut)
Uživatelský účet: Uživatel v Alice, pod kterým budou dokumenty nahrávány. Tento uživatel bude vlastníkem všech importovaných dokumentů.
Účetní jednotka (volitelné): Pokud je vyplněno, všechny importované dokumenty budou automaticky přiřazeny k této účetní jednotce.

Server WebDAV

Adresa serveru

URL adresa WebDAV serveru (např. https://nextcloud.example.com/remote.php/dav/files/username/)

Formát adresy

Pro Nextcloud: https://[server]/remote.php/dav/files/[uzivatel]/
Pro ownCloud: https://[server]/remote.php/webdav/
Pro NAS: dle dokumentace vašeho zařízení

Uživatelské jméno

Přihlašovací jméno k WebDAV serveru

Heslo

Heslo k WebDAV serveru

Složky

Složky musí existovat

Všechny tři složky musí být vytvořeny předem na WebDAV serveru. Alice je nevytvoří automaticky.

Složka pro přijaté soubory: Název složky na WebDAV serveru, ve které Alice kontroluje nové dokumenty pro import (např. Alice/Prijate)
Složka pro zpracované soubory: Název složky, do které budou přesunuty úspěšně importované soubory (např. Alice/Zpracovane)
Složka pro nezpracované soubory: Název složky, do které budou přesunuty soubory, které se nepodařilo importovat (např. Alice/Nezpracovane)

Ověření funkčnosti

Po uložení nastavení můžete ověřit, že import funguje správně:

Zkopírujte testovací dokument (např. PDF fakturu) do složky pro přijaté soubory na WebDAV serveru
Počkejte podle nastavené frekvence kontroly (maximálně 1-60 minut)
Zkontrolujte, že:
- Dokument se objevil v Alice v seznamu dokumentů
- Soubor byl přesunut ze složky "Přijaté" do složky "Zpracované" na WebDAV serveru

Úspěšný import

Pokud byl dokument úspěšně importován, najdete ho v Alici a na WebDAV serveru bude přesunutý do složky pro zpracované soubory.

Importované dokumenty

Dokumenty importované přes WebDAV obsahují metadata o zdroji:

Zdroj importu: WebDAV
Jméno souboru: Původní název souboru z WebDAV serveru
Datum importu: Kdy byl dokument stažen a nahrán do Alice

Často kladené otázky (FAQ)

Jaké WebDAV servery jsou podporované?

Alice podporuje standardní WebDAV protokol, který implementují:

Nextcloud a ownCloud (oblíbená cloudová úložiště)
Synology NAS a QNAP NAS (síťová úložiště)
Windows Server (IIS s WebDAV)
Další systémy podporující WebDAV standard

Musím vytvářet složky ručně?

Ano. Na rozdíl od emailového importu, kde jsou složky vytvořeny automaticky, u WebDAV musíte všechny tři složky vytvořit předem na WebDAV serveru. Alice je nevytvoří automaticky.

Co se stane, když se import nezdaří?

Pokud se soubor nepodaří importovat do Alice (např. nepodporovaný formát, poškozený soubor):

Soubor je přesunut do složky pro nezpracované soubory
V Alice se dokument nevytvoří
Můžete problém vyřešit a zkusit soubor nahrát znovu ručně

Podporuje WebDAV import podsložky?

Ne. Alice kontroluje pouze soubory přímo ve složce pro přijaté soubory. Soubory v podsložkách nejsou zpracovávány.

Můžu mít více WebDAV připojení?

Ano. Můžete vytvořit více WebDAV importních připojení, například:

Různé WebDAV servery
Různé složky na stejném serveru
Různé účetní jednotky pro každé připojení

Jak dlouho trvá, než se dokument objeví v Alice?

Závisí na nastavené frekvenci kontroly:

1 minuta: dokument se objeví do 1 minuty
5 minut: dokument se objeví do 5 minut
15 minut: dokument se objeví do 15 minut
60 minut: dokument se objeví do 60 minut

Po stažení ze serveru trvá samotné zpracování a nahrání typicky jen několik sekund.

Co když zapomenu heslo k WebDAV?

Můžete kdykoli upravit nastavení připojení v Alice a změnit heslo. Import bude pozastaven, dokud neuvedete správné přihlašovací údaje.

Je WebDAV import bezpečný?

Ano, pokud:

Používáte HTTPS protokol (šifrované připojení)
Vytvoříte dedikovaný WebDAV účet s přístupem pouze k import složkám
Pravidelně měníte přístupové heslo
Kontrolujete složku pro nezpracované soubory

Lze přiřadit dokumenty k různým účetním jednotkám?

Můžete nastavit jednu výchozí účetní jednotku v nastavení WebDAV importu. Všechny dokumenty z tohoto zdroje budou přiřazeny k této jednotce.

Pokud potřebujete importovat do různých účetních jednotek, máte dvě možnosti:

Vytvořit více WebDAV připojení s různými nastavením účetní jednotky
Nechat pole účetní jednotka prázdné a nechat Alice rozpoznat jednotku automaticky po vytěžení dokumentu

Co když WebDAV server přestane být dostupný?

Pokud se Alice nemůže připojit k WebDAV serveru:

Import se automaticky přeskočí
Při dalším cyklu kontroly se Alice pokusí připojit znovu
Když se server stane opět dostupným, import automaticky pokračuje

Doporučujeme pravidelně kontrolovat stav importu v nastavení.

Jaká je maximální velikost souboru?

Maximální velikost souboru pro import závisí na nastavení vašeho WebDAV serveru a limitu Alice pro nahrávání dokumentů. Typicky:

WebDAV servery podporují soubory do několika GB
Alice má limit pro upload dokumentů (obvykle desítky MB pro jeden dokument)
Pro optimální výkon doporučujeme soubory do 50 MB