Skip to main content
Version: Any 26

Wildcards and operations

A wildcard is a value Any replaces at run time: ${core.name} produces the name of the processed content, ${TODAY} the current date. Everything around the wildcards is kept as is.

The same syntax is used everywhere a text has to be built from data: the metadata composers, the URL and the body of the REST calls, the notifications, the smart URLs. The available wildcards, however, depend on the context: a content composer offers the metadata of the content, a synchronization composer only the metadata present in the received message.

In the fields that accept wildcards, typing ctrl + space after a character shows the assistance and lists the wildcards actually available at that spot.

Insert a value​

To insert a metadata, note it as ${aspect.metadata}:

${core.name}
${standard.title}

To insert a specific element of a multi-valued metadata, index it from 0:

${standard.authors[0]}

Content-independent wildcards​

Beyond the metadata, the assistance offers wildcards that do not depend on the processed content.

WildcardProduced value
${TODAY}Date and time of the moment the value is produced. It is a date: format it with format.
${LOCALE}Language of the current context.
${APPLICATION}Name of the application of the current context.
${PUBLIC_APPLICATION_URL}Public URL of the server, as defined in the server settings.
${TICKET}Authentication ticket for the current user, single-use and with a default lifetime. Both can be changed: ${TICKET(multi, 2 hours)} produces a reusable ticket valid for two hours.
${COUNTER}Sequence number. Available only in the metadata composers, which define the counter.

Current user​

The user who triggers the processing is described by a family of wildcards.

WildcardProduced value
${user.name}Displayed name of the user.
${user.login}Sign-in identifier.
${user.email}Email address.
${user.first_name}First name.
${user.last_name}Last name.
${user.phone_number}Phone number.
${user.groups}Groups of the user, as multiple values.

Any other metadata of the user record is reachable the same way, under ${user.<metadata>}.

Transform the value​

Inside a wildcard, the value can be transformed by one or several operations, chained with the | character and applied from left to right:

${data | operation1 | operation2 | ...}
${core.creation_date | format('yyyy') | lowercase}
${standard.authors[0] | uppercase}
${COUNTER | format('00000')}

The operations offered by the assistance depend on the type of the data: time, format, add and minus on a date or a number, concat on a multi-valued metadata, the others on text. Applied to a multi-valued metadata, a text operation applies to each value.

OperationDescription
add(count, 'field')Adds count to the value. On a number, the addition is direct. On a date, count is added to the given field: year, month, day, hour, minute or second.

Usage: ${core.creation_date | add(3, 'year')}
If core.creation_date = '2026-07-23', the result is '2029-07-23'.
aspectReplaces the value with its label, through the data list mapping configured on the metadata in the Aspects module.

Usage: ${extended.category | aspect}
If extended.category = 'INV' and the list associates this code with the label "Invoice", the result is 'Invoice'.
asjsonarrayTurns a multi-valued metadata into a JSON array. A single value is returned as is.

Usage: ${standard.authors | asjsonarray}
If standard.authors = ['Alice', 'Bob'], the result is '["Alice","Bob"]'.
capitalizePuts the value in lowercase, then puts its first letter in uppercase.

Usage: ${standard.title | capitalize}
If standard.title = 'ANNUAL REPORT', the result is 'Annual report'.
concat(separator[, first[, last]])Concatenates the values of a list, separated by separator. first and last, if provided, wrap the non-empty result.

Usage: ${standard.authors | concat(', ')}
If standard.authors = ['Alice', 'Bob'], the result is 'Alice, Bob'.
default('value'[, translate])Returns value when the value is empty. With true as a second argument, value is treated as a translation key.

Usage: ${extended.zone | default('N/A')}
If extended.zone is empty, the result is 'N/A'.
escapeEscapes the special characters for a GQL query: the single quotes are doubled.

Usage: ${core.name | escape}
If core.name = "O'Brien", the result is "O''Brien".
format(pattern[, pattern2])Formats a date or a number. For a number, filesize produces a readable size; for a date, ISO-8601 or a SHORT, MEDIUM, LONG, FULL style are accepted.

Usage: ${core.creation_date | format('dd/MM/yyyy')}
If core.creation_date = '2026-07-23', the result is '23/07/2026'.
get(index)Returns the element at position index (from 0) of a multi-valued metadata.

Usage: ${standard.authors | get(0)}
If standard.authors = ['Alice', 'Bob'], the result is 'Alice'.
gqlEscapes the single quotes and joins a list with ',', to insert it in an IN clause of a GQL query.

Usage: core.name IN ('${standard.authors | gql}')
If standard.authors = ['Alice', "O'Brien"], the result is "core.name IN ('Alice','O''Brien')".
htmlencodeEscapes the special characters for HTML.

Usage: ${core.name | htmlencode}
If core.name = 'Tom & Jerry', the result is Tom &amp; Jerry.
limit(max[, 'ellipsis'])Truncates the value: on a text, to the first max characters; on a list, to the first max elements. The ellipsis (... by default) is only added if the value was actually truncated.

Usage: ${core.name | limit(20, '…')}
If core.name = 'Consolidated annual report 2026', the result is 'Consolidated annual …'.
lowercasePuts every character in lowercase.

Usage: ${core.name | lowercase}
If core.name = 'REPORT', the result is 'report'.
mapping(datalist, key_col, label_col)Replaces the value with the matching label in a data list, designated by its name, its key column and its label column.

Usage: ${extended.country | mapping('countries', 'code', 'label')}
If extended.country = 'FR', the result is 'France'.
minus(count, 'field')Same as add, but subtracts.

Usage: ${core.creation_date | minus(1, 'month')}
If core.creation_date = '2026-07-23', the result is '2026-06-23'.
regexp('pattern', 'replacement')Replaces every occurrence matching the regular expression pattern.

Usage: ${core.name | regexp('\\d+', '#')}
If core.name = 'Invoice 2026', the result is 'Invoice #'.
replace('search', 'replacement')Replaces every occurrence of the text search, taken literally: unlike regexp, it is not a regular expression.

Usage: ${core.name | replace('_', ' ')}
If core.name = 'annual_report', the result is 'annual report'.
replaceall('pattern', 'replacement')Replaces every occurrence matching the regular expression pattern. Equivalent to regexp.

Usage: ${core.name | replaceall('\\s+', '_')}
If core.name = 'annual report', the result is 'annual_report'.
replacefirst('pattern', 'replacement')Replaces the first occurrence matching the regular expression pattern.

Usage: ${core.name | replacefirst('-.*', '')}
If core.name = 'FR-2026-001', the result is 'FR'.
time(HH:mm:ss)Sets the time of a date without changing the day.

Usage: ${core.creation_date | time(00:00:00)}
If core.creation_date = '2026-07-23 14:30:00', the result is '2026-07-23 00:00:00'.
translate([prefix])Treats the value as a translation key and returns the translated label. The prefix, if provided, is prepended to the value to form the key. Without a translation, the value is returned as is.

Usage: ${extended.status | translate}
If extended.status = 'validated' and the translation of this key is "Validated", the result is 'Validated'.
uppercasePuts every character in uppercase.

Usage: ${standard.authors[0] | uppercase}
If standard.authors[0] = 'Alice', the result is 'ALICE'.
urlencodeEscapes the special characters for a URL.

Usage: ${core.name | urlencode}
If core.name = 'annual report', the result is 'annual%20report'.