Element `<list>`¶

Zweck: Erzeugt einen Listenwert aus einer oder mehreren deklarierten Eintragsformen.

Warum: Verwende dieses Element, wenn ein Ausgabefeld Einträge mit unterschiedlichen Formen oder Bedingungen kombiniert.

Beispiel¶

<list name="line_items"/>

Entscheidungshilfe¶

Fachlicher Nutzen: Repräsentiert eine Sammlung, deren Einträge verschiedene Formen oder fachliche Bedingungen besitzen dürfen.

Verwenden, wenn
- Wenn ein Feld alternative Item-Formen oder bedingt enthaltene Einträge kombiniert.
Anderen Ansatz wählen, wenn
- Wenn alle Werte homogene Skalare sind oder alle Datensätze dieselbe Struktur besitzen.
Voraussetzungen
- Deklariere ein oder mehrere item-Kinder und ihre Auswahlbedingungen.
Alternativen
- Verwende array für homogene skalare Werte. (Siehe: <array>)
- Verwende nestedKey für wiederholte Datensätze einer Form. (Siehe: <nestedKey>)

Vollständige Beispiele¶

Verschachtelte Objekte, bedingte Listen, Arrays und Zweige zusammensetzen

Verwende diese Form, wenn ein deterministisches Produkt verschachtelte Datensätze, heterogene Listeneinträge, Literal-Arrays und exklusive Felder kombiniert.

structured-profile/datamimic.xml
<setup rngSeed="42" numProcess="1">
    <generate name="profiles" count="3" target="LogExporter">
        <key name="id" generator="IncrementGenerator"/>
        <nestedKey name="address" type="dict">
            <key name="city" constant="Berlin"/>
            <key name="postal_code" constant="10115"/>
        </nestedKey>
        <list name="contacts" converter="RemoveNoneOrEmptyElement">
            <item>
                <key name="channel" constant="email"/>
                <key name="value" script="'customer-' + str(id) + '@example.test'"/>
            </item>
            <item condition="id % 2 == 0">
                <key name="channel" constant="sms"/>
                <key name="value" script="'+49-30-' + str(100000 + id)"/>
            </item>
        </list>
        <array name="roles" type="literal">
            <value constant="customer"/>
            <value constant="newsletter"/>
        </array>
        <condition>
            <if condition="id == 1">
                <key name="segment" constant="new"/>
            </if>
            <else-if condition="id == 2">
                <key name="segment" constant="active"/>
            </else-if>
            <else>
                <key name="segment" constant="loyal"/>
            </else>
        </condition>
    </generate>
</setup>

Regeln und ungültige Kombinationen¶

Keine zusätzlichen elementspezifischen Regeln. Pflichtattribute, Typen und unterstützte Werte stehen unten.

Erlaubte Elternelemente / Erlaubte Kindelemente¶

Erlaubte Elternelemente: else, else-if, generate, if, item, iterate, nestedKey, while

Erlaubte Kindelemente:

item

Strukturierte Daten und Regel-Pipelines — Shows how composite output shapes and the ordered source-filter, mapping, and target-filter pipeline work together without hiding phase boundaries.

Attribute¶

Alle 2 Attribute anzeigen

converter

Converter for element data transformation.

optional; string; Standardwert: null.

name

Name of the list.

erforderlich; string.

Element <list>¶