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.
Tip
You can bring up the Property Assistant in any element's Property Editor using the shortcut CTRL + Shift + 3 on Windows OS or Command + Shift +3 on MacOS.
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).
Figure 2: Property Assistant - Hash Variable 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 3)
Figure 3: 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 3) and Escape Mode (Figure 5) (and even a Record's primary key depending on the hash variable used).
Figure 4: Property Assistant - Optional Chunks - App ID
Figure 5: 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.
Figure 6: Property Assistant - URL Attributes Selection
There are currently 2 UI Menu URLs to choose from seen in the table below.
| Name | Description |
|---|---|
| MENU_ID | A relative menu URL with just the menu ID |
| #request.baseURL#/web/userview/MenuId/UI/_/MenuId | A 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
| RegEx | Description |
|---|---|
[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
| RegEx | Description |
|---|---|
| ^ | Matches the start of a string without consuming any characters. |
| $ | Matches the end of a string without consuming any characters. |
| \n | Matches a newline character. |
| \r | Matches a carriage return (Unicode character code +2185). |
| \t | Matches a tab character |
| \s | Matches any space, tab or newline character. |
| \S | Matches any character except a space, tab or newline character. |
| \d | Matches any digit. |
| \D | Matches any character except digits. |
| \w | Matches any letter, digit or underscore. |
| \W | Matches any character except letter, digit or underscore. |
| \X | Matches 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
| RegEx | Description |
|---|---|
| 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
| RegEx | Description |
|---|---|
| ^([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. |