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

Compare with Current View Page History

« Previous Version 5 Current »


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

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.

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


  • No labels