9
Managing Users

This document describes how you can create and modify Oracle9iAS Wireless users and user groups using the User Manager. Each section of this document presents a different topic. These sections include:

• Section 9.1, "Overview of the User Manager"
• Section 9.2, "Logging into the User Manager"
• Section 9.3, "Using the User Manager"

9.1 Overview of the User Manager

The User Manager is accessible to users granted the Administrator or Helpdesk roles. This tool enables you to perform such Helpdesk functions as creating and modifying users and groups and assigning services to users and groups.

User groups help you manage service access for multiple users. You can create user groups based on such considerations as subscription level, geographic location, or interests. Each user object represents a Oracle9iAS Wireless end user.

The name for the user object must be unique within Wireless. Users have an external identifier attribute. Using this ID, Wireless associates the user with an external provisioning system account. The value of the external ID, for example, may be a telephone number or user account number with an ID to an external repository.

9.1.1 Assigning User Roles

Wireless users can be assigned the following roles:

Table 9-1 Wireless User Roles

User Role	Description	Available Tools
Designers	Users assigned the Designer role perform the following functions: Create, modify, and delete and test master services and adapters. Create, modify, delete, and test data feeders and master alerts. Create, modify, and delete transformers for logical devices. Develop location-based services. Develop preset definitions.	Service Designer
Organizers	Users assigned the Organizer role perform the following functions: Manage service folders. Create services based on master services. Create alerts based on master alerts. Deploy applications to users and user groups. Assign regions to location-based services.	Content Manager
System	Users assigned the System role manage the system using the System Management Tool.	Wireless system management functions (through the Oracle Enterprise Manager console)
Helpdesk	Users assigned the Help Desk role perform the following functions: Manage users and groups. Check user profiles and services. Create new groups and users. Manage user access privileges. Assign different roles to a user. View the services, alert, and asynchronous logs.	User Manager
End User	Users assigned the end user role are the consumers of Wireless services. End-users create their own accounts when they register with Wireless using the Wireless Customization. End users can also customize their own services either from a desktop or from a device. Customization for end-users includes: Subscribe to alerts. Create presets. Manage user profiles. Every Wireless user is granted the Mobile Customer Role by default. This role is implicit to all users.	Device Portal Access

Wireless also allows anonymous users, those who do not register with Wireless but would like to try out the services as a guest. You can create an anonymous user account for each group. All unregistered users share the guest account to invoke services owned by the group. A guest user cannot personalize services.

9.1.1.1 Enabling Users to Access the Wireless Webtools

You must assign roles to users with the User Manager rather than with other general-purpose user management tools, such as DAS. Users created using DAS or other OID tools are provisioned in Wireless only when the created user accesses the Wireless portal, device portal, or any of the PC-based tools for the first time. These provisioned users do not have the assigned roles needed to access the Wireless webtools. For example, a user must have the Designer role to access the Service Designer. If a user with no assigned roles tries to log in to a Wireless webtool, then Wireless displays the following Single Sign-On error:

Your session has timed out. Please log on again.

The user can successfully log in to the Wireless webtool (or other components) only after you assign the user a role. See Section 9.3.4 for information on creating a user and assigning user roles.

9.2 Logging into the User Manager

Before using the User Manager, you must first log in as follows:

1. Access the login page through the following URL:

   http://hostname:7777/webtool/login.uix

   Note: 7777 is the default port number for Oracle9iAS Wireless. The port number range is 7777 to 7877. To ensure that you are using the correct port number, check the port number for Oracle9iAS Wireless stored in [Oracle home]/install/portlist.ini. For more information on port usage, see Oracle9i Application Server Installation Guide and the Oracle9i Application Server Administrator's Guide.

2. Enter your user name and then enter your password. If you are an administrator, enter orcladmin as your user name. (The password is set during installation, but can be changed with the User Manager.)

9.3 Using the User Manager

After you have successfully logged into the User Manager, the tool defaults to the User tab, displaying the Users screen.

Figure 9-1 The Search User Result Screen

Text description of the illustration usr_busr.gif

The Search User Result screen enables you to search for users and as well as create and edit user profiles, and delete users.

9.3.1 Searching for Users

The Users subtab contains User Name, Display Name, and Group fields that enable you to find current Wireless users. The Search User Result's screen displays search results as follows:

Table 9-2 Elements Search User Result Screen

Label	Definition
User Name	The name of the user.
Display Name	The display name of the user.
Group Name	The group to which the user has been assigned.
Role Name	The role (or roles) assigned to the user. For information on user roles, see Section 9.1.1.

To find users:

1. Enter the user's name in the User Name field.
2. Enter the user's display name, if known, in the Display field.
3. From the drop-down list, select the group to which the user belongs.
4. Click the Search button. The list of users corresponding to the search criteria appear. To find all users belonging to a specific group, select the name of the group in the Group field and the click Search.

9.3.1.1 Refining Searches

You can narrow your searches by adding the display name of the user in the Display Name field and then by clicking Go.

You can broaden your search to display all current users by entering a wildcard (* or %) in the User Name field and then by clicking Go.

You can insert wildcards in place of characters. Wildcards can replace all of the characters from the current position to the end of the string. Use the question mark (?) to replace a single character.

The user administrator can display all users belonging to a group by selecting the group name.

9.3.2 Viewing User Information

The View Services button enables you to view and test the services belonging to a selected user. Using this button, you can browse the services, bookmarks, folders, and alerts created by a single user.

Selecting a user and then clicking the View Services button displays the following:

Table 9-3 User Information

Element	Description
Type	The type of objects created by the selected user.
Name	The display name of the folder, service, or bookmark.
Object ID	The Object ID (OID) of the service or module in the database.
Master Service	The master service on which the invoked the user's services are based.
Test	Clicking the phone icon enables you to view the service on a phone simulator.
Visible	If the column displays "true", the object is visible and therefore accessible to an end user. If "false", then the object is not visible.
Sequence	The customized order in which services and folders appear on output devices. By default, these appear in order by name.
Last Modified	The last time an object was modified.

9.3.3 Viewing Activity Logs

The User Manager enables you to view a user's activity within a specific time frame through activity logs that display the accessed asynchronous services, alerts, and services. In addition, these activity logs tell you if Wireless dispatched services successfully.

Figure 9-2 The Activity Log Buttons

Text description of the illustration usr_vlog.gif

To view an activity log:

1. Select a user.
2. Select an activity log.
3. Click Go. The activity statistics display.

The User Manager displays the following for asynchronous service statistics for a selected user:

Table 9-4 Asynchronous Log

Element	Description
Short Name	The name of the asynchronous service (for example, ST for a stock quote service).
ID	The OID of the asynchronous agent service in the database.
Device Address	The address of the user's device receiving the alert.
Server Address	The address of the asynchronous service.
Delivery Type	The delivery type for the asynchronous service (for example, SMS).
Receiving Time	The time the asynchronous agent engine received the request.
Error Description	A message describing how Wireless failed to respond to the asynchronous service.

The User Manager displays the following for alert statistics for a selected user:

Table 9-5 Alert Log Statistics

Element	Description
Alert Name	The name of the alert.
Alert ID	The OID of the alert in the database.
Device Address	The address of the user device receiving the alert.
Device Type	The type of logical device receiving the alert (for example, WAP-Push, SMS, or Email).
Dispatch Time	The time Wireless sent the message.
Message Status	Whether Wireless successfully sent the message. 0 indicates that Wireless successfully sent the message; 1 indicates that Wireless failed to send the message.

The User Manager displays the following for service statistics for a selected user:

Table 9-6 Service Log Statistics

Element	Description
Service Name	The name of the service
Service ID	The OID of the service in the database.
Service Type	The type of object (folder, bookmark, service, or local module) accessed by the user..
Invocation Time	The time the user accessed the service.
Invocation Status	Whether Wireless successfully executed the service. 0 indicates that Wireless successfully launched the service; 1 indicates that Wireless failed to launch the service.

9.3.3.1 Selecting a Time Frame

You can view the activity log for a specific period using the From Date and To Date fields. You can set starting and ending dates either by entering them in the fields in the mm/dd/ yyyy format, or by picking them from the calendars. Click Go after you have completed entering the date range.

Note: . The default From date is midnight of the previous day. Both the From and To dates assume midnight of the selected day.

9.3.3.2 Printing an Activity Log

You can print an activity log by clicking Printable Page. This printed page contains text and has no headers or footers. Use the browser's Back button to navigate from the printed page.

9.3.4 Creating Users

The Create User screen (invoked by clicking the Create button) contains a set of parameters that administrators set to create and configure new users.

Note: Most end users create their own user accounts through the self-registration in device portal access (http://hostname:7777/ptg/rm).

The Create User screen includes the following required parameters.

Table 9-7 Parameters for the Create User Screen

Parameter	Value
User Name	The name of the user. Note: this is case-sensitive.
Email Address	The the email address of the user.
Password	The user's password. Note: the password is case-sensitive.
Password Confirmation	The user's password entered again.
Group	The groups to which you can assign the user. Using the arrow keys, you can select (> or >>) or remove (< or <<) a user from a group.
Roles	The roles to which you can assign a user. Using the arrow keys, you can select (> or >>) or remove (< or <<) a user from a role. If you do not select a role, then the user has end-user privileges and cannot access any Wireless tool. A Helpdesk user can only create other Helpdesk users or end users.

In addition to the required fields, you can supplement the user information by adding additional employee profile information, a photograph of the user, the user's home address, public group assignment, and access to Oracle Reports and Forms-based applications.

To create a user:

1. From the User screen, select Create. The Create a New User screen appears.
2. Enter the user name in the User Name field. This is a required field.
3. Enter the user's email address in the Email Address field.
4. Enter a password for the user in the Password field. This is a required field.
5. Enter the password again in the Password Confirmation field. This is a required field.
6. Enter the additional information as needed.
7. Click Submit to complete the creation of the user. The new user appears in the user list in the Browse User screen.

9.3.5 Editing User Profiles

To edit a user's profile:

1. From the Users screen, select the user whose profile you wish to change.
2. Click Edit. The edit screen appears, displaying the current user profile information for the selected user.
3. Edit the values as needed. See Section 9.3.4 for information on creating a user profile.
4. Click Edit. The Users browse screen appears, displaying any changes pertinent to the labels in the Users screen (for example, the user name) visible.

9.3.5.1 Viewing UTF-8 Pages in Localized Languages with Netscape 4.7 or Lower

Some languages may not display properly if you use Netscape 4.7 or a lower version. In some cases, characters may display as boxes. To fix this problem, configure the Netscape preferences as follows:

1. From the Netscape tool bar, select Edit.
2. Select Preferences from the drop-down menu. The Preferences dialog appears.
3. From the Category tree, select Fonts to display the Fonts dialog.
4. In the Fonts dialog, select Unicode from the For the Encoding drop-down list.
5. From the Variable Width Font and Fixed Width Font drop-down lists, select the font that supports the preferred language. For example, if you select Chinese as your preferred language, you can select MS Song to view the page in Chinese.

9.3.6 Managing Groups

The User Manager enables you to create user groups that organize the user community. Once created, the Content Manager assigns services appropriate to these user groups. Groups (and the users who belong to them) do not own the objects assigned to them; they view them.

Selecting the Group tab displays the Group screen, which you use to create, edit and delete Wireless user groups. You can assign these groups to users. See Section 9.3.4 for more information on assigning users to groups.

9.3.6.1 Creating a Group

To create a new user group:

1. In the Create New Group section, enter the name of the group you want to create in the Group Name field.
2. Enter, if needed, a description of the group.
3. Click Create. The new group appears in the Group Name section.

9.3.6.2 Editing a Group Name

To edit a group name:

1. In the Create New Group section, select the group whose name or description you want to change.
2. Edit the group name or description as needed.
3. Click Apply.

9.3.6.3 Deleting a Group

To delete a group:

1. Select the radio box next to the group that you want to remove from the Wireless repository.
2. Click Delete.