Expressions

Here, you’ll find a description of all operators, functions, and attributes that can be used in code expresions within Pertuniti.

This description covers all operators, functions, and attributes of objects that are available in expressions within document templates. You may often need the descriptions of functions and object attributes. Are clear overview of the actual creation of document templates is available here!

Literals

Literals are strings that directly represent fixed values in expressions, e.g. integers. Literals can be combined (with variables) using operators. Also, they can be applied as arguments of functions.

For strings, you do not need to escape the respective other quotation mark. Non-string-literals are case-insensitive, i.e. false = FALSE = FaLsE.

Operators

Functions

• now() Date

  Current date (as java.util.Date)

• attr( Object , Attribute ) String | Date | Contact (Value)

  If the passed Object contains flexible attributes (e.g. case, event, task, document): Access to attribute Attribute

• int( String or number ) Integer

  Parse string or cast to integer

• float( String or number ) Double

  Parse string or parse to floating value (Double)
  Attention: The expression language does not distinguish single or double precision floating values. Floating values (both types) are represented by the typical double type of a JVM.

• str( String or object ) String

  Cast or format to string, or call toString() of the passed object.

• len( String or array or list ) Integer

  Length of the string, array, or list

• dateformat( Date , format ) String

  Formatted representation of a date. Format expression according to https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

• get( Collection<T> , Position ) T

  Return the element at the position Position of the collection Collection (list, array)

• sort( Collection<T> , Sort attributes... ) List<T>

  Sort a collection (list, set). Without any sort attribute, the values or their string representations are compared (ascending). Sort attributes are applied by their order until they differ. Sort attributes can be applied ascending ("+attribut", "attribut") or descending ("-attribut"), and this mode may differ between attributes.

• format( format , arguments... ) String

  Formatting text, e.g. floating point precision, dates, ... similar to printf. The function format_US applies a comma as decimal separator and a point for indicating the decimal place. The function format_DE switches those, i.e. a dot as decimal separator and a comma for the decimal place ("Gleitkommazahl"). The function format is an alias for format_US. Formatting is interpreted according to https://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html.

• contact( roles... ) Contact

  Retrieve first contact of the current case matching any passed role. The selection is performed according to the order of passed roles. If no contact with any of these roles is present in the case, the result is null. If more than one contact matches for the same role, the selection is random.

• contacts_all() Contact[]

  contacts_all( roles... ) Contact[]

  Retrieve all contacts of the current case matching at least one passed role. Without an argument, all contacts of the current case are emitted. Contacts matching more than one role are returned only once. If no contact can be matched, the result is an array of length 0.

• address( Contact ) Adresse

  address( Contact , Preferences... ) Adresse

  If present, an address of the passed contact. The selection is performed according to the order of passed preferences. For example: address(recipient, 'WORK', 'HOME') first checks addresses with the label WORK. If there is none, it checks addresses labeled with HOME. If no prefernence yields any address, the function just returns the first address stored within a contact.

• email( Contact ) String

  email( Contact , Preferences... ) String

  If present, an email address of the passed contact. The selection is performed according to the order of passed preferences.

• fax( Contact ) Phone

  fax( Contact , Preferences... ) Phone

  If present, a phone number of type Private Fax, Work Fax, Other Fax. The selection is performed according to the order of passed preferences.

• phone( Contact ) Phone

  phone( Contact , Preferences... ) Phone

  If present, a phone number of type Mobile, iPhone, Private, Work, Headquarters. The selection is performed according to the order of passed preferences.

• just_mobile( Contact ) Phone

  just_mobile( Contact , Preferences... ) Phone

  If present, a phone number of type Mobile or iPhone. The selection is performed according to the order of passed preferences.

Available Attributes

Our security model restricts access to attributes of objects that were not explicitly released. The following tables determine the configured object types and currently available attributes.

Currently, we only added attributes to the security model that were actually necessary for templates. If you need further access to attributes that are captured within the application but not available in the respective table, contact johannes.tenschert@pertuniti.de.

Generally, expressions can only access information that the performing user has access to, i.e. document templates adhere to the rights management of your cases.

Case

Contact

Address

Phone

Task

TaskStatus