The customization mode for a screen occurs when you click the pencil icon for a field. When a screen is in customization mode, the following field properties are available on some screens:
Table 1-4 Field Properties
Property | Description |
---|---|
Displayed |
Select to show the text/link on the screen. |
Disabled |
Select to disable the field on the screen. |
Read Only |
Select to prevent the field from being edited. |
Required |
Select to make the field mandatory. When saving the screen, an error appears if the field is not completed. You can use this with Show Required, which also places a red asterisk by the field to indicate that the field is mandatory. |
Tooltip |
Enter a tooltip for the field. |
Charactercase |
Enables you to enforce uppercase, lowercase, or mixed use characters for the input text in a field. |
Uppercase |
Formats the user input text in a text field as uppercase. |
Label |
Enter the name of the label that appears for the custom field. |
Default Value |
Enter a number, date, or text into the field to appear as the initial data. |
Background Color |
Sets the background color for the field. |
Label Color |
Sets the color for the field label. |
Text Color |
Sets the text color for the field. |
Refresh |
Select to trigger the validation of a value entered by the user. |
Custom Validator/RegEx Validator |
Enables the coding of system inserted data (SID) categories (categories that are implemented upon installation) or regular expressions to the field. |
Flex Fields / User Defined Fields (UDF)
Flex fields are user-defined fields that you can add to a screen. You can select either text, number, link, or date types for a Flex field. In addition to the above properties, Flex fields also provide the following properties:
Table 1-5 Flex Field Properties
Property | Description |
---|---|
Show Required |
Select to place a red asterisk by the field to indicate the field is mandatory. |
Value |
Sets the internal identifier for the field. The system uses this value to identify the new field control on its related screens. For example, if you create a text field on the Reservation screen using the value Text UDF 10 and make it a required field, then you can also create a text field on the Check In Reservation screen using the same field value (Text UDF 10) and set it as Read Only. The information entered into the field in the Reservation screen automatically populates the Read Only field in the Check In Reservation screen. |
Field Length |
Determines the display size of the field on the form. It does not dictate the number of characters the field accepts. |
Enable LOV |
Determines whether a drop-down list is used for the field data. |
Allow Multiselect |
If a drop-down list is used, this determines if the user can select more than one item in the list. |
LOV Group |
Select the group of values to use for the drop-down list. To configure the values for this drop-down list, select the Administration menu, select Enterprise, select User Interface Management, select User Defined Field Values and then search for the LOV group. You can click New to create a new value for the list. |
User Defined Link (UDL)
User defined links enable you to configure links to appear within the panel on the page. The link can be either a static or dynamic URL. A static URL launches a web page where the URL is always the same. A dynamic URL is variable, being based on field values referenced in the link. A dynamic URL can be used to launch an external web application and pass values from the OPERA Cloud record in the URL.
For example, you could configure the following dynamic link to append the guest’s membership number in the URL:
https://myreward.com/#{bindings.MembershipId.inputValue}
The following properties are only available for UDL fields (URL Links).
Table 1-6 UDL Properties
Property | Description |
---|---|
Text |
Enter the text that appears as the link. |
Destination |
Enter the URL (web address). |
Append Parameter |
The option to attach additional values to a web page address that can be parsed on demand, provided the web page is set up to handle the code. The available parameters depend on the screen being customized. Enter the website address followed by a trailing slash (/), and then select the parameter to append. |
Custom Options
On the Customize screen, a custom option is available for most fields by clicking the </> button for the property or selecting Custom from the property’s drop-down list. The Custom option enables you to add Expression Language (EL) expressions for a field and evaluate the expressions.
When a property for a field has been customized, a Reset link appears next to the property. The Reset link helps you identify if a property has been customized and you can click this link to revert the customization.
#{bindings.MembershipType.inputValue == 'OR' ? '#ffff00' : '' }
#{bindings.MembershipType.inputValue=='OR' ? '#0493f2' : '' }
#{bindings.RoomTypeCharged.inputValue== bindings.RoomType.inputValue ? false : true }
#{bindings.VisaNumber.inputValue== null ? false : true}
For further information on EL expressions, refer to the following links:
Advanced Options
You can define conditional properties for a field by clicking the Advanced tab on the Customize screen. When the condition is true, an action can result, such as a field being updated. When the condition is false, a different action can result, such as a warning message appearing to indicate the user input was invalid. The following actions can be selected from the Action drop-down list: No Action, Show Message, Update Field, and Show Message and Update Field.
The following is an example of how you can configure an advanced option for the Middle Name field on the Profile Details screen. In this example, when a user enters a name in the Middle Name field, the Last Name, First Name, and Middle Name values are appended and populated into the Alternate Name field and an information message appears to the user.
Under the If (Condition), select Custom.
Under Then (True), select No Action for the Action.
Under Else (False), select Show Message and Update Field for the Action.
For the Message Type, select Info.
In the Message field, enter the message that appears to the user.
For the Update Field, select Alternate Name.
#{bindings.FormerName_MiddleName.inputValue !='' ? false : true}
#{bindings.FormerName_Surname.inputValue}
#{bindings.FormerName_GivenName.inputValue}
#{bindings.FormerName_MiddleName.inputValue}
Parent topic: Page Composer