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

Compare with Current View Page History

« Previous Version 11 Next »

On this page

Throughout the documentation we refer to data types that can be used in the expression parser and its functions.

Data types define what kind of data a function needs as input and what you should expect as output.


The most common data types

Data typeDescriptionExample

TEXT

This type represents any kind of text or character string including all kinds of select and multi-select fields MULTI

Any field type or data type is susceptible of being transformed to text, so any field can be referenced as a text-string value using the following notation: %{...anyfield}, and %{...anyfield.i} for Cascading Select or Multi-Cascading Select fields, where i is the index that represents the level to be accessed. (i = 0 is used for base level).

"Hello world"

NUMBER

This type represents numeric values, and is also used to store Date, Time and Date-Time (DATE_TIME) values. When storing any temporal value, the number represents the milliseconds elapsed since January 1, 1970, 00:00:00 GMT.

Pro tip...

Number or Date-Time fields can be referenced as numbers using the following notation: {...somefield}

1, 1.1, -1.1, .1, -.1

LIST

  • Number/Text list: This type represents a collection of numeric/text values returned by various functions. The size may vary from 0 to any number of numeric/text values. It is used to read the value of a numeric/text field in a selection of issues.
  • Issue list: This type represents a collection of issues. The size may vary from 0 to any number of issues. It is returned by issue selection of filtering functions.
  • Number/text: fieldValue(), append(), union(), except(), intersect() and distinct()(for both numeric and text values), [1, 2, 3]/["string_A", "string_B", "string_C"]
  • Issue list: subtasks(), linkedIssues(), transitionLinkedIssues(), filterByFieldValue(), filterByStatus(), filterByIssueType(), filterByResolution(), filterByProject(), append(), union(), except(), intersect() and distinct()

BOOLEAN

Comparison operators return a logical value true or false. isActive(text user_name)

Additional data types

You will find many data type references throughout the documentation that need to be explained in more detail. They all related to one of the categories above.

Text
Data typeDescriptionExample






Number
Data typeDescriptionExample






List
Data typeDescriptionExample






Casting (converting) data types


Casting (or transforming) data types is very important throughout all functions provided by JWT.

To be able to set, transform or calculate values it might be necessary to turn a text value to a number, a number or a timestamp to a text, and even individual text or number values to a list.

The following functions will help you to achieve that.

Available functions