Sun[tm] ONE Portal Server, Mobile Access 6.2 Administrator's Guide |
Chapter 5
Configuring Mobile ApplicationsSun ONE Portal Server, Mobile Access software provides three default applications that end users can access in the mobile Portal Desktop. These are:
These applications run on a back-end server with the mobile Portal Desktop acting as the user interface. Once the link to the application is established, they run outside the control of Portal Server software. When the user is finished using the application, they can return to the mobile Portal Desktop to work with other providers.
This chapter explains how to use the administration console provided by Sun ONE Identity Server software to manage the application preferences associated with the address book, calendar, and mail applications. It provides these sections:
To obtain detailed information on the Service Configuration and Identity Management features, refer to the Sun ONE Identity Server 6.1 Administration Guide. To obtain detailed information on configuring communications channels, refer to the Sun ONE Portal Server 6.2 Administrator’s Guide.
Using Service Configuration AttributesWithin the Service Configuration level, you can view and change default application preferences as well as control which preferences users can edit themselves.
Two types of preferences for mobile applications are stored in Service Configuration:
To Edit Service Configuration Attributes
- Log in to the Sun ONE Identity Server administration console as the administrator.
By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation Pane.
- Click the Service Configuration tab.
- Under the Mobile Application Configuration heading, select Mobile Address Book.
The Mobile Address Book pane with the address book preferences is displayed.
- Locate the preference that you want to change and highlight the value you want to change.
- Click Remove.
- In the text box, type in the new value for the preference.
- Click Add.
Your new value appears in the preference display.
- Select Save.
You can now view your new settings.
Using Identity Management AttributesWithin the Identity Management level, you can view and change default application preferences for any organization or user.
Preferences stored here are copies of the dynamic preferences stored at the Service Configuration level. For the mobile mail application, an organizational preference is stored here also.
To Edit Identity Management Services Attributes
- Log in to the Sun ONE Identity Server administration console as the administrator.
By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation Pane.
- Choose Services from the View menu in the navigation pane on the left of the Identify Management page.
The list of Identity Server services appears in the navigation pane on the left.
- From the Mobile Application Configuration heading, select the mobile application.
The application preferences are displayed in the data pane on the right.
- Enter your value.
- Select Save.
You can now view your new settings.
To Edit Identity Management Users Attributes
- Log in to the Sun ONE Identity Server administration console as the administrator.
By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation Pane.
- Choose Users from the View menu in the navigation pane on the left.
The list of Identity Server users appears in the navigation pane on the left.
- From the UserId column, select the box next to the name of the user and click on the arrow following the user’s full name.
The user’s information displays in the data pane on the right.
- Choose the mobile application from the View menu in the data pane on the right.
The mobile application pane with its preferences is displayed.
- Enter the values, if you wish to change a user’s preferences.
- Select Save.
You can now view the new settings.
About Mobile Application TemplatesMobile application templates exist to establish the rules governing the storage of application preferences. The templates are represented as uniform resource locators (URLs) described in RFC 1738 published by the World Wide Web Consortium (W3C).
Administrators can edit template strings to assign values to properties within the strings and to apply certain rules of use to those properties.
A template string must start with the word default followed by the pipe symbol |. The string provides the name of the template configuration and preferences that can be changed to alter the application’s behavior. These preferences are set to default values when Mobile Access is installed.
Code Example 5-1 is an example of an address book template. Template strings appear in the field as a single, long string. This example divides the template string into separate lines for readability purposes. Line breaks have been added preceding each ampersand (&).
Code Example 5-1
default|undef:///?configName=MA-AB-APP
&default=sortBy
&default=sortOrder
&merge=sortBy
&merge=sortOrder
&sortBy=cn
&sortOrder=asc
The name of the template in this example is MA-AB-APP. This template includes two preferences—sortOrder and sortBy. It provides default values for them and rules permitting user definitions of these preferences.