Skip to main content

Požadavek file-system

Slouží k provádění filesystémových operací.

  <request>
   <file-system
    transactional="none|single|all|complex"
    >
    <list ... /> ?
    <delete ... /> ?
    <copy ... /> ?
    <move ... /> ?
    <mkdir ... /> ?
    <rename ... always|skip-existing|older|newer|fail</rename> ?
   </file-system>
  </request>

Atributy​

  • transactional - způsob transakčního chování, výchozí hodnotou je none(typ: string) TYP HODNOTY: string; Možnosti obsahu: » none ~ operace jsou plně netransakční » single ~ každá jednotlivá operace probíhá transakčně - např. v případě selhání jednotlivého požadavku se v jeho rámci neprovede žádná operace » all ~ celá skupina file=system požadavků je chápána jako jedna transakce např. pokud se napřed mazalo a nasledně kopírovalo, tak pokud selže kopírování, odvolá se i předchozí výmaz » complex ~ transakce je součástí celého transakčního požadavku, více informací v samostatné kapitole o transakcích

Potomci​

Odpověď​

Struktura odpovědi na požadavek file-system vrácená v obálce response:

  <response>
   <list
    status="{string}"
    detail="{string}"
    />
  </response>

Atributy​

  • status - popis neuveden(typ: string) TYP HODNOTY: string;

  • detail - popis neuveden(typ: string) TYP HODNOTY: string;

Potomci​

Odpověď list neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Struktura odpovědi na požadavek file-system vrácená v obálce response:

  <response>
   <delete
    status="{string}"
    detail="{string}"
    />
  </response>

Atributy​

  • status - popis neuveden(typ: string) TYP HODNOTY: string;

  • detail - popis neuveden(typ: string) TYP HODNOTY: string;

Potomci​

Odpověď delete neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Struktura odpovědi na požadavek file-system vrácená v obálce response:

  <response>
   <copy
    status="{string}"
    detail="{string}"
    />
  </response>

Atributy​

  • status - popis neuveden(typ: string) TYP HODNOTY: string;

  • detail - popis neuveden(typ: string) TYP HODNOTY: string;

Potomci​

Odpověď copy neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Struktura odpovědi na požadavek file-system vrácená v obálce response:

  <response>
   <move
    status="{string}"
    detail="{string}"
    />
  </response>

Atributy​

  • status - popis neuveden(typ: string) TYP HODNOTY: string;

  • detail - popis neuveden(typ: string) TYP HODNOTY: string;

Potomci​

Odpověď move neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Struktura odpovědi na požadavek file-system vrácená v obálce response:

  <response>
   <mkdir
    status="{string}"
    detail="{string}"
    />
  </response>

Atributy​

  • status - popis neuveden(typ: string) TYP HODNOTY: string;

  • detail - popis neuveden(typ: string) TYP HODNOTY: string;

Potomci​

Odpověď mkdir neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Struktura odpovědi na požadavek file-system vrácená v obálce response:

  <response>
   <rename
    status="{string}"
    detail="{string}"
    />
  </response>

Atributy​

  • status - popis neuveden(typ: string) TYP HODNOTY: string;

  • detail - popis neuveden(typ: string) TYP HODNOTY: string;

Potomci​

Odpověď rename neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Výraz pro identifikaci chyb v odpovědi serveru: file-system/*[@status='error'] (odkaz na popis detailu: @detail).

Uzel list​

  <list
   path="{string}"
   recurse="{boolean}"
   files="{boolean}"
   dirs="{boolean}"
   older-than="{dateTime}"
   newer-than="{dateTime}"
   larger-than="{number}"
   smaller-than="{number}"
   dirs-by-time-check="{boolean}"
   regexp="{string}"
   />

Atributy​

  • path - zdrojová cesta, bližší informace dále v tomto dokumentu(typ: string) TYP HODNOTY: string;

  • recurse - zda se má struktura procházet rekurzivně, výchozí hodnota false(typ: boolean) TYP HODNOTY: boolean;

  • files - zda se mají daným způsobem zpracovávat soubory, výchozí hodnota true(typ: boolean) TYP HODNOTY: boolean;

  • dirs - zda se mají daným způsobem zpracovávat adresáře, výchozí hodnota true pro list, false pro vše ostatní(typ: boolean) TYP HODNOTY: boolean;

  • older-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) starší než(typ: dateTime) TYP HODNOTY: dateTime;

  • newer-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) mladší než(typ: dateTime) TYP HODNOTY: dateTime;

  • larger-than - zpracovávat pouze soubory větší než(typ: number) TYP HODNOTY: number;

  • smaller-than - zpracovávat pouze soubory menší než(typ: number) TYP HODNOTY: number;

  • dirs-by-time-check - zda se kritérium data má aplikovat i na adresáře, výchozí false(typ: boolean) TYP HODNOTY: boolean;

  • regexp - regulární výraz pro výběr souborů(typ: string) TYP HODNOTY: string;

Potomci​

Uzel list neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Uzel delete​

  <delete
   path="{string}"
   recurse="{boolean}"
   files="{boolean}"
   dirs="{boolean}"
   older-than="{dateTime}"
   newer-than="{dateTime}"
   larger-than="{number}"
   smaller-than="{number}"
   dirs-by-time-check="{boolean}"
   regexp="{string}"
   del-previously-empty-dirs="{boolean}"
   del-root-dir="{boolean}"
   />

Atributy​

  • path - zdrojová cesta, bližší informace dále v tomto dokumentu(typ: string) TYP HODNOTY: string;

  • recurse - zda se má struktura procházet rekurzivně, výchozí hodnota false(typ: boolean) TYP HODNOTY: boolean;

  • files - zda se mají daným způsobem zpracovávat soubory, výchozí hodnota true(typ: boolean) TYP HODNOTY: boolean;

  • dirs - zda se mají daným způsobem zpracovávat adresáře, výchozí hodnota true pro list, false pro vše ostatní(typ: boolean) TYP HODNOTY: boolean;

  • older-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) starší než(typ: dateTime) TYP HODNOTY: dateTime;

  • newer-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) mladší než(typ: dateTime) TYP HODNOTY: dateTime;

  • larger-than - zpracovávat pouze soubory větší než(typ: number) TYP HODNOTY: number;

  • smaller-than - zpracovávat pouze soubory menší než(typ: number) TYP HODNOTY: number;

  • dirs-by-time-check - zda se kritérium data má aplikovat i na adresáře, výchozí false(typ: boolean) TYP HODNOTY: boolean;

  • regexp - regulární výraz pro výběr souborů(typ: string) TYP HODNOTY: string;

  • del-previously-empty-dirs - popis neuveden(typ: boolean) TYP HODNOTY: boolean;

  • del-root-dir - popis neuveden(typ: boolean) TYP HODNOTY: boolean;

Potomci​

Uzel delete neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Uzel copy​

  <copy
   path="{string}"
   target="{string}"
   recurse="{boolean}"
   older-than="{dateTime}"
   newer-than="{dateTime}"
   larger-than="{number}"
   smaller-than="{number}"
   dirs-by-time-check="{boolean}"
   regexp="{string}"
   overwrite="always|skip-existing|older|newer|fail"
   />

Atributy​

  • path - zdrojová cesta, bližší informace dále v tomto dokumentu(typ: string) TYP HODNOTY: string;

  • target - Cíl operace(typ: string) TYP HODNOTY: string;

  • recurse - zda se má struktura procházet rekurzivně, výchozí hodnota false(typ: boolean) TYP HODNOTY: boolean;

  • older-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) starší než(typ: dateTime) TYP HODNOTY: dateTime;

  • newer-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) mladší než(typ: dateTime) TYP HODNOTY: dateTime;

  • larger-than - zpracovávat pouze soubory větší než(typ: number) TYP HODNOTY: number;

  • smaller-than - zpracovávat pouze soubory menší než(typ: number) TYP HODNOTY: number;

  • dirs-by-time-check - zda se kritérium data má aplikovat i na adresáře, výchozí false(typ: boolean) TYP HODNOTY: boolean;

  • regexp - regulární výraz pro výběr souborů(typ: string) TYP HODNOTY: string;

  • overwrite - zda je operace oprávněna přepisovat existující soubory, výchozí hodnota always(typ: string) TYP HODNOTY: string; Možnosti obsahu: » always ~ povolit přepisování souborů » skip-existing ~ přeskakovat (nepřepisovat) existující soubory, přeskočení není chyba » older ~ přepisovat pouze starší soubory » newer ~ přepisovat pouze novější soubory » fail ~ pokus o přepsání existujícího souboru je chápán jako chyb

Potomci​

Uzel copy neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Uzel move​

  <move
   path="{string}"
   target="{string}"
   recurse="{boolean}"
   older-than="{dateTime}"
   newer-than="{dateTime}"
   larger-than="{number}"
   smaller-than="{number}"
   dirs-by-time-check="{boolean}"
   regexp="{string}"
   overwrite="always|skip-existing|older|newer|fail"
   />

Atributy​

  • path - zdrojová cesta, bližší informace dále v tomto dokumentu(typ: string) TYP HODNOTY: string;

  • target - Cíl operace(typ: string) TYP HODNOTY: string;

  • recurse - zda se má struktura procházet rekurzivně, výchozí hodnota false(typ: boolean) TYP HODNOTY: boolean;

  • older-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) starší než(typ: dateTime) TYP HODNOTY: dateTime;

  • newer-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) mladší než(typ: dateTime) TYP HODNOTY: dateTime;

  • larger-than - zpracovávat pouze soubory větší než(typ: number) TYP HODNOTY: number;

  • smaller-than - zpracovávat pouze soubory menší než(typ: number) TYP HODNOTY: number;

  • dirs-by-time-check - zda se kritérium data má aplikovat i na adresáře, výchozí false(typ: boolean) TYP HODNOTY: boolean;

  • regexp - regulární výraz pro výběr souborů(typ: string) TYP HODNOTY: string;

  • overwrite - zda je operace oprávněna přepisovat existující soubory, výchozí hodnota always(typ: string) TYP HODNOTY: string; Možnosti obsahu: » always ~ povolit přepisování souborů » skip-existing ~ přeskakovat (nepřepisovat) existující soubory, přeskočení není chyba » older ~ přepisovat pouze starší soubory » newer ~ přepisovat pouze novější soubory » fail ~ pokus o přepsání existujícího souboru je chápán jako chyba

Potomci​

Uzel move neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Uzel mkdir​

  <mkdir
   path="{string}"
   recurse="{boolean}"
   />

Atributy​

  • path - zdrojová cesta, bližší informace dále v tomto dokumentu(typ: string) TYP HODNOTY: string;

  • recurse - zda se má struktura procházet rekurzivně, výchozí hodnota false(typ: boolean) TYP HODNOTY: boolean;

Potomci​

Uzel mkdir neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Uzel rename​

Jde o uzel obsahující text

Možnosti obsahu:

» always ~ povolit přepisování souborů

» skip-existing ~ přeskakovat (nepřepisovat) existující soubory, přeskočení není chyba

» older ~ přepisovat pouze starší soubory

» newer ~ přepisovat pouze novější soubory

» fail ~ pokus o přepsání existujícího souboru je chápán jako chyba

  <rename
   path="{string}"
   target="{string}"
   recurse="{boolean}"
   files="{boolean}"
   dirs="{boolean}"
   older-than="{dateTime}"
   newer-than="{dateTime}"
   larger-than="{number}"
   smaller-than="{number}"
   dirs-by-time-check="{boolean}"
   regexp="{string}"
   overwrite="{string}"
   />

Atributy​

  • path - zdrojová cesta, bližší informace dále v tomto dokumentu(typ: string) TYP HODNOTY: string;

  • target - Cíl operace(typ: string) TYP HODNOTY: string;

  • recurse - zda se má struktura procházet rekurzivně, výchozí hodnota false(typ: boolean) TYP HODNOTY: boolean;

  • files - zda se mají daným způsobem zpracovávat soubory, výchozí hodnota true(typ: boolean) TYP HODNOTY: boolean;

  • dirs - zda se mají daným způsobem zpracovávat adresáře, výchozí hodnota true pro list, false pro vše ostatní(typ: boolean) TYP HODNOTY: boolean;

  • older-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) starší než(typ: dateTime) TYP HODNOTY: dateTime;

  • newer-than - zpracovávat pouze soubory, případně i adresáře (dirs-by-time-check) mladší než(typ: dateTime) TYP HODNOTY: dateTime;

  • larger-than - zpracovávat pouze soubory větší než(typ: number) TYP HODNOTY: number;

  • smaller-than - zpracovávat pouze soubory menší než(typ: number) TYP HODNOTY: number;

  • dirs-by-time-check - zda se kritérium data má aplikovat i na adresáře, výchozí false(typ: boolean) TYP HODNOTY: boolean;

  • regexp - regulární výraz pro výběr souborů(typ: string) TYP HODNOTY: string;

  • overwrite - zda je operace oprávněna přepisovat existující soubory, výchozí hodnota always(typ: string) TYP HODNOTY: string;

Potomci​

Uzel rename neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.