You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 23 Next »

This post function lets you copy an excerpt of a specific field by defining a leading and trailing delimiter.

Configuration

Source field

Select the field the value will be copied or extracted from.

Target field

Select the field the value will be copied to.

Excerpt configuration

Leading delimiter

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:

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 (case sensitive)

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.

Examples

TextOptionLeading delimiterTrailing delimiterOutput
As a developer, I can update story and task status with drag and drop (click the triangle at far left of this story to show sub-tasks)Text (case sensitive)As a developer, )I can update story and task status with drag and drop (click the triangle at far left of this story to show sub-tasks
As a developer, I can update story and task status with drag and drop (click the triangle at far left of this story to show sub-tasks)Text (ignoring case)AS A DEVELOPER, )I can update story and task status with drag and drop (click the triangle at far left of this story to show sub-tasks
As a developer, I can update story and task status with drag and drop (click the triangle at far left of this story to show sub-tasks)Regular expression (case sensitive)tbdtbd
As a developer, I can update story and task status with drag and drop (click the triangle at far left of this story to show sub-tasks)Regular expression (case sensitive)








Excerpt pattern

Select which pattern will be searched for between the delimiters. The following options are available:

OptionDescription

None (copy whole text between the delimiters)

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

Number

Number, URL and email formats are filtered by regular expressions that match the vast majority of possible values, but there might be valid values that don't match these regular expressions.

If avoiding any undesired value rejection is a priority "None" should be selected.

URL


Email


Date and time

Specify a valid date-time pattern.

Regular expression (case sensitive)

Specify the delimiter by defining a regular expression respecting the case.

Regular expression (ignoring case)

Specify the delimiter by defining a regular expression ignoring the case.

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

Multiple pattern matches

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

  • First

  • Last

  • All

Additional options

You have the following options:

OptionDescription
Update issue immediately

Choose to update issues immediately if you want Jira to fire a separate "Issue updated" event for any field change.  This will also result in a dedicated issue history entry.

Write protection

Check the write protection option if you want to prevent a field to be updated, if it already has a value. If checked, only empty fields will be set.

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.

Conditional execution

You can optionally specify a logical expression to define the circumstances (or conditions) under which the post function should be executed.

The result of the logical expression must return a boolean value of either:

  • true → the post function will be executed
  • false → the post function will not be executed

Using the conditional operator, even complex or multi-layered conditions can be constructed.

Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode

Run as

Unable to render {include} The included page could not be found.


Use cases and examples


If you still have questions, feel free to refer to our support team.