Value Reference Modifiers
Overview
Value reference modifiers allow the transformation of the text value returned by a value reference. The available modifiers are
The transformation of the displayed value is done by appending the modifier at the end of the value reference using the “ > “ separator
@value_reference > modifier@
These modifiers are built into Comala Document Management v5.6 and later.
Supplier References from the Reporting app use a similar format and offer many more options for data manipulation.
wiki-link
Transforms the value returned by attribute and event references whose return type are one or more usernames, so that usernames are displayed as Confluence profile links using wiki markup. Useful for including in workflows actions macros the process wiki markup for their content like send-email.
Examples
Value Reference | Result | Value Reference + Modifier | Result |
|---|---|---|---|
@assignee@ | <username> | @assignee > wiki-link@ | [~<username>] |
@Approval_ Name > approvers@ | <username1>, <username2> | @Approval_ Name > approvers>wiki-link@ | [~<username1>], [~<username2>] |
@taskassignee@ | <username> | @taskassignee> wiki-link@ | [~<username>] |
fullname
Transforms the value returned by attribute and event references whose return type is one or more usernames, so that the full name of the user is displayed.
Useful for including in workflows actions macros the process wiki markup for their content like send-email.
Examples
Value Reference | Result | Value Reference + Modifier | Result |
|---|---|---|---|
@approvaluser@ | <username> | @approvaluser > fullname@ | <fullname> |
Usage
{workflow:name=Simple approval workflow|key=com.comalatech.sample.approvals.01}
{description}
Simple approvals workflow with two states using wiki-link modifier.
{description}
{pageheader}
|| Approved By |{get-metadata:approvedby}|
{pageheader}
{state:Draft|approved=Approved|taskable=true}
{approval:Review|assignable=true}
{state}
{state:Approved|final=true|updated=Draft|hideselection=true}
{state}
{trigger:pageapproved|approval=Review}
{set-metadata:approvedby}@Review>approvers>wiki-link@{set-metadata}
{trigger}
{workflow}