X4 Help Center

Merge

symbol_merge_32.png

Merge: Führt XML-Dokumente aus unterschiedlichen Quellen zu einem einzigen XML-Dokument zusammen oder führt Text- oder Binärdatenströme zusammen.

Eigenschaften

Label

Beschriftung des Symbols im Prozessdiagramm

Root Element

Name des Wurzelelements, das den gesamten Inhalt der zusammengeführten XML-Dokumente enthält.

Mögliche Werte:

  • Zeichenkette, die für XML-Elementnamen gültig ist.
    Standard: Merge


Daten mit Merge zusammenführen

Der Merge-Baustein wird meist hinter der Zusammenführung einer Gabelung (Join) verwendet. Wenn XML-Dokumente zusammengeführt werden, dann enthält das durch den Merge-Baustein erzeugte XML-Dokument ein Wurzelelement, das wiederum die Wurzelelemente und sämtliche Knoten der zusammengeführten XML-Dokumente enthält. Diese XML-Struktur kann vom nächsten Prozessschritt verarbeitet werden. Der Name des Wurzelelements kann über die Eigenschaft Root Element des Merge-Bausteins festgelegt werden.

Hinweis:

Wenn über einen Merge-Baustein XML-Dokumente und mindestens ein Nicht-XML-Dokument zusammengeführt werden, wird die Ausgabe aller Dokumente in dem durch den Merge-Baustein erzeugten Output verkettet. 

Wenn zwei XML-Dokumente zusammengeführt werden, die bereits in einem vorherigen Schritt durch den Merge-Baustein zusammengeführt wurden, enthält das Ergebnis-XML-Dokument lediglich ein Wurzelelement und sämtliche Knoten der zusammengeführten XML-Dokumente.

Zusammenführung von zwei Dokumenten
XML
<?xml version="1.0" encoding="UTF-8" ?>
<Merge>
   <!-- Daten 1 -->
   <!-- Daten 2 -->
</Merge>

Wenn die Input-Dokumente Textdaten (MIME-Typ text ... oder application/xml) mit derselben Zeichenkodierung sind, dann wird deren Zeichenkodierung ausgegeben. Bei unterschiedlicher Zeichenkodierung wird eine UTF-8-Sequenz ausgegeben. Wenn der MIME-Typ bei allen Input-Dokumenten gleich ist, dann hat das Ergebnis auch diesen MIME-Typ, ansonsten text/plain.

Root-Element konfigurieren

Der Merge-Baustein fasst mehrere XML-Fragmente zu einem Ergebnisdokument zusammen. Dabei steuert der konfigurierte Root-Elementname, wie die zusammengeführten Inhalte im Output strukturiert werden.

Standardverhalten: flache Liste mit Root-Element <Merge>

Wenn Sie eine flache Liste ohne zusätzliche Verschachtelung erzeugen möchten, verwenden Sie als Root-Elementnamen den Standardwert <Merge>.

Beispieloutput:

XML
<Merge>
  <Order id="ORD-2026-00123" status="OPEN">
    <Customer id="C-10001"/>
    <Total currency="EUR">149.90</Total>
  </Order>
  <Order id="ORD-2026-00124" status="OPEN">
    <Customer id="C-10002"/>
    <Total currency="EUR">89.50</Total>
  </Order>
</Merge>

Alle gemergten Elemente werden direkt unter dem Root-Element <Merge> eingefügt.

Individueller Root-Elementname: verschachtelte Struktur

Wenn Sie eine strukturiertere Ausgabe benötigen, verwenden Sie einen individuellen Namen für das Root-Element (z. B. CustomerOrders). Dadurch kann das Ergebnis zusätzliche Ebenen enthalten, um Inhalte logisch zu gruppieren (z. B. aktuelle vs. archivierte Bestellungen).

Beispiel-Output:

XML
<CustomerOrders customerId="C-10001">
  <Order id="ORD-2026-00123" status="OPEN">
    <Total currency="EUR">149.90</Total>
  </Order>
  <archivedOrders>
    <Order id="ORD-2025-00987" status="CLOSED">
      <Total currency="EUR">219.00</Total>
    </Order>
  </archivedOrders>
</CustomerOrders>

So können Sie zusätzliche Ebenen in der Ergebnisstruktur abbilden und die gemergten Inhalte in eine bestehende XML-Struktur integrieren.