Patterns

Patterns are dot-notated paths used throughout Alumio to navigate and select data within an entity. Several features use pattern fields, but their behavior differs per context.

​

Pattern syntax

​

Pattern types by feature

​

Pattern accessor

Accesses one or more values from entity data. Use * to match all array items. Example: products.*.sku returns the sku of every product. View documentation

---

​

Copy / Move using a pattern

Copies or moves data from one location to another. Each * in the source pattern becomes a numbered capture group ($1, $2, …) that can be referenced in the replacement. Example:

• Pattern: products.*.name
• Replacement: product_names.$1

View documentation for Copy | View documentation for Move

---

​

Get branches from a pattern

Splits one entity into multiple branches based on an array in the data. The pattern must include * — each element matching * becomes its own branch. Example: products.* creates one branch per product. View documentation

---

​

Pattern to items (stream deserializers)

Points to the array within the data that contains the items to process. This field does not require * — it points to the array itself, and the system automatically iterates over all elements. Example: data.products reads items from {"data": {"products": [...]}} Used in: JSON, XML, YAML, Form URL encoded

---

​

Key difference: * required vs. not required

​

Placeholders

Placeholders (&{...}) are a separate feature that inserts dynamic values from entity data into strings. They are different from patterns and work across most text fields. Example: &{product.name} is replaced by the actual product name at runtime. View placeholder documentation