Freigeben über


Umschlagverwendung in den XML-Assembler- und -Disassembler-Pipelinekomponenten

Eine XML-Nachricht kann null oder mehrere Umschläge enthalten. Das folgende Beispiel zeigt einen Umschlag (in Fettschrift), in den ein XML-Dokument eingepackt ist.

<ns1:document xmlns:ns1="http://myDocumentNamespaceURI.org">  
   <message>Hello</message>  
</ns1:document>  
  

Umschläge dienen zwei Verwendungszwecken:

  • Sie können Feldwerte für die Eigenschaftsheraufstufung und -herabstufung enthalten.

    Von der XML-Disassemblerkomponente werden Eigenschaften heraufgestuft, von der XML-Assemblerkomponente werden Eigenschaften herabgestuft. Die Eigenschaftsheraufstufung und -herabstufung kann auch in XML-Dokumenten stattfinden.

  • Sie können mehrere XML-Dokumente in einem einzelnen Austausch kombinieren.

    Da jedes gültige XML-Dokument nur über ein Stammelement verfügen kann, ermöglicht ein Umschlag die Kombination mehrerer XML-Dokumente zur gemeinsamen Nutzung eines Stammelements.

    Sie können die kanonische Form erzwingen, indem Sie die Umschlagreihenfolge mithilfe des Dialogfelds Editor für Schemaauflistungseigenschaften angeben, auf das zugegriffen wird, indem Sie im XML-Assembler auf die Auslassungspunkte für die Entwurfseigenschaft Umschlagschemas klicken. Sie können auch XMLNORM verwenden. EnvelopeSpecNames-Nachrichtenkontexteigenschaft , bevor der XML-Assembler ausgeführt wird. Der XML-Assembler generiert ein in einem Umschlag enthaltenes Dokument in kanonischer Form.

Verschachteln von Umschlägen

Umschläge lassen sich zur Bildung komplexer Dokumentstrukturen verschachteln, wobei mehrere eingepackte XML-Dokumente in einem größeren Austausch kombiniert werden können. Das folgende Beispiel zeigt einen Austausch, der von zwei Umschlägen eingeschlossen ist.

<envelope1>  
   <document1/>  
   <envelope2>  
      <document2/>  
      <document3/>  
   </envelope2>  
   <document4/>  
</envelope1>  

Das vorhergehende Beispiel zeigt eine flexible Form, d. h., ein Dokument kann sich auf derselben Hierarchieebene wie ein Umschlag befinden. Nach dem Disassemblieren des im Umschlag enthaltenen Dokuments werden vier separate Dokumente erstellt (Dokument1, Dokument2 usw.).

Weitere Informationen

Pipelinekomponenten