Skip to main content

Příkazová Řádka

Shrnutí​

Tato stránka popisuje dostupné funkce a možnosti příkazové řádky, které lze spouštět z konzole. Bez potřeby grafického rozhraní lze tedy automatizovat některé úkoly.
Tyto příkazy aktuálně fungují pouze pod Linuxem.

Syntaxe​

./Katalog.sh [AKCE] [MOŽNOSTI] [ARGUMENTY]

Akce​

Následující akce jsou dostupné jako poziční argumenty:

list_catalogs​

Vypíše všechny katalogy s jejich ID, aktivním stavem a názvem.

Použití:

./Katalog.sh list_catalogs [MOŽNOSTI]

Příklad:

./Katalog.sh list_catalogs --verbose

update_catalog​

Aktualizuje konkrétní katalog podle ID zařízení.

Použití:

./Katalog.sh update_catalog <deviceID> [MOŽNOSTI]

Argumenty:

  • deviceID - ID zařízení katalogu k aktualizaci

Příklad:

./Katalog.sh update_catalog 5 --report

update_all_active​

Aktualizuje všechny aktivní katalogy v kolekci.

Použití:

./Katalog.sh update_all_active [MOŽNOSTI]

Příklad:

./Katalog.sh update_all_active --report --verbose

Provede vyhledávání pomocí posledních kritérií vyhledávání z historie, s volitelnými přepsáními.

Použití:

./Katalog.sh search [MOŽNOSTI]

Příklad:

./Katalog.sh search --text "dovolená" --type image --limit 100

restart​

Restartuje aplikaci (používá se interně pro správu životního cyklu aplikace).

Použití:

./Katalog.sh restart

Obecné Možnosti​

-h, --help​

Zobrazí informace o nápovědě a ukončí program.

-v, --version​

Zobrazí informace o verzi a ukončí program.

-c, --collection <cesta>​

Určuje cestu ke složce kolekce.

Příklad:

./Katalog.sh search --collection "/cesta/k/mé/kolekci"

-r, --report​

Zobrazí podrobný report pro operace aktualizace v grafickém okně (obvyklé dialogové okno v rozhraní).

Příklad:

./Katalog.sh update_catalog 3 --report

./Katalog update_catalog 4 --report

Toto zobrazí:

--verbose​

Povolí podrobný výstup pro ladění a detailní informace.

Příklad:

./Katalog.sh list_catalogs --verbose

Možnosti Vyhledávání​

Tyto možnosti jsou dostupné při použití akce search pro přepsání kritérií vyhledávání:

--limit <číslo>​

Omezí počet souborů k zobrazení ve výsledcích vyhledávání.

Příklad:

./Katalog.sh search --limit 50

--selectedDeviceID <deviceID>​

Určuje ID zařízení, ve kterém se má vyhledávat.

  • Výchozí: používá hodnotu ze souboru nastavení
  • Při použití s --collection: výchozí je 0 (Všechna zařízení)

Příklad:

./Katalog.sh search --selectedDeviceID 2

--text <hledaný-výraz>​

Určuje text nebo frázi k vyhledání.

Příklad:

./Katalog.sh search --text "rodinné fotky"

--type <typ-souboru>​

Filtruje výsledky podle typu souboru.

Platné hodnoty:

  • all (výchozí)
  • audio
  • image
  • text
  • video

Příklad:

./Katalog.sh search --type audio

--size-min <velikost>​

Nastaví filtr minimální velikosti souboru.

Formát: Číslo následované jednotkou (např. 1MB, 5GB)

Příklad:

./Katalog.sh search --size-min 1MB

--size-max <velikost>​

Nastaví filtr maximální velikosti souboru.

Formát: Číslo následované jednotkou (např. 100MB, 2GB)

Příklad:

./Katalog.sh search --size-max 100MB

--date-after <datum>​

Filtruje soubory upravené po zadaném datu.

Formát: YYYY-MM-DD

Příklad:

./Katalog.sh search --date-after 2023-01-01

--date-before <datum>​

Filtruje soubory upravené před zadaným datem.

Formát: YYYY-MM-DD

Příklad:

./Katalog.sh search --date-before 2023-12-31

--case-sensitive​

Povolí vyhledávání textu citlivé na velikost písmen.

Příklad:

./Katalog.sh search --text "MůjSoubor" --case-sensitive

--search-in <rozsah>​

Definuje rozsah vyhledávání pro shodu textu.

Platné hodnoty:

  • filenames (výchozí)
  • files-and-folders
  • folder-paths

Příklad:

./Katalog.sh search --text "dokumenty" --search-in folder-paths

--text-criteria <kritéria>​

Určuje, jak má být vyhledáván text.

Platné hodnoty:

  • all-words (výchozí)
  • exact-phrase
  • begins-with
  • any-word

Příklad:

./Katalog.sh search --text "dovolená fotka" --text-criteria exact-phrase

--exclude <výrazy-k-vyloučení>​

Vyloučí soubory obsahující zadané výrazy.

Příklad:

./Katalog.sh search --text "fotka" --exclude "záloha temp"

--no-history​

Začne s výchozími kritérii vyhledávání místo načítání z historie vyhledávání.

Příklad:

./Katalog.sh search --no-history --text "novýsoubor"

Možnosti Exportu CSV​

--csv​

Exportuje výsledky vyhledávání do CSV souboru. Soubor je uložen ve složce kolekce s časovým razítkem.

Příklad:

./Katalog.sh search --text "dokumenty" --csv

Návratové Kódy​

  • 0: Úspěch
  • 1: Chyba nebo selhání
  • -1: Interní kód pro pokračování v GUI režimu (nevrací se uživateli)

Příklady​

Základní Správa Katalogů​

Vypsat všechny katalogy:

./Katalog.sh list_catalogs

Aktualizovat konkrétní katalog s podrobným reportem:

./Katalog.sh update_catalog 3 --report --verbose

Aktualizovat všechny aktivní katalogy:

./Katalog.sh update_all_active --report

Příklady Vyhledávání​

Jednoduché textové vyhledávání:

./Katalog.sh search --text "dovolená"

Vyhledat obrázky větší než 5MB:

./Katalog.sh search --type image --size-min 5MB

Vyhledat soubory upravené v roce 2023:

./Katalog.sh search --date-after 2023-01-01 --date-before 2023-12-31

Složité vyhledávání s více kritérii:

./Katalog.sh search --text "projekt" --type text --search-in files-and-folders --case-sensitive --limit 200

Vyhledat v konkrétním zařízení a exportovat do CSV:

./Katalog.sh search --selectedDeviceID 2 --text "dokumenty" --csv --verbose

Použití Vlastní Cesty Kolekce​

Vyhledat v jiné kolekci:

./Katalog.sh --collection "/cesta/ke/kolekci" search --text "fotky"

Aktualizovat katalogy v konkrétní kolekci:

./Katalog.sh --collection "/cesta/ke/kolekci" update_all_active --report

Poznámky​

  • Když není zadána žádná akce, Katalog se spustí v GUI režimu
  • Kritéria vyhledávání jsou ve výchozím nastavení načtena z historie vyhledávání, pokud není použito --no-history
  • Možnosti příkazové řádky přepisují hodnoty z historie vyhledávání
  • Akce restart se používá především interně pro správu životního cyklu aplikace
  • Všechny operace vyhledávání respektují aktivní stav katalogů
  • Podporované jednotky velikosti souborů: KB, MB, GB, TB (necitlivé na velikost písmen)
  • Formáty data musí být ve formátu YYYY-MM-DD
  • CSV exporty jsou automaticky opatřeny časovým razítkem a uloženy ve složce kolekce

Řešení Problémů​

Neplatné ID zařízení: Ujistěte se, že ID zařízení existuje spuštěním ./Katalog.sh list_catalogs nejprve.

Problémy s připojením k databázi: Ověřte, že cesta kolekce je správná a přístupná.

Vyhledávání nevrací žádné výsledky: Zkuste použít --no-history pro začátek s výchozími kritérii, nebo zkontrolujte, zda vybrané zařízení obsahuje indexované soubory.

Chyby oprávnění: Ujistěte se, že Katalog má přístup pro čtení/zápis ke složce kolekce a souborům databáze.