Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

With this post function you can This post function lets you copy an excerpt of a specific field by defining a leading and trailing delimiter. For this, either normal text or a regular expression can be used.


Configuration

UI Expand
titleSource field

Select the field to get the value will be copied or extracted from (e.g., summary, assignee).


UI Expand
titleTarget field

Select the field the value will be copied to (e.g., new comment, reporter).


pipe
UI Expand
titleExcerpt configuration

Leading delimiter

Choose The value that will be extracted is enclosed by a leading and a trailing delimiter. You first have to define the type of the leading delimiter you will enter next. The following options are available:

OptionDescription

Text (case sensitive)

Specify the text that will serve as the leading delimiter. The text found by JWT must exactly match the delimiter (case sensitive).

Text (ignoring case)

Choose this option if JWT should ignore the case.

Regular expression (case sensitive)

Define a regular expression as the leading delimiter, respecting the case.

Regular expression (ignoring case sensitive)

Expression

Enter plain text and optionally use field codes to insert field values. This will be the actual delimiter to be searched for.

Excerpt pattern

Choose this option if JWT should ignore the case.

Expression

Once you have specified how JWT should identify the delimiter, you now have to specify the exact value. Dynamic patterns can be created through insertion of field codes that will be replaced with the corresponding field values.

Trailing delimiter

The options and the handling are identical to the leading delimiter configuration.

UI Text Box
typetip

Delimiters specify the boundaries in which JWT extracts a value matching the given pattern. The pattern must follow directly after the leading delimiter.

Specifying delimiters is optional. If you want to search for a pattern in the entire field value leave the delimiters empty.

Delimiter examples

TextOptionLeading delimiterTrailing delimiterOutput

Hey [~a.grant],

could you please have a look on CRM-8?

Thank you!


Tom

(E-mail: t.harris@company.com)




Text (case sensitive)[~]a.grant
Text (ignoring case)e-mail:) t.harris@company.com
Regular expression (case sensitive)([A-Z]{3}-)\?8
Regular expression (case insensitive)([a-z]{3}-)\?8




Excerpt pattern

Select which pattern (e.g combination of numbers or text values) will be searched for between the delimitersSelect how the value between the delimiters should be processed. The following options are available:

OptionDescription

None (copy whole text between the delimiters)

Select this option if you  want to copy the entire text found between the delimiters.

Number

When you select this option, a regular expression will be constructed for you in the background. This expression will match the vast majority of possible values, but there might be valid values that don't match these regular expressions

UI Text Box
typetip

If you want to be sure to definitely include all values, please select "None (copy whole text between the delimiters)" or specify your own regular expression by selection one of the regular expression options.


URL

Same as above.

Email

Same as above.

Date and time

Specify a valid date-time pattern. Additional information about date-time patterns can be found here.

Regular expression (case sensitive)

Specify the pattern to be copied by defining a regular expression respecting the case.

Regular expression (ignoring case)

Specify the the pattern to be copied by defining a regular expression ignoring the case.


UI Text Box
typetip

When selecting one of the Regular regular expression options, you will be able to enter a regular expression to further process the matched text.

Multiple pattern

matching

matches

Unless you choose to copy the entire text between the delimiters, you have to select Select which value should be processed in case of multiple pattern matching occurrences of the specified pattern (e.g. multiple email addresses). The following options are available:

OptionDescription
FirstThe first occurrence of the matched pattern in the source field will be copied.
LastThe last occurrence of the matched pattern in the source field will be copied.
All

Trailing delimiter

Choose the type of delimiter to be drawn along. The available options are the same as
Table of Contents
include(Leading delimiter).*
typeflat
separator
All occurrences of the matched pattern in the source field will be copied. Values are returned as a comma separated list of values



UI Expand
titleAdditional options

You have the following options:

OptionDescription
Update issue immediately

Each field update results in a dedicated "Issue Updated" event and issue history entry

Include Page
DECADIS:_snip_update_immediately
DECADIS:_snip_update_immediately

Write protection

Include Page
DECADIS:_snip_write_protection
DECADIS:_snip_write_protection

Include leading delimiter

If checked, the specified leading delimiter will be included in the output.

Include trailing delimiter

If checked, the specified trailing delimiter will be included in the output.

Write protection

Do not overwrite existing values

Include leading delimiter

Include it to the output

Include trailing delimiterInclude it to the output



UI Expand
iconfalse
titleConditional execution

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server


UI Expand
iconfalse
titleRun as

Include Page
DECADIS:_snip_runAs_Server_postFunction
DECADIS:_snip_runAs_Server_postFunction



Use 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
todo
colourGreen
titledone
 

Style guide

Status
colourYellowGreen
titleReady for reviewdone

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


Page properties
hiddentrue


Short descriptionCopy an excerpt of an issue field using leading and trailing delimiters.
Label