Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

On this page

Table of Contents
exclude(On this page|Filter by field value|Expression*).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

The Format field value This post function gives format to formats the current value of a text field using a set of formatting operations, such as trimming whitespaces or performing a search and replace.


Image AddedConfiguration


ui-text-boxexpand
typetitlenote

In this documentation and the post function configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration of the function.

Field*

Info
iconfalse

Select the field to be formatted.

White space mode

Field
Select the field to be formatted. Available field types are text, versions, labels, select list, radio button, multi-select list and cascading select list.
UI Expand
titleWhite space mode

Select whether to edit blanks (or whitespaces)

Info
iconfalse

Select an operation to edit blanks. The following options are available (multiple choice is possible):

  • Remove all leading white spacespaces
  • Remove all trailing white spacespaces
  • Leave only one white space between words
  • Remove all white spaces in the text


UI Expand
titleCase mode
*
Info
iconfalse

Select whether to edit cases. The following options are available:

  • Do nothing
  • Convert all the characters to lower case
  • Convert all the characters to upper case
  • Capitalize all the whitespace-white space separated words


Choose between the following options:
UI Expand
titleFind and replace

Define whether you want to find and replace parts of the text.

You first have to define the fragments that you want to replace and afterwards specify the replacement. Both parameters can be specified using an expression in Basic text mode.

Find mode

OptionDescription

Do nothing

No text search and replacement will be performed.
UI Expand
titleFind mode

Text (case sensitive)

The text to be replaced must exactly match, respecting the case. 
Text (ignoring case)The text to be replaced must match but the case will be ignored.
Regular expression (case sensitive)Specify the text to be replaced by a regular expression, respecting the case.
Regular expression (ignoring case)

Expression*

Info
iconfalse

Enter plain text and optionally use field codes to insert field values.

UI Text Box
typetip

You can try your expression by clicking on the play button on the top right of the expression box.

UI Expand
titleReplace mode

Choose between the following two options:

  • Replace first occurrence
  • Replace all occurrences

Expression*

Specify the text to be replaced by a regular expression, ignoring the case.

Replace mode

OptionDescription

Replace first occurrence

Only the first occurrence of the text will be replaced.
Replace all occurrencesAll occurrences of the text will be replaced
Info
iconfalse

Enter plain text and optionally use field codes to insert field values.

UI Text Box
typetip
You can try your expression by clicking on the play button on the top right of the expression box
.



UI Expand
titleAdditional options

Include Page
DECADIS:_snip_update_immediately
DECADIS:_snip_update_immediately
You have the option to Update issues immediately (each field update results in a dedicated "Issue Updated" event and issue history entry).


Enter a condition (Logical / boolean condition) using the JWT expression parser functions syntax.

You can even logically link and gather conditions in expressions as you like in order to map more complex conditions.

The post function will only be executed if the condition is met (returns true).
UI Expand
iconfalse
titleConditional execution
UI Text Box
typenote

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and parent = currentContent()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged


Page properties
hiddentrue


Short descriptionFormat a field containing text.
Label