Požadavek do-scan-files

Analýza příloh

Požadavek slouží pro analýzu konzistence propojení databáze na sourobory. Během fungování serveru dochází ke vzniku dočasných souborů. Pokud není operace klientem následně řádně uzavřena, mohou tyto dočasné soubury zůstat na serveru.

Během nestandardních operací se serverem - obnovování ze zálohy, opětovné resynchronizace s Exchange serverem, ... - může v souborovém úložišti dojít ke vzniku souborů na něž není ze serveru flexideo žádná reference.

Požadavek do-scan-files slouží k nalezení a výmazu těchto souborů.

Uzel obsahující požadavek na plán úlohy.

Základní typ(y) uzlu(ů): do-task;

syntax
<request>
<do-scan-files
validity="{string}"
repeat="{string}"
sched-from-end="{boolean}"
when-off="{boolean}"
failsafe="{string}"
sched-from-end="{boolean}"
test="{boolean}"
temp="{boolean}"
temp-threshold="{number}"
delete="{boolean}"
wait-for-lock="{string}"
scan="{boolean}"
cross="{boolean}"
place-holder="{boolean}"
test-crc="{number}"
opt="{boolean}"
opt-threshold="{number}"
/>
</request>

Atributy

validity - Určuje platnost úlohy. Spec. povinná syntaxe: [once]|today|still|from-{#YYYY-MM-DD}[;to-{#YYYY-MM-DD}] (typ: string) TYP HODNOTY: string;

repeat - Určuje případné opakování úlohy. Spec. povinná syntaxe: [none]|hourly|daily|weekly|monthly|yearly|from-{#YYYY-MM-DD}[;to-{#YYYY-MM-DD}][;each-nn-(minutes|hours|days|weeks|months)[[-xx]...]][;at-{#hh:mm}] (typ: string) TYP HODNOTY: string;

sched-from-end - Říká, zda je interval opakování úlohy počítán od jejího ukončení. Umožňuje přesnější návaznost.(typ: boolean) TYP HODNOTY: boolean;

when-off - Zapíná ošetření při vypnutí. Je-li úloha zadána s when-off=true a vyjde-li její provedení na dobu, kdy je server mimo provoz, dojde ke spuštění úlohy po obnovení činnosti serveru.(typ: boolean) TYP HODNOTY: boolean;

failsafe - Určuje případné opakování úlohy vyskytne-li se při jejím provádění chyba. Syntaxe shodná s nastavením repeat: [none]|hourly|daily|weekly|monthly|yearly|from-{#YYYY-MM-DD}[;to-{#YYYY-MM-DD}][;each-nn-(minutes|hours|days|weeks|months)[[-xx]...]][;at-{#hh:mm}] (typ: string) TYP HODNOTY: string;

sched-from-end - Časování od konce úlohy.(typ: boolean) TYP HODNOTY: boolean;

test - Určuje, zda provést test. Pokud existuje vysledek předchozího testu, pak je tento předchozí výsledek vymazán.(typ: boolean) TYP HODNOTY: boolean;

temp - Určuje, zda do analýzy zahrnout i dočasné soubory.(typ: boolean) TYP HODNOTY: boolean;

temp-threshold - Určuje stáří dočasných souborů v sekundách, které již mají být vymazány (výchozí hodnota je 14 dní).(typ: number) TYP HODNOTY: number;

delete - Určuje, zda provést výmaz souborů.(typ: boolean) TYP HODNOTY: boolean;

wait-for-lock - Pro provedení operaci scan-files je třeba získat výhradní přístup k souborům, atribut určuje, zda při jeho nezískání skončit, nebo na jeho získání čekat.(typ: string) TYP HODNOTY: string;

scan - Spouští scan fázi základního testu, pokud se předešlý dokončil, nebo dosud neproběhl.(typ: boolean) TYP HODNOTY: boolean;

cross - Aktivuje rozšíření cross základního testu, samostatně nebo společně se základním testem.(typ: boolean) TYP HODNOTY: boolean;

place-holder - Aktivuje rozšíření základního testu, samostatně nebo společně se základním testem.(typ: boolean) TYP HODNOTY: boolean;

test-crc - V rámci rozšíření cross provete ověření CRC součtů souborů.(typ: number) TYP HODNOTY: number;

opt - Spsustí výmaz optimalizovaných souborů (tento atribut lze kombinovat s ostatními bez změny jeho chování).(typ: boolean) TYP HODNOTY: boolean;

opt-threshold - Určuje stáří optimalizovaných souborů v sekundách.(typ: number) TYP HODNOTY: number;


Potomci

Požadavek do-scan-files neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.


Poznámka k request

Atributy validity, repeat, when-off, failsafe - viz též nastavení plánovače úloh.


Odpověď

Struktura odpovědi na požadavek do-scan-files vrácená v obálce response:

syntax
<response>
<do-scan-files
status="ok|error"
detail="{string}"
/>
</response>

Atributy

status - Obsahuje hodnoty ok nebo error

Možnosti obsahu:

» ok ~ Požadavek proveden bez chyb.

» error ~ Při provádění požadavku došlo k chybě.

detail - Upřesnění - Bližší popis vzniklé chyby. Je k dispozici při odpovědi typu 'error'.(typ: string)


Potomci

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

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


Další info

Požadavky pro do-scan-files může zadávat pouze uživatel s administrátorským oprávněním. Aby uživatel mohl tento požadavek používat, musí mít ve vlastnostech uživatele aktivováno oprávnění p_admin.


Požadavek admin-unlockPožadavek cache-boostPožadavek do-managePožadavek do-optimize-filesPožadavek do-scan-filesPožadavek get-scan-filesPožadavek mimesPožadavek servicePožadavek soap-servicesPožadavek test-performancePožadavek unload-soapPožadavek unload-pseudoPožadavek update-dadPožadavek update-files