Value Reference Modifiers

Overview

Value reference modifiers allow the transformation of the text value returned by a value reference. The available modifiers are

1 wiki-link
2 fullname

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

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

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}