6 Wireless Customization Portal

6.4.1.1 Creating a Subfolder

You can organize the folders in the Application page by creating subfolders.

Create a subfolder by first clicking the Create Folder button on the top of the Application Tree table. The Create Folder Screen appears (Figure 6-3).

Figure 6-3 The Create Folder Screen

Description of "Figure 6-3 The Create Folder Screen"

In this screen, enter the name for the subfolder (this is a required field) and then select the location for the folder from the drop-down list in the Parent Folder field. (The location is either the user's home folder, or a subfolder of the user's home folder.). Click Finish. The Application page reappears, displaying the folder in the appropriate location of the current folder. Clicking Cancel clears all the values you have entered and returns you to the Applications page.

6.4.1.2 Editing a Folder

The Edit Folder screen (Figure 6-5) enables you to change the name of a folder.

To edit a folder, you first select a folder from the Application screen and then click Edit (which, as depicted in Figure 6-4, appears as a hyper link adjacent to the folder, along with the actions Reorder and Delete).

Figure 6-4 Editing a Folder

Description of "Figure 6-4 Editing a Folder"

The Edit page appears and displays the values set for the selected folder.

After you change the needed values (refer to Section 6.4.1.1 for more information on folder parameters) click Finish. The Application page reappears, displaying the folder in the appropriate location of the current. Clicking Cancel sets the values for a folder back to their previous state and returns you to the Applications page.

Figure 6-5 The Edit Folder Screen

Description of "Figure 6-5 The Edit Folder Screen"

6.4.1.3 Reordering the Display Sequence for Folder

To reorder the display sequence of a folder, select the folder in the Application screen and then click the Reorder option (depicted in Figure 6-6). The Reorder screen appears.

Figure 6-6 The Reorder Screen

Description of "Figure 6-6 The Reorder Screen"

The arrows enable you to reposition a folder, or move it to the top or bottom. Click Finish to apply the sequence settings and return to the Applications page. Clicking Cancel to returns the folder to its previous placement.

6.4.1.4 Deleting a Folder

You delete a folder by selecting it in the Applications page and then by clicking Delete. A confirmation page appears (Figure 6-7). Clicking Yes confirms the deletion; clicking No cancels the deletion.

Figure 6-7 The Confirmation Page

Description of "Figure 6-7 The Confirmation Page"

6.4.2.1 Creating a Bookmark

To create a bookmark, you first click Add Bookmarks in the Applications screen. The Create Bookmark screen appears (Figure 6-8).

Figure 6-8 The Create Bookmark Screen

Description of "Figure 6-8 The Create Bookmark Screen"

In the Create Bookmark screen, you enter the bookmark name (a required value) and then enter the URL of the new bookmark (for example, www.oracle.com). Use the drop-down list box in the Move to Folder field to assign the location of the new bookmark. The location is either the user home folder or a subfolder of the user home folder. Click Create. The Applications screen reappears, displaying the new bookmark under the appropriate folder. Clicking Cancel clears all values and returns you to the Applications screen.

6.4.2.2 Editing a Bookmark

You can change a bookmark by selecting a different URL, by renaming it, or by placing it in another folder.

To edit a bookmark, you select a bookmark from the Applications screen (or select a folder and drill down to the bookmark) and then click Edit. The Edit Bookmark screen appears (Figure 6-9) with its fields populated with the values of the selected bookmark.

Figure 6-9 The Edit Bookmark Screen

Description of "Figure 6-9 The Edit Bookmark Screen"

Modify the bookmark's values as needed. For more information on the bookmark parameters, see Section 6.4.2.1, "Creating a Bookmark". Click Finish to commit your changes. Clicking Cancel sets the parameters back to their previous state.

6.4.2.3 Deleting a Bookmark

To delete a bookmark, select a bookmark from the Applications screen (or select a folder and drill down to the bookmark) and then click Delete. The delete confirmation page displays. Clicking Yes confirms the deletion; clicking No abandons the deletion.

6.4.4.1 Editing a Short Name

You can edit a short name by renaming it and changing its command string.

To edit a short name, click the Manage Short Names button in the Applications screen. From the short names in the following screen, select a short name and then click Edit. The Edit Short Name screen then appears, populated with the values set for the selected short name. Edit the value and then click Finish to commit the changes. Clicking Cancel sets the values for the short name back to their original state.

6.4.4.2 Deleting a Short Name

To delete a short name, click the Manage Short Names button. Select a short name from the table in the following screen and then click Delete. In the confirmation screen that then appears, select Yes to confirm the deletion and No to cancel the deletion.

6.4.5.1 Adding a New Notification Subscription

To add a new subscription:

1. To add a subscription, click the Subscribe link in the application table. In the detail screen, click Add. The Add Notification subscription screen for the selected notification appears (Figure 6-14).

2. Enter the subscription name. This is a required field.

3. Set the notification device preference for message delivery. The options for setting this value include:

   • You can specify the delivery of the notification based on the definition of the currently active contact rule.

   • You can specify the primary notification device and the maximum number of notifications that you want to receive per day on that device.

   • You also can specify an alternative means of handling the additional messages if the maximum number of notifications is reached for the primary notification device. You can discard all the excess messages or send them to an alternative device.

4. Enter the values for all the conditions. If the notification application is value-based, then the value condition list displays in the Value Condition section.

5. If the notification application is time-based, then the time conditions display in the Time Condition section. The time conditions include a blackout period or options for setting the notification to trigger for a period of time or at a specific time. For more information on setting trigger conditions, refer to Chapter 11, "Notification Engine".

6. If the notification application is location-based, the location awareness conditions display in the Location Awareness Condition section. You can specify which target you want to monitor as well as the movement of that target. For example, you can set the condition as send me a notification when John is at Oracle Headquarters (where Oracle Headquarters is a region object defined in the Location management tool).

7. Click Finish to save your inputs. Clicking Cancel clears your entries.

Figure 6-14 The Add Notification Subscription Screen

Description of "Figure 6-14 The Add Notification Subscription Screen"

6.4.5.2 Editing Notification Subscriptions

The notification subscription screen enables you to edit a subscription by changing the trigger conditions of a selected subscription or by changing the notification delivery rules.

To edit a subscription, click the Subscribe action link in the application table to access the detail page. From the subscription table, select the subscription that you want to modify and then click the Edit button. The Edit screen appears, with its fields populated with the values for the selected notification subscription. (For information on these fields, refer to Section 6.4.5.1.) Edit the values as needed and then click Finish to save your changes. Clicking Cancel sets the parameters back to their previous values.

6.4.5.3 Deleting Notification Subscriptions

To delete a notification subscription, select the notification subscription from the detail page and then click Delete. A confirmation page appears, asking you to confirm the deletion by clicking Yes, or cancel it by clicking No. Select Yes.

6.5.1.1 Validating a Phone

After you create a phone, OracleAS Wireless prompts you to validate the device (Figure 6-17).

Figure 6-17 Validating a Phone

Description of "Figure 6-17 Validating a Phone"

To validate a phone, you first click Send to send the validation code to your phone. After you receive this code, enter it in the screen and then click Validate. If the device is successfully validated, the Status column displays Valid.

6.5.1.2 Editing a Phone

You can update a phone device by changing the name, number for the device, or the number of notifications received. To update a phone, you first select a phone and then click Edit. The editing page appears, with its fields populated by the values set for the selected device. For information on these values, see Section 6.5.1, "Creating a New Phone". After you change any values, you must once again validate the device. For information on validating the device, see Section 6.5.1.1, "Validating a Phone". Click Finish to save your changes. Clicking Cancel sets the parameters for the phone back to their previous values.

6.5.1.3 Deleting a Phone

To delete a phone, select a phone from the Device List and then click Delete. In the confirmation screen that follows, click Yes to confirm the deletion and No to cancel the deletion.

6.5.2.1 Validating a Fax

After you create a fax, OracleAS Wireless prompts you to validate the device.

To validate a fax, you first click Send to send the validation code to your fax. After you receive this code, enter it in the screen and then click Validate. If the device is successfully validated, the Status column displays Valid.

6.5.2.2 Editing a Fax

You can update a fax device by changing the name, number or the number of notifications received. To update a fax, you first select a fax and then click Edit. The editing page appears, with its fields populated by values specific to the selected device. For information on these values, see Section 6.5.2, "Creating a New Fax". After you make any needed changes, you then validate the device. For information on validating the device, see Section 6.5.2.1, "Validating a Fax". Click Finish to save your changes. Clicking Cancel sets the parameters for the fax back to their previous values.

6.5.2.3 Deleting a Fax

To delete a fax, select a fax from the Device List and then click Delete. In the confirmation screen that follows, click Yes to confirm the deletion and No to cancel the deletion.

6.5.3.1 Validating the E-mail Device

After you create a e-mail, OracleAS Wireless prompts you to validate the device.

To validate a e-mail, you first click Send to send the validation code to your e-mail. After you receive this code, enter it in the screen and then click Validate. If the device is successfully validated, the Status column displays Valid.

6.5.3.2 Editing an E-mail Device

You can update a e-mail device by changing the name, number or the number of notifications received. To update a e-mail, you first select a e-mail and then click Edit. The editing page appears, with its fields populated by values specific to the selected device. For information on these values, see Section 6.5.3, "Creating an E-mail Device". After you make any needed changes, you then validate the device. For information on validating the device, see Section 6.5.3.1, "Validating the E-mail Device". Click Finish to save your changes. Clicking Cancel sets the parameters for the e-mail back to their previous values.

6.5.3.3 Deleting an E-mail Device

To delete a e-mail, select a e-mail from the Device List and then click Delete. In the confirmation screen that follows, click Yes to confirm the deletion and No to cancel the deletion.

6.5.4.1 Validating the Mobile Device

After you create a mobile device, OracleAS Wireless prompts you to validate the device.

To validate a mobile device, you first click Send to send the validation code to your mobile device. After you receive this code, enter it in the screen and then click Validate. If the device is successfully validated, the Status column displays Valid.

6.5.4.2 Editing a Mobile Device

You can update a e-mail device by changing the name, number or the number of notifications received. To update a e-mail, you first select a e-mail and then click Edit. The editing page appears, with its fields populated by values specific to the selected device. For information on these values, see Section 6.5.4, "Creating a New Mobile Device". After you make any needed changes, you then validate the device. For information on validating the device, see Section 6.5.4.1, "Validating the Mobile Device". Click Finish to save your changes. Clicking Cancel sets the parameters for the e-mail back to their previous values.

6.5.4.3 Deleting an Mobile Device

To delete a mobile device, select a mobile device from the Device List and then click Delete. In the confirmation screen that follows, click Yes to confirm the deletion and No to cancel the deletion.

6.6.11.1 Deleting User Group

Select one user group and then click the Delete button. The confirmation page then displays. Click Yes to delete the selected User Group object. Click No to stop the deletion.

6.7.1.1 Adding a Contact Rule

To add a Contact Rule, click the Add button in the Contact Rules page. Complete the fields as detailed below.

• Contact Rule: Enter a name for your contact rule (for example, At My Desk).

Under the Device Settings,

• Phone: Enter the communication device on which you want to be telephoned (for example, My Mobile Phone). You can select Do not call me if you do not want to be notified through a phone call. Only communication devices that have a voice feature will be listed for selection.

• E-mail: Enter the communication device on which you want to be e-mailed (for example, My E-mail). You can select Do not e-mail me if you do not want to be notified through e-mail. Only communication devices that have an e-mail feature will be listed for selection.

• Fax: Enter the communication device on which you want to receive faxes (for example, My Fax). You can select Do not fax me if you do not want to be notified through a fax. Only communication devices that have a fax feature will be listed for selection.

• Messaging: Enter the communication device on which you want to receive messaging data such as short messages or instant messages (for example, My SMS). You can select Do not send me messages if you do not want to be notified through this delivery method. Only communication devices that have such messaging feature will be listed for selection.

Under the Notification Settings:

• Delivery Method: Enter the delivery method for receiving notifications.

• Start Active Time: Enter the time for which notifications can start being delivered.

• End Active Time: Enter the time for which notifications should no longer be delivered.

• Frequency: Enter which days of the week the active time is in effect (daily, weekdays, or weekend).

• During Inactive Time: Set to either discard all the messages or delay the delivery of the messages, when messages are generated during the inactive time.

Ensure that the appropriate communication device is selected for the way you want to be notified. Otherwise you will not be able to receive notification. For example, if you want to be notified through a telephone call, make sure that Phone delivery method has a communication device selected.

Click Finish after entering your information.

6.7.1.2 Editing a Contact Rule

To edit a Contact Rule, click the radio button of the contact rule you want to modify. Complete the fields as detailed below.

Contact Rule: Enter or change a name for your contact rule (for example, At My Desk).

Under the Device Settings,

• Phone: Enter or change the communication device on which you want to be telephoned (for example, My Mobile Phone). You can select Do not call me if you do not want to be notified through a phone call. Only communication devices that have a voice feature will be listed for selection.

• E-mail: Enter or change the communication device on which you want to be e-mailed (for example, My E-mail). You can select Do not e-mail me if you do not want to be notified through e-mail. Only communication devices that have an e-mail feature will be listed for selection.

• Fax: Enter or change the communication device on which you want to receive faxes (for example, My Fax). You can select Do not fax me if you do not want to be notified through a fax. Only communication devices that have a fax feature will be listed for selection.

• Messaging: Enter or change the communication device on which you want to receive messaging data such as short messages or instant messages (for example, My SMS). You can select Do not send me messages if you do not want to be notified through this delivery method. Only communication devices that have such messaging feature will be listed for selection.

Under the Notification Settings,

• Delivery Method: Change the delivery method for receiving notifications, if necessary.

• Start Active Time: Change the time for which notifications can start being delivered.

• End Active Time: Change the time for which notifications should no longer be delivered.

• Frequency: Change which days of the week the active time is in effect (daily, weekdays, or weekend).

• During Inactive Time: Set to either discard all the messages or delay the delivery of the messages, when messages are generated during the inactive time.

Ensure that the appropriate communication device is selected for the way that you want to be notified, otherwise, you will not be able to receive notification. For example, if you want to be notified through a telephone call, make sure that the Phone delivery method has a communication device selected.

6.7.1.3 Deleting a Contact Rule

To delete a contact rule, select the contact rule radio button in the Contact Rule table, then click Delete.

6.7.1.4 Selecting an Active Contact Rule

You can select a contact rule to be your currently active contact rule. For example, if you are at the field office, you may set your At Field Office contact rule active, and thus, settings in this contact rule will be in effect for communication and all notifications.

6.7.1.5 Selecting a Contact Rule from a Web-Based User Interface

You can change your active contact rule setting from the Contact Rules page in the Oracle Application Server Wireless Customization portal by selecting the radio button of the contact rule you want to set as active, then clicking the Set Active button.

6.7.2.1 Selecting a Contact Rule from a Web-Based User Interface

You can change your contact rules from the Home page of the Oracle Collaboration Suite by selecting a contact rule from the Contact me drop-down list (Figure 6-27) and then by clicking Change, or from the Advanced page by selecting a contact rule followed by clicking Set Current.

Figure 6-27 Selecting a Contact Rule from the Oracle Collaboration Suite

Description of "Figure 6-27 Selecting a Contact Rule from the Oracle Collaboration Suite"

6.7.2.2 Selecting a Contact Rule from a Device

You can also select contact rules from a variety of devices, because OracleAS Wireless XML enables the conversion of XML from any Oracle Application Server Wireless application into several device-specific markup languages. As a result, you can select contact rules from a WAP-enabled device or from a regular phone. In addition, async-enabled applications enable you to select contact rules from devices having such asynchronous messaging applications as SMS or e-mail, but lacking Internet access. To change contact rules from these devices, you send a message to the Async SMS or e-mail address set by the system administrator.

From a device, such as a WAP-enabled mobile phone, you select a contact rule from a displayed list. When you change a contact rule, OracleAS Wireless switches from one rule's settings (which controls how you are contacted) to those of another contact rule.

The following section describe the following:

• Section 6.7.2.3, "Selecting a Contact Rule from a Device"

• Section 6.7.2.4, "Selecting a Contact Rule from an SMS- or E-mail-Based Device"

• Section 6.7.2.5, "Selecting a Contact Rule Using a Voice Application"

6.7.2.3 Selecting a Contact Rule from a Device

A mobile device, such as a mobile phone, displays your contact rules as a list and notes your current contact rule with an asterisk (*). Figure 6-28 for example, notes On The Go as the current contact rule. You select a new contact rule by using the device's navigation keys and then by selecting OK.

Figure 6-28 Selecting a Contact Rule from a Device

Description of "Figure 6-28 Selecting a Contact Rule from a Device"

The confirmation screen appears (Figure 6-29), noting the new contact rule. Clicking OK returns you to the main menu.

Figure 6-29 The Confirmation Page (from a Device)

Description of "Figure 6-29 The Confirmation Page (from a Device)"

6.7.2.4 Selecting a Contact Rule from an SMS- or E-mail-Based Device

From devices using async applications, you can set your contact rules by sending commands as messages to the Async SMS or e-mail address. You can use messages to set your contact rules as follows:

6.7.2.5 Selecting a Contact Rule Using a Voice Application

After you dial in, do the following:

1. Enter your mobile phone number. See(Section 6.7.1, "Contact Rules in the Customization Portal" for more information).

2. Enter your PIN. Confirm your PIN number when prompted.

3. Say Contact Rules to launch the Contact Rules application. The system first announces your current contact rule and then a list of the available contact rules.

4. Say the name of the new contact rule. For example, say At My Desk. The system then replies, confirming the change and returns to the main menu.

6.9.4.1 Colors and Fonts

The colors and fonts can be customized by modifying the XML Style Sheet file:

ORACLE_HOME/uix/cabo/styles/blaf.xss.

After the modification, remove:

ORACLE_HOME/j2ee/OC4J_Wireless/applications/mobile/mobile-web/

cabo/styles/cache directory, and restart the server.

The new Colors and Fonts will take effect on the Web page.

6.9.4.2 UIX Modification

The UIX template files base.uit, basicFlow.uit and advancedFlow.uit generate the Customization Portal page template. The file base.uit is included in basicFlow.uit and advancedFlow.uit. Either basicFlow.uit or advancedFlow.uit is included in other UIX files. If any changes are made in the template file, then all of the pages that use that template file will automatically inherit the changes.

base.uit (described in Table 6-12) generates the logo

basicFlow.uit (described in Table 6-13) generates the global buttons basicFlow.uit includes the template page base.uit.

advancedFlow.uit generates (described in Table 6-14) the global buttons and side-navigation tab bar. advancedFlow.uit includes the template page base.uit. services.uix presents a hierarchical view of the applications accessible to the user. services.uix includes the template page advancedFlow.uit.

6.9.5.1 Customizing an Application in a Plug-in Page

The plug-inService.uix is the main page that includes the plug-in customization page. The value of plug-in URL is retrieved from the application (service) object and constructed using the generateplug-inLink API to concatenate the necessary page flow parameters in the URL. The concatenated parameters include the application object ID, User object ID, GUID, and the page flow information of the main page.