XML-Technologien / XProc / Referenz / wrap-sequence

XProc Steps

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

p:wrap-sequence

<p:declare-step type="p:wrap-sequence">
   <p:input port="source" sequence="true"/>
   <p:output port="result" sequence="true"/>
   <p:option name="wrapper" required="true"/> <!-- QName -->
   <p:option name="wrapper-prefix"/> <!-- NCName -->
   <p:option name="wrapper-namespace"/> <!-- anyURI -->
   <p:option name="group-adjacent"/> <!-- XPathExpression -->
</p:declare-step>

Mit dem <p:wrap-sequence> ist es möglich, Dokumente mit einem neuen Element zu umschliessen. Während <p:wrap> durch entsprechende XSLT Ausdrücke gezielt im Dokument verwendet werden kann, so wird bei <p:wrap-sequence> immer das komplette Dokument mit dem neuen Wrapper-Element umschlossen. Wie der Name des Steps “wrap-sequence“ andeutet, können mehrere Sequenzen (i.d.R Dokumente) mit diesem Step verarbeitet werden. Der Name des neuen Wrappers wird in der Option “Wrapper“ angegeben. Diesem Element kann zusätzlich durch die Optionen “wrapper-prefix“ und “wrapper-namespace“ noch ein Namensraum und Prefix zugewiesen werden. Durch die Option “group-adjacent“ kann festgelegt werden, dass Elemente, die direkt zusammen liegen und zu dem von der Option verlangten XPath Ausdruck passen, in das neue Wrapper-Element mit gruppiert werden. Die zu verarbeitenden Dokumente werden am Input-Port (“source“) geladen. Das Resultat wird auf den Output-Port (“result“) geschrieben.

Beispiel

Im Beispiel wird das bekannte Beispieldokument (“filmsammlung“) mit einem Wrapper versehen.

<?xml version="1.0" encoding="UTF-8"?>
<p:declare-step xmlns:p="http://www.w3.org/ns/xproc" xmlns:c="http://www.w3.org/ns/xproc-step" version="1.0">
   <p:input port="source">
      <p:document href="filmsammlung.xml"/>
   </p:input>
   <p:output port="result"/>
   <p:wrap-sequence wrapper="Videothek"/>
</p:declare-step>

Der neue Wrapper im Beispiel heisst “Videothek“. Das Resultat dieses Prozesses würde folgendermaßen aussehen (Auszug):

<Videothek>
   <FilmSammlung>
      <Film>
         <Titel>Star Wars: Episode IV - A New Hope</Titel>
         <Jahr>1978</Jahr>
[...]

Tipp der data2type-Redaktion:
Zum Thema XProc bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: