Syntaxe požadavku

Na základě výše popsaných skutečností bude mít požadavek na import následující XML syntaxi:

<do-force-import
  folder="{#string}"
  test="true|false"
  self="true|false"
  delete="true|false"
  validity="{#string}"
  repeat="{#string}"
  when-off="{true|false}"
  failsafe="{#string}"
  />

Jednotlivé atributy mají následující význam:

• folder - jmeno složky v níž se budou hledat soubory pro import

• test - provede pouze test konzistence dat importu. Jelikož import může být velmi složitý s vnitřními vazbami mezi jednotlivými soubory, ale také s vazbami na stávající data, je vhodné jej před použitím otestovat. Pro tuto operaci není nutné zastavovat server.

• self - standardně (false) je autorem importovaných dat uživatel system, pokud je atribut zapnut (true), pak se autorem stane uživatel, který zadal požadavek na force-import

• delete - určuje, zda mají být soubory po importování vymazány

• validity, repeat, when-off, failsafe - viz Nastavení plánovače úloh

Jako potomci tagu požadavku do-import jež je potomkem tagu request jsou v seznamu uvedeny jednotlivé odkazy na naplňované prvky. Ty jsou identifikovány pomocí xds-id.

Pokud jsou importovaná data součástí požadavku, pak jsou uváděna v tagu data. Struktura prikládaných dat je shodná se strukturou souboru, u XML se je tag data kořenovým tagem (tag data-file se neuvádí).

Aby uživatel mohl tento požadavek používat, musí mít ve vlastnostech uživatele aktivováno oprávnění p_fimport nebo p_admin.