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.
| Wildcard | Produced 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.
| Wildcard | Produced 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.
| Operation | Description |
|---|---|
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'. |
aspect | Replaces 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'. |
asjsonarray | Turns 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"]'. |
capitalize | Puts 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'. |
escape | Escapes 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'. |
gql | Escapes 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')". |
htmlencode | Escapes the special characters for HTML. Usage: ${core.name | htmlencode}If core.name = 'Tom & Jerry', the result is Tom & 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 …'. |
lowercase | Puts 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'. |
uppercase | Puts every character in uppercase. Usage: ${standard.authors[0] | uppercase}If standard.authors[0] = 'Alice', the result is 'ALICE'. |
urlencode | Escapes the special characters for a URL. Usage: ${core.name | urlencode}If core.name = 'annual report', the result is 'annual%20report'. |