Typ transform

Zásadní oprava: tento typ dříve jen duplikoval atributy kořenového uzlu transform (stop-on-*), aniž by popisoval strukturu, na kterou se z požadavku transform odkazuje (jednotlivý transformační krok perform-transform). Nyní popisuje skutečnou sdílenou strukturu obálky transformace.

  <transform
   id="{string}"
   opt-roles="{string}"
   stop-on-error="{bool}"
   stop-on-empty="{bool}"
   stop-on-param-error="{bool}"
   >
   <input encode="hex|base64|url|json"> ... </input>
   <steps>
    <perform-transform
     xslt="{string}"
     stop-on-error="{bool}"
     stop-on-param-error="{bool}"
     >
     <param name="{string}" value="{string}"/> *
    </perform-transform> *
   </steps>
  </transform>

Atributy kořenového uzlu

• id - Volitelný identifikátor, echovaný v chybové odpovědi. (typ: string; nepovinný)
• opt-roles - Volitelná role pro provedení transformace. (typ: string; nepovinný)
• stop-on-error - Výchozí hodnota pro kroky, které ji sami nepřepíšou: chyba transformace zastaví další zpracování. (typ: bool; nepovinný; výchozí: false)
• stop-on-empty - Zastaví zpracování, je-li výstup kroku prázdný. (typ: bool; nepovinný; výchozí: false)
• stop-on-param-error - Výchozí hodnota pro kroky: chyba při nastavení parametru šablony zastaví zpracování. (typ: bool; nepovinný; výchozí: false)

Uzel input

• encode - Kódování vstupního obsahu: hex|base64|url|json; neuveden = vstup je vzat doslovně jako XML/text. (typ: enum; nepovinný)

Uzel steps a perform-transform

steps obsahuje sekvenci kroků zpracovávaných v pořadí výskytu. Nejběžnější krok je perform-transform:

• xslt - Cesta k XSLT šabloně; chybí-li nebo není-li dostupná, krok selže. (typ: string; povinný)
• stop-on-error, stop-on-param-error - Přepíší pro tento krok hodnotu zděděnou z kořenového uzlu. (typ: bool; nepovinné)
• Potomek param - Dosadí hodnotu pojmenovaného parametru šablony (name/value); parametr, který šablona nedefinuje, je chybou jen pokud je aktivní stop-on-param-error.

Existují i další typy kroků (např. perform-request), jejich chování nebylo v této revizi vyčerpávajícím způsobem zdokumentováno.