For value type Text the Properties step displays different options. The default option is Length, with no validation value (blank).
Length defines the total number of characters one may enter wherever the category is available. The drop-list includes a blank- no length option plus three preset lengths: Short =0-250 characters, Medium=0-500 characters and Long=0-2500. The preset length values can be customized by the Oracle Primavera Professional Services team.
Selecting the Custom button opens a dialog box in which you may enter a custom length definition. Entering positive integers in both fields determines the number of characters the text field will accept.
The custom length definition is displayed in the Length field in the following format: "Custom: <min-max> characters".
Note: The custom definition is added temporarily to the Length drop list. Selecting one of the predefined options and clicking Next will erase the custom definition.
Selecting Mask lets you define the input format.
The following masking elements can be used:
Masking Element | Description |
|---|---|
0 | Digit, required |
9 | Digit, optional |
T | Letter, required |
t | Letter, optional |
R | Uppercase letter, required |
r | Lowercase letter, required |
& | Character, required |
? | Character, optional |
A | Alphanumeric character, required |
a | Alphanumeric character, optional |
\ | Escape. Escapes a mask character, turning it into a literal. |
All other characters | Literals. All non-mask elements will appear as themselves within masked fields. |
There are several masking options available:
- Blank- this is the default option. No mask is applied to the field.
- Predefined Masks- a number of predefined masks are "factory-supplied". The current list of predefined masks includes: Phone Number; SSN#, Zip Code and e-mail.
E-mail is a special case. In order not to limit the possible address options, the Mask for e-mail will simply show name@domain. If necessary, special e-mail masks can be created by the PPM Professional Services team.
- Custom- you may create a custom mask by entering custom masking characters (detailed above) into the Format field.
- Advanced- this is an option for advanced users only. Selecting the Advanced button opens the Advanced Mask Formats dialog box seen below:
In the Advanced Mask Formats dialog box it is possible to enter multiple mask formats and/or use Regular Expression syntax to define the Custom mask format.
- Multiple Mask Formats: Allows the definition of more than one mask format (as defined in the Mask Table above) for the field. Each line in the Mask Format box defines an optional input format. The input needs to match just one of the mask definitions for validation.
- Regular Expression: Checking the RegExp checkbox gives you the option to create a custom mask using Regular Expression syntax in the Advanced Mask Formats box. The rules for Regular Expression syntax are the same as for JavaScript Regular Expressions. This option is added to support complex validation functionality.
- Hint: Defining a hint is mandatory for Advanced masks. The description entered in this free text area becomes the advanced mask formats' tooltip.
The Hint button opens the Hint Text dialog box. In this dialog box you can enter a free-text hint or sample text for the format used in the masked text field. The hint entered here will show up as a tool tip when hovering above masked fields in the Forms module (except in table fields). It is also the error message for the field in the Scorecards and Workbook modules.