Element `<if>`¶

Zweck: Definiert einen bedingten Zweigkörper für if- und else-if-Workflow-Elemente.

Warum: Verwende dieses Element als ersten condition-Zweig, wenn seine Kinder nur für passende Datensätze laufen sollen.

Beispiel¶

<if condition="customer.is_active"/>

Entscheidungshilfe¶

Fachlicher Nutzen: Macht den ersten exklusiven fachlichen Zweig im Modell sichtbar.

Verwenden, wenn
- Wenn eine Gruppe von Kindelementen nur bei einer wahren Bedingung laufen soll.
Anderen Ansatz wählen, wenn
- Wenn nur eine Feldzuweisung oder Validierungsregel bedingt ist.
Voraussetzungen
- Platziere if zuerst in condition und gib einen booleschen Ausdruck an.
Alternativen
- Verwende mapping für eine bedingte Transformationszuweisung. (Siehe: <mapping>)
- Verwende rule für eine einzelne explizite bedingte Aktion. (Siehe: <rule>)

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¶

I506 — Condition Eval Failed

Failed to evaluate condition '{condition}' for {element_label}: {error}

Warum: The system failed to evaluate condition '{condition}' for {element_label}: {error}.

Lösung: Fix the expression or script and retry.

Vollständige Regel

I507 — Condition Not Boolean

Condition '{condition}' for {element_label} evaluated to a non-boolean value (not a valid boolean value): {value}

Warum: A condition evaluated to a non-boolean value in the condition configuration.

Lösung: Ensure the expression evaluates to true or false.

Vollständige Regel

Erlaubte Elternelemente / Erlaubte Kindelemente¶

Erlaubte Elternelemente: condition, else, else-if, if, while

Erlaubte Kindelemente:

Jedes registrierte DSL-Element.

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 1 Attribute anzeigen

condition

Condition to evaluate.

erforderlich; string.

Element <if>¶