Versions Compared

Key

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

Table of Contents


English
Panel
borderColorpurple
bgColorwhite
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

This is a new feature in Joget DX 8.

Introduction

The Property Assistant is a new feature in Joget DX 8, that allows you to insert Hash Variables, Regular Expressions and URLs in any form element, UI element or list.

...

Figure 1: Property Assistant Icon in a Form Element Configuration Screen


Hash Variable

The Property Assistant allows you to choose a hash variable's attributes from a select box (Figure 2). This also applies to URLs (Figure 3). 

Figure 2: Property Assistant - Hash Variable Attributes SelectionImage Removed

Figure 3: Property Assistant - URL Attributes Selection

You can also insert Nested Hash Variables easily using the Property Assistant by clicking on the desired attribute that will include the nested variable and then clicking back on the variable list to choose a variable to insert. (See Figure 43)

Figure 43: Property Assistant - Nested Hash Variable

If you choose to show the optional chunks of Hash Variables or URLs, you can edit the App ID (Figure 53) and Escape Mode (Figure 65) (and even a Record's primary key depending on the hash variable used). 

Figure 54: Property Assistant - Optional Chunks - App ID

Figure 65: Property Assistant - Optional Chunks - Escape Mode

URLs

URLs in the property assistant refer to UI Menu URLs. This provides an easy way to access specific menus through the property assistant. 

Image Added

Figure 6: Property Assistant - URL Attributes Selection

There are currently 2 UI Menu URLs to choose from seen in the table below.

NameDescription
MENU_IDA relative menu URL with just the menu ID
#request.baseURL#/web/userview/MenuId/UI/_/MenuIdA full absolute UI menu URL with app ID, UI ID, UI key and menu ID

Regular Expressions

The Property Assistant also supports Regular Expressions (Figure 7). 

A Regular Expression (regex for short) is a string of text that lets you create patterns that help match, locate, and manage text.

A regular expression can be used in :

  • Form Builder
  • List Builder
  • UI Builder
  • BeanShell code
  • Supported plugin configuration properties
  • Activity name in Workflow Designer
  • External Form URL when mapping an activity to an external form

Figure 7: Property Assistant - Regular Expressions

Some regular expressions (identifiable with the pink text colour.) attributes can be replaced with an attribute of your choosing with the help of the property assistant (Figure 7). These dynamic attributes can be replaced with any other character, RegEx token or RegEx.

Character Classes

RegExDescription

[abc]

Matches an a,b or c character.

Note that the characters a,b or c can be replaced with any other character with the help of the property assistant.

[^abc]

Matches any character other than an a,b or c.

Note that the characters a,b or c can be replaced with any other character with the help of the property assistant.

[a-z]Matches any between a and z, Including a and z.
[A-Z]Matches any character between A and Z, Including A and Z.
[z-zA-Z]Matches any character between a-z and A-Z.
[a-zA-Z0-9]Matches any letter or digit
[0-9]Matches any digit.
[[:ascii:]]Matches any character in the valid ASCII range.
[[:blank:]]Matches spaces and tabs but not newlines.
[[:cntrl:]]Matches characters that are often used to control presentation, including newlines, null characters, tabs and the escape character.
[[:punct:]]Matches characters that are not whitespace, letters or numbers.

Token

RegExDescription
^Matches the start of a string without consuming any characters.
$Matches the end of a string without consuming any characters.
\nMatches a newline character.
\rMatches a carriage return (Unicode character code +2185).
\tMatches a tab character
\sMatches any space, tab or newline character.
\SMatches any character except a space, tab or newline character.
\dMatches any digit.
\DMatches any character except digits.
\wMatches any letter, digit or underscore.
\WMatches any character except letter, digit or underscore.
\XMatches any valid Unicode Sequence, including line breaks.
.Matches any character other than newline, including line terminators than end with the "\s" token.
a|b

Matches either a or b. 

Note that characters a or b can be replaced with any other character with the help of the property assistant.

Quantifiers

RegExDescription
a?

Matches an "a" character or nothing.

Note that the character "a" can be replaced with any other character with the help of the property assistant.

a*

Matches zero or more consecutive "a" characters.

Note that the character "a" can be replaced with any other character with the help of the property assistant.

a+

Matches one or more consecutive "a" characters.

Note that the character "a" can be replaced with any other character with the help of the property assistant.

a{3}

Matches exactly three consecutive "a" characters.

Note that the character "a" and the range "3" can be replaced with any other character with the help of the property assistant.

a{3,}

Matches at least three consecutive "a" characters.

Note that the character "a" and the range "3" can be replaced with any other character with the help of the property assistant.

a{3,6}

Matches between three and six (inclusive) consecutive "a" characters.

Note that the character "a" and the range "3,6" can be replaced with any other character with the help of the property assistant.

Commonly Used

RegExDescription
^([a-zA-Z0-9._%-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,6})*$Matches common email pattern.
^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#()?&//=]*)$Matches the common URL pattern.

Related Documentation