Page Composer Field Property Descriptions

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.

Examples of EL Expressions
The first example applies a simple EL expression to the Membership Type field to evaluate a profile’s details and change the background color of the field based on the membership type. In this example (shown below), the expression evaluates if the Membership Type of the profile is OR. If the statement is true, the background color of the field changes to Hex Color #ffff00 (Yellow). If it is false (Membership Type is not OR), then no changes are made to the field.
    #{bindings.MembershipType.inputValue == 'OR'  ?  '#ffff00' : '' }
This next example evaluates if the Membership Level is OR and changes the background color of the field to Hex Color #0493f2 (Blue) if the statement is true:
    #{bindings.MembershipType.inputValue=='OR' ? '#0493f2' : '' }
This example hides the field if the Room Type is the same as the Room to Charge (RTC):
    #{bindings.RoomTypeCharged.inputValue== bindings.RoomType.inputValue ? false : true }
This last example marks the Visa Expiry Date field as required based on a condition:
    #{bindings.VisaNumber.inputValue== null ? false : true}

For further information on EL expressions, refer to the following links:

https://docs.oracle.com/javaee/7/tutorial/jsf-el.htm

https://docs.oracle.com/javaee/6/tutorial/doc/gjddd.html

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 Advanced tab, enter the following:
  • 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.

To evaluate the empty field, enter this expression for the Field Value:
#{bindings.FormerName_MiddleName.inputValue !='' ? false : true}
To update the Alternate Name field value using the Name, First, and Middle Names, enter these expressions:
#{bindings.FormerName_Surname.inputValue}  
#{bindings.FormerName_GivenName.inputValue}
#{bindings.FormerName_MiddleName.inputValue}