Požadavek action
Spuštění akce
Server umožňuje spouštět transformační akce nastavené jako služby. Tyto se běžně spouští pomocí soap rozhraní. Požadavek action umožňuje tyto služby spouštět v rámci běžného XML rohraní flexideo serveru. Také vyžaduje zabalení do soap/envelope v obsahu zprávy, ale jde o předání požadavku nikoli přes soap rozhraní ale flexido XML požadavky.
<request>
<action
name="{string}"
call-type="table|form|service"
>
<{element} ... > ... </{element}>?
</action>
</request>
Atributy
name - Název akce - Název spouštěné akce. Musí odpovídat registru akcí. Při soap volání je tento název součástí URL volané služby.(typ: string)
call-type - Typ spuštění akce - Při soap volání je typ součástí URL volané služby.(typ: string)
TYP HODNOTY: string;
Možnosti obsahu:
» table ~ Volání vícepoložkové akce v režimu tabulky, vstupem je často pdk-list.
» form ~ Volání akce v rámci formuláře, vstupem je často XML draft dokumentu.
» service ~ Jde o volání akce s libovolně definovaným vstupem a výstupem.
Potomci
Požadavek action umožňuje uvést jeden volitelný element: SOAP obálka - Envelope uzel ze jmenného prostoru http://schemas.xmlsoap.org/soap/envelope/, který je předáván na vstup SOAP služby volané akce.
Odpověď
Struktura odpovědi na požadavek action vrácená v obálce response:
<response>
<action
type="ok|error"
>
<{element} ... > ... </{element}>?
</action>
</response>
Atributy
type - Obsahuje hodnoty ok nebo error (možnosti obsahu: ok | error)
Potomci
Odpověď action umožňuje uvést jeden volitelný element: SOAP obálka - Envelope uzel ze jmenného prostoru http://schemas.xmlsoap.org/soap/envelope/ s obsahující výstupní Body nebo Fault uzel s výsledkem akce.
Výraz pro identifikaci chyb v odpovědi serveru: action[@type='error'] (odkaz na popis detailu: .//*[local-name()='Fault']//*[contains(local-name(), 'detail')]//*[.!='']).
Další info
Popis interního protokolu akcí pro vložení do těla zprávy najdete v popisu schematu run-action.
Totéž co umožňuje action provádět obratem umožňuje požadavek do-action provádět odloženě a nebo opakovaně bez odkládání se stejnou strukturou požadavku.
Viz. též příklad spuštění akce.