Element <element>

Zweck: Definiert ein XML-orientiertes Feld mit denselben Wertsemantiken wie ein key.

Warum: Verwende diese key-Form, wenn ein XML-orientiertes Ziel eine elementspezifische Feldabsicht benötigt.

Beispiel

<element name="customer_id" generator="IncrementGenerator"/>

Entscheidungshilfe

Fachlicher Nutzen: Hält XML-spezifische erzeugte Attribute oder Kindwerte in einem XML-Produktmodell explizit.

• Verwenden, wenn

  • Wenn ein XML-Ziel elementorientierte Feldsemantik unterhalb eines Werts benötigt.

• Anderen Ansatz wählen, wenn

  • Wenn ein tabulares oder JSON-Ziel ein gewöhnliches Produktfeld benötigt.

• Voraussetzungen

  • Platziere element unter einem kompatiblen Feldcontainer und wähle eine Wertstrategie.

• Alternativen

  • Verwende key für gewöhnliche Ausgabefelder über Zielformate hinweg. (Siehe: <key>)

Vollständige Beispiele

XML-Elementattribute explizit modellieren

Verwende element unter einem key oder nestedKey, wenn das XML-Artefakt neben Elementtext auch generierte Attribute benötigt.

<setup>
    <generate name="customers" count="2" target="LogExporter">
        <key name="customer" constant="active">
            <element name="id" generator="IncrementGenerator"/>
            <element name="country" constant="DE"/>
        </key>
    </generate>
</setup>

Regeln und ungültige Kombinationen

Ein Feld benötigt genau einen Modus zur Werterzeugung.

Attribute: type, source, values, script, generator, constant, pattern, string

Warum: Ein Feld ohne Typ, Quelle, Wertepool, Skript, Generator, Konstante, Pattern oder String-Template kann keinen Wert erzeugen.

<element name="status" constant="active"/>

<element name="status"/>

Wähle genau einen expliziten Erzeugungsmodus für das Feld.

Attribute: source, values, script, generator, constant, pattern, string

Warum: Die Kombination mehrerer Wertquellen würde die Herkunft des Feldwerts mehrdeutig machen.

<element name="status" constant="active"/>

<element name="status" constant="active" string="${status}"/>

weights erfordert einen Inline-Pool in values.

Attribute: weights, values

Warum: Jedes Gewicht beeinflusst den entsprechenden values-Eintrag und hat ohne diesen Pool keine Bedeutung.

<element name="tier" values="'standard','premium'" weights="3,1"/>

<element name="tier" type="string" weights="3,1"/>

unique erfordert einen Inline-Pool in values.

Attribute: unique, values

Warum: Feldeindeutigkeit zieht ohne Zurücklegen aus expliziten Werten; Generatoren stellen hier keinen endlichen Pool bereit.

<element name="code" values="'A','B'" unique="true"/>

<element name="code" generator="IncrementGenerator" unique="true"/>

unique darf nicht mit weights kombiniert werden.

Attribute: unique, weights

Warum: Unique-Auswahl zieht gleichverteilt ohne Zurücklegen; Gewichte beschreiben verzerrte Ziehungen mit Zurücklegen.

<element name="code" values="'A','B'" unique="true"/>

<element name="code" values="'A','B'" weights="1,2" unique="true"/>

Optionen zum Quellenlesen erfordern source.

Attribute: source, selector, separator

Warum: selector, separator und weitere Quellenoptionen verändern ausschließlich einen Quellenzugriff.

<element name="status" source="data/status.ent.csv" separator=","/>

<element name="status" type="string" separator=","/>

Eine Feld-distribution erfordert einen int- oder float-Wertebereich.

Attribute: distribution, type, min, max

Warum: Die Distribution auf Feldebene formt ein numerisches Raster und ist nicht die Verteilung von Quelldatensätzen.

<element name="score" type="int" min="1" max="10" distribution="step"/>

<element name="score" type="string" min="1" max="10" distribution="step"/>

outDateFormat erzeugt einen String und lehnt einen anderen type ab.

Attribute: outDateFormat, type

Warum: Formatierung ist der letzte Darstellungsschritt; nachgelagerte Ausdrücke erhalten nicht mehr den rohen Zeitwert.

<element name="created" constant="2026-01-02" outDateFormat="%d.%m.%Y"/>

<element name="created" type="int" constant="2026-01-02" outDateFormat="%d.%m.%Y"/>

Die Granularität eines Integer-Felds muss ganzzahlig sein.

Attribute: type, granularity

Warum: Ein Bruchschritt kann ohne stille Kürzung kein Integer-Raster erzeugen.

<element name="score" type="int" granularity="2"/>

<element name="score" type="int" granularity="0.5"/>

defaultValue erfordert script.

Attribute: defaultValue, script

Warum: Der Fallback wird nur ausgewertet, wenn der Skriptwert fehlt oder seine condition die Erzeugung unterdrückt.

<element name="nickname" script="None" defaultValue="'unknown'"/>

<element name="nickname" constant="unknown" defaultValue="'fallback'"/>

nullQuota muss zwischen 0 und 1 liegen.

Attribute: nullQuota

Warum: Der Wert ist eine Wahrscheinlichkeit: 0 erzeugt nie null, 1 erzeugt immer null.

<element name="middle_name" type="string" nullQuota="0.5"/>

<element name="middle_name" type="string" nullQuota="1.1"/>

Erlaubte Elternelemente / Erlaubte Kindelemente

Erlaubte Elternelemente: else, else-if, id, if, item, key, nestedKey, while

Erlaubte Kindelemente:

Keine

Attribute

Alle 29 Attribute anzeigen

condition

Condition for element data generation.

optional; string; Standardwert: null.

constant

Constant value for element data.

optional; string; Standardwert: null.

converter

Converter for element data transformation.

optional; string; Standardwert: null.

database

Database client id when source equals 'database'.

optional; string; Standardwert: null.

defaultValue

Default value for the element.

optional; string; Standardwert: null.

distribution

Sampling distribution / sequence for ranged numeric element.

optional; string; Standardwert: null; Werte: uniform, cumulated, step, increment, randomWalk, shuffle, wedge, bitreverse, fibonacci, padovan.

generator

Predefined generators for element data generation.

optional; string; Standardwert: null.

granularity

Step width of numeric grid; defaults 1 for int, 0.1 for float. On int, must be whole.

optional; string; Standardwert: null.

inDateFormat

Input date format for element data.

optional; string; Standardwert: null.

max

Maximum value for numerical generator.

optional; number; Standardwert: null.

maxLength

Maximum length for binary payload generation.

optional; integer; Standardwert: null.

mimeType

Optional MIME signature for binary payload generation.

optional; string; Standardwert: null.

min

Minimum value for numerical generator.

optional; number; Standardwert: null.

minLength

Minimum length for binary payload generation.

optional; integer; Standardwert: null.

name

Name of the element.

erforderlich; string.

nullQuota

Null quota for element data generation.

optional; number; Standardwert: null.

outDateFormat

Output date format for element data.

optional; string; Standardwert: null.

pattern

Pattern for element data generation.

optional; string; Standardwert: null.

script

Script for element data generation.

optional; string; Standardwert: null.

selector

Selector for element data generation.

optional; string; Standardwert: null.

separator

Separator for element data.

optional; string; Standardwert: null.

source

Source of data for the element.

optional; string; Standardwert: null.

string

String for the variable data generation.

optional; string; Standardwert: null.

type

Data type of the element.

optional; string; Standardwert: null; Werte: string, int, integer, float, bool, binary.

unique

Emit each value at most once (distinct picks from values, no replacement).

optional; boolean; Standardwert: null.

values

Comma-separated list of values for the element.

optional; string; Standardwert: null.

variablePrefix

Prefix before field's name for string in element generation.

optional; string; Standardwert: null.

variableSuffix

Suffix after field's name for string in element generation.

optional; string; Standardwert: null.

weights

Comma-separated relative weights, one per values entry, for weighted random selection.

optional; string; Standardwert: null.