Name building
Define how attributes are rendered in the backoffice
Name building improves readability and helps identify values in complex attributes and written results from concatenate business-rule actions. Clear, consistent names help users recognise records and understand their key values quickly. An effective setup keeps the backoffice user-friendly and simplifies rule maintenance.
Render pattern in backoffice
When it backoffice you can configure the render pattern of values on a complex attribute. If we navigate to a global list "Brand" we can select the attributes we want to be rendered along with their pattern.
Afterwards, when selecting one of the values from the global list on a product, the value is displayed using the defined render pattern. In this example, Name, Phone, and Email are rendered according to the pattern.
If {2} (Email) is empty, the static text before {2} is removed automatically.
However, if {1} (Phone) is empty, the static text between {0} (Name) and {1} is not removed because {1} is positioned after the text that should be removed.
To remove static text in this situation, * can be added after the static text before the attribute, for example Phone:*{1}. This makes the static text conditional on the preceding attribute {0} having a value. So if {0} (Name) is empty then the " - Phone:" static text is removed.
Render patterns
Render patterns define how selected attributes are combined and rendered when building a name.
A render pattern consists of one or more attribute placeholders and optional static text. Placeholders refer to selected attributes by their position.
For example, if Name and SKU are selected:
Here the value will be rendered as:
Placeholders
Use {n} to add a selected attribute to the rendered name. n corresponds to the position of the attribute in the selected attributes.
For example:
Name, SKU
{0}-{1}
Product A-12345
Name, SKU
Name:{0} SKU:{1}
Name:Product A SKU:12345
Name, SKU, Colour
{0} - {1} - {2}
Product A - 12345 - Blue
The position of each placeholder corresponds to the order of the selected attributes. {0} refers to the first attribute, {1} to the second attribute, and so on.
Static text
Static text can be added to a pattern in addition to attribute placeholders.
For example:
With Name set to Product A and SKU set to 12345, the result is:
Static text is rendered as defined and can be used to add labels, separators, or other formatting.
Conditional static text
The * can be used when static text should be removed if the previous optional value is missing. This is useful when several optional attributes are combined into one readable value.
For example, a product could contain a Brand, Model, and Size:
When all values are available:
If the Model {1} is missing, the text following it is still rendered because the Size {2} has a value
If the intention is that the Size should only be shown when the Model is available, * can be added after the static text:
Now, when {1} is missing, the static text between {1} and {2} is removed:
This allows the render pattern to control which static text is displayed when values are missing.
Conditional rendering
Use [? ... ] to make part of a pattern conditional.
A conditional section is rendered only when its referenced attribute has a value. This allows labels and other static text to be included only when the corresponding value is available.
For example:
When Name and SKU are set, the result is:
When Name is empty, the conditional section is not rendered:
Conditional rendering is useful when several pieces of static text belong together and should only be rendered when a particular attribute is available.
Examples
Simple separator
Result:
Labeled values
Result:
Conditional static text
Result when SKU is present:
Result when SKU is empty:
Conditional section
Result when Name is present:
Result when Name is empty:
Last updated