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).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

This post function lets you copy an excerpt of a specific field.


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.

Source field*

Info
iconfalse

Select the field to get the value from (e.g., summary, assignee).

Target field*

Info
iconfalse

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

Excerpt configuration*

Leading delimiter*

Source field

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


UI Expand
titleTarget field

Select the field the value will be copied to.


UI Expand
titleExcerpt 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.

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
Info
iconfalse

Choose the type of the delimiter for the plain text you will enter next. The following options are available:

  • Text (case sensitive)
  • Text (ignoring case)
    Regular expression (case sensitive)([A-Z]{3}-)\?8
    Regular expression (
    ignoring
    case insensitive)

    Expression

    Info
    iconfalse

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

    Excerpt pattern*

    ([a-z]{3}-)\?8




    Excerpt pattern

    Select which pattern (e.g combination of numbers or text values) will be searched for between the delimiters

    Info
    iconfalse
    Select 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)

    Regular expression*

    Info
    iconfalse

    Enter plain text and optionally use field codes to insert field values. The expression must be a valid regular expression.

    Multiple pattern matching*

    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 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

    Info
    iconfalse

    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:

    First
    Option
    Last
    Description
  • All
  • Trailing delimiter*

    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.
    AllAll occurrences of the matched pattern in the source field will be copied. Values are returned as a comma separated list of values
    Info
    iconfalse

    Choose the type of delimiter to be drawn along. The following options are available:

  • Text (case sensitive)
  • Text (ignoring case)
  • Regular expression (case sensitive)
  • Regular expression (ignoring case)



    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
    immediately

    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 delimiter - Include it to the output



    The post function will only be executed if the condition is met (returns true).

    UI Expand
    iconfalse
    titleConditional execution

    Include Page
    DECADIS:_snip_condExecution_Server
    DECADIS:_snip_condExecution_Server

    Enter a condition (Logical / boolean condition) using the JWT expression parser - full feature list syntax.

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

    Note


    Choose which user* will be used to execute this post function. By default it is set to the Current user.
    UI Expand
    iconfalse
    titleRun as

    Include Page
    DECADIS:_snip_runAs_Server_postFunction
    DECADIS:_snip_runAs_Server_postFunction



    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 descriptionCopy an excerpt of an issue field using leading and trailing delimiters.
    Label