11
Managing Content

The Content Manager enables you to create and organize repository objects. Each section of this document presents a different topic. These sections include:

• Section 11.1, "Overview of the Content Manager"

• Section 11.2, "Logging Into the Content Manager"

• Section 11.3, "Managing Services"

• Section 11.4, "Creating User Home Root Folders"

• Section 11.5, "Managing Alerts"

11.1 Overview of the Content Manager

The Content Manager enables you to publish the master services and master alerts to user groups created by the Service Designer by implementing them as services and alerts. To help you build these repository objects, the Content Manager provides you with screens and wizards that guide you through each step of creating a folder, service, bookmark, or alert. In addition, the Content Manager enables you to distribute these repository objects to user groups, organizing them in a business context appropriate to each user group.

Using the Content Manger Tool, you can create, edit, and distribute the following objects:

Folders

Folders enable you to organize such objects as services and bookmarks. When you assign a folder to a user group, you make its subfolders, services and bookmarks within it accessible to users.

Services

A service inherits a master service or a moduable master service, enabling you to distribute service access to multiple users or groups. Services also enable you to specialize master services, as you can set default parameter values that override values initially set for the master service in the Service Designer. This function provides such benefits as enabling you to localize services. For example, in order for a master service to deliver restaurant information for an entire city, its adapter takes a single parameter (a location), and returns a list of restaurants throughout the city. While the master service can specify a broad location, such as the city, you can create services based on a specific parameter, such as a district within that city. You can then distribute the services, as appropriate, to user groups that you assemble based on the users' locations.

Modules

Modules are reusable services that can be invoked as a normal service, or by another service to return a result to that service. Wireless provides several modules that are ready for deployment, including those for such Personal Information Management (PIM) tools as calendar, address book, fax, and mail.

Bookmarks

A bookmark gives the user quick access to an external resource, typically a Web page that delivers content in a format supported by the target device. End users can set bookmarks to external URLs at the Wireless Customization. The bookmark appears as a menu selection in the device-based customization tool. Wireless does not process the content of the URL target. The format of the target content must be supported by the user's device.

Alerts and Topics

An alert is a notification service delivered to users based on the trigger conditions they set when subscribing to an alert service. An alert inherits a master alert. Content managers create alerts from master alerts constructed using the Service Designer. Content Managers organize alerts by topics, containers that group alerts.

11.2 Logging Into the Content Manager

Before using the Content Manager, you must first log into the Webtool as follows:

1. Access the login page through the following URL:

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

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.)

11.3 Managing Services

The Services tab of the Content Manager enables you to manage services, async services, modules, bookmarks and folders.

Clicking the Services tab displays the Service Browse screen. When you first access the service tab after logging into the tool the Service Browse screen displays the folder and services at the root level.

Using this screen, you can search for folders, services, modules, bookmarks, and async services. The screen also enables you to create a service based on an existing master service, as well as add folders and bookmarks. In addition, you use the Service Browse screen to delete, debug, move, and edit these objects.

Figure 11-1 The Service Browse Screen

Text description of the illustration con_rfsc.gif

11.3.1 Searching for Repository Objects

The Service Browse screen's search function enables you to search for and display the following repository objects:

• Service

• Module

• Async Service

• Bookmark

• Folder

The search field, when used in conjunction with drop-down lists of search options, enables you to either narrow or broaden your searches. The results display as follows in the Search Result screen.

Table 11-1 Elements of the Search Result Section of the Services Screen

Element	Description
Name	The name of the folder or service. Clicking the name of a folder displays its subfolders.
Object ID	The Object ID stored in the database.
Full Path	The route to a repository object, with Services as the root. Each node on the route is displayed as a hyperlink. Clicking a hyperlink reveals a browse screen, showing the subfolders, services, and bookmarks organized under the folder. Using this browse screen, you can perform such functions as creating and deleting services, bookmarks, and folders.
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 order in which services and folders appear on output devices. By default, these appear in order by sequence number, then name. You can enter values in the sequence fields to rearrange the order in which the services and folder appear. By default, Wireless sorts services and folders in ascending order by sequence number, then by name.
Last Modified	The last time the folder or service was modified.

To find a repository object:

1. Enter the name of the object. Enter the full name of the object, or use a SQL Like clause pattern to return a partial match.

2. From the drop-down list box, select one of the following options to narrow or broaden your search:
   • Service

   • Module

   • Async Service

   • Bookmark

   • Folder

3. Select from among the following options to sort your search results by:
   • Name

   • Last Modified

4. Click Search. The Search Result screen appears, displaying the matches for your query.

Figure 11-2 The Search Result Screen of the Content Manager Tool

Text description of the illustration con_ssrv.gif

11.3.2 Creating a Folder

You can organize your repository objects into a hierarchy by creating subfolders. These subfolders, which can represent topic areas, can be nested into other subfolders. When you create a subfolder, the Content Manager displays it as a hyperlink in the screen, allowing you to "drill down" or traverse deeper into the hierarchy with each successive click. Wireless displays the structure of the hierarchy as a navigation path, enabling you to see the level you currently access and move to back to any parent folder in the hierarchy.

Figure 11-3 The Navigation Path

Text description of the illustration con_path.gif

Creating a subfolder is a two-step process; you first define the basic parameters for a folder, such as its name, and then you assign the rendering options that dictate the display style for the folder and its contents.

11.3.2.1 Step 1: Defining the Basic Parameters for a Folder

1. From the Service Browse screen, click Add Folder. The General screen appears, displaying the basic parameters of the folder. These parameters include:

   Table 11-2 Parameters of the Content Manager Create Folder Screen

   Parameter	Value
   Folder Name	The name of the folder. This is a required field.
   Description	A description of the folder.
   Sequence	The order in which services and folders appear on output devices. By default, these appear in order by sequence number, then name. You can enter values in the sequence fields to rearrange the order in which the services and folder appear. By default, Wireless sorts services and folders in ascending order by sequence number, then by name.
   Language	A drop-down list of display languages for the folder. Any services or subfolders contained by this folder must have the same display language. Users will not be able to access these objects if their display language differs from that of the parent folder.
   Renderer Type	A list of the renderer types for a folder. This is a required field. These include: System: The default system object sorting styles. Custom: The object display and sorting styles of another folder or service that dictates the display logic. Inherited: The display style of an ancestor folder which has a custom renderer. If there is no ancestor folder or if the ancestor has a no custom rendering, then the default system sorting style is applied.
   Title Icon URI	The URI of an image used as the icon that appears on top of the screen when this folder becomes the current folder. You do not need to specify the format type in this URI, as Wireless selects the image format appropriate to the user's device.
   Menu Icon URI	The URI of an image used as the icon that appears next to the folder in a menu listing. You do not need to specify the format type in this URI, as Wireless selects the image format appropriate to the user's device.
   Title Audio URI	The URI of the audio file (for example, a .wav file) read aloud by voice-reader software when users access a folder. You do not need to specify the format type in this URI, as Wireless selects the audio file format appropriate to the user's device.
   Menu Audio URI	The URI of the audio file (for example, a .wav file) read aloud by voice-reader software along with a folder in a menu listing. You do not need to specify the format type in this URI, as Wireless selects the audio file format appropriate to the user's device.
   Region Name	The area, such as a continent, country, or city, that is associated with the folder. If you assign a region to a folder, then users can only view that folder and its contents when they are in the assigned region.
   Visible	Selecting this check box makes the folder visible to the end user. If you do not select this option, then the folder and it contents are neither visible nor accessible to the end user.
   Personalizable	Selecting this option enables end users to customize their user views using the Wireless Customization or on the device by reordering, hiding, or showing this folder.

2. Complete the basic parameters as follows:
   1. Enter a name for the folder in the Name field. This is a required field.

   2. Enter a brief description of the folder in the Description field.

   3. Enter a sequence number for the folder.

   4. Select a display language for the folder. This is a required field.

   5. From the drop-down list, select a rendering type for the folder.

   6. Enter the URI of an image used as the icon that appears on top of the screen when this folder becomes the current folder.

   7. Enter the URI of an image used as the icon that appears next to the folder in a menu listing.

   8. Enter the URI of the audio file read aloud by voice-reader software when users access a folder.

   9. Enter the URI of the audio file read aloud by voice-reader software along with the folder name in the menu listing.

   10. Click the flashlight icon to search for and select a region for the folder.

   11. Select the Visible check box to make the subfolder visible on the end users' devices.

   12. Select the Personalizable check box to enable the end user to reorder, hide, or show this folder.

3. Click Continue. The Rendering screen appears.

   Figure 11-4 The Create Folder Screen (General Parameters)

   
   
   Text description of the illustration con_gfld.gif

11.3.2.2 Step 2: Assigning the Rendering Options

The Rendering screen displays options specific to the rendering type you selected when setting the basic parameters for the folder.

Setting the System Default Rendering Options

To set the System Default rendering options:

1. Select a sorting option from the drop-down list. These options include ascending and descending sorting style for folders by:
   • ID

   • Name

   • Last Modified Date

   • Sequence Number

   • Access Count

   By default, folders appear by sequence number, then by name.

2. Click Finish.

Setting the Customized Rendering Options

To set the Custom rendering options:

1. From the Rendering screen, select a folder or service with the appropriate rendering style.

2. Click Finish.

Setting the Inherited Rendering Options

To set the Inherited rendering style:

1. Click Finish in the Rendering screen. If the folder is not a child of another folder (or if none of its ancestor folders have a customized renderer), then Wireless notes the inherited renderer as N/A until the folder is moved under a parent folder with a customized renderer.

2. Use the Move function to place the folder within a folder configured with the appropriate rendering style. See Section 11.3.12 for information on the Move option.

Figure 11-5 The Folder Rendering Screen

Text description of the illustration con_rfld.gif

11.3.3 Editing A Folder

To edit a subfolder:

1. From the Service Browse screen, click the folder you wish to edit. The browse screen for the folder appears.

2. Click Edit. The Edit Folder screen appears displaying the values for the selected subfolder.

3. From the left menu, select the parameters you want to edit.

4. Edit the appropriate values and then click Apply to commit your changes. Clicking Cancel sets the parameters back to their original values and returns you to the browse screen. See Section 11.3.2.1 for information on the basic folder parameters. See Section 11.3.2.2 for information on the folder rendering options.

11.3.4 Deleting a Folder

When you delete a folder, you also delete that folder's contents.

To delete a folder:

1. From the Service Browse screen, click the folder you wish to delete.

2. Click Delete.

11.3.5 Creating a Service

The Content Manager enables you to create a service based on a master service using the Service Creation Wizard, which steps you through the creation of a service. To successfully create a service, you must complete all the required steps of the Service Creation Wizard. Clicking Cancel at any point in the sequence clears all the values you have entered.

To create a service,

1. From the Service Browse screen, click the Add Service button. The General screen of the Service Creation Wizard appears, displaying the following parameters:

   Table 11-3 The General Parameters of the Service Creation Wizard

   Parameter	Value
   Service Name	The name of the service. This is a required field.
   Description	A description of the service.
   Sequence	The order in which services and services appear on output devices. By default, these appear in order by sequence number, then name. You can enter values in the sequence fields to rearrange the order in which the services appear and then set parent folder renderer type as System, and the parent folder sorting option as Sequence Number. By default, Wireless sorts services and services in ascending order by sequence number, then by name. See Section 11.3.2.2 for more information on setting the System folder rendering option.
   Language	A drop-down list of display languages for the service. Users will not be able to access a services if their display language differs from that associated with this service.
   Title Icon URI	The URI of an image used as the icon that appears on top of the screen when this service becomes the current service. You do not need to specify the format type in this URI, as Wireless selects the image format appropriate to the user's device.
   Menu Icon URI	The URI of an image used as the icon that appears next to the service in a menu listing. You do not need to specify the format type in this URI, as Wireless selects the image format appropriate to the user's device.
   Title Audio URI	The URI of the audio file (for example, a .wav file) read aloud by voice-reader software when users access a service. You do not need to specify the format type in this URI, as Wireless selects the audio file format appropriate to the user's device.
   Menu Audio URI	The URI of the audio file (for example, a .wav file) read aloud by voice-reader software along with the service in a menu listing. You do not need to specify the format type in this URI, as Wireless selects the audio file format appropriate to the user's device.
   Region Name	The area, such as a continent, country, or city, that is associated with the service. If you assign a region to a service, then users can only view that service and its contents when they are in the assigned region.
   Visible	Selecting this check box makes the service visible to the end user. If you do not select this option, then then end users cannot see or access this service. You may want to set the services that are under construction as invisible to end users.
   Personalizable	Selecting this option enables end users to customize their user views in the Wireless customization or on the device for reordering, hiding, or showing this service.

11.3.5.1 Step 1: Entering General Parameters for the Service

In the General screen, perform the following:

1. Enter the name of the service in the Service Name field. This is a required field.

2. Enter a description of the service that is meaningful to you in the Description field.

3. Enter the sequence number for the service's menu position within its parent folder on the user's device.

4. Enter the invocation cost to the user for accessing the service in the Cost field. If the service cost is not 0 (zero), then Wireless logs the service invocation in the tx_panama.log file.

5. Enter the URI of an image used as the icon that appears next to a service when this service becomes the current service.

6. Enter the URI of an image used as the icon that appears next to the service in a menu listing.

7. Enter the URI of the audio file read aloud by voice-reader software when users select the service from a menu.

8. Enter the URI of the audio file read aloud by voice-reader software along with the service in a menu listing.

9. Click the flashlight icon to search for and select a region for the service.

10. Click the Visible check box to make the service visible (and accessible) to the end user.

11. Click the Personlalizable check box if you want to make a service that users can customize.

12. Select Module if you want to create a service that can be deployed as module. Select Normal to create a service that is not a module.

13. Click Next. The Master Service screen appears. Clicking Cancel closes the Service Creation Wizard, clears all the values you have entered, and returns you to the Service Browse screen.

Figure 11-6 The New Service Screen of the Service Creation Wizard

Text description of the illustration con_nsrv.gif

11.3.5.2 Step 2: Basing the New Service on an Existing Master Service

You use the Master Service screen to select an existing master service or module service on which to base your service. In the Master Services screen, perform the following:

1. Select the master service or module on which you want to base your service. (Since the Master Service screen displays master services and folders at the root, you may have to expand folders to access the appropriate master services. You can also click on any link of the service path on top of the table to go back to any parent level.)

2. Click Next. The Input Parameters screen displays. If you wish to return to the General screen to change the data you entered, click the Back button.

Figure 11-7 The Master Service Screen of the Service Creation Wizard

Text description of the illustration con_msrv.gif

11.3.5.2.1 Configuring the OMP URLs for Module Services

If you opted to create a modular service, you must enter the OMP URL address of the module service being called in the Master Service screen (Step 2 in the service creation sequence). All module services are identified by the OracleMobile protocol (OMP). You can also enter the URL for the configuration page of the module service.

11.3.5.3 Step 3: Entering New Input Parameters for the Service

You use the Input parameters to set the input parameters for your service. The input parameters for the service are those set for the master service on which you based your service. The Input parameters screen includes the following fields:

Table 11-4 The Input Parameters Screen of the Service Creation Wizard

Parameter	Value
Name	The name of the input parameter. The Service Creation Wizard sets the name of the input parameter by querying the Master Service definition. This field cannot be edited.
Caption	The caption is the label that Wireless uses for the parameter when prompting for user input.
Comment	For master services based on the Web Integration adapter, Wireless automatically populates this field with the name of the WIDL service that uses the parameter. For services based on other adapters, you can use this column to document the parameter. The comment is only used internally. This field cannot be edited.
Format	This mask sets the expected data entry mode for the user device. For example, if you expect the user to enter numbers for the parameter, you use the format code N. (This works only with WML 1.1-compliant devices.) The default format is *M. Other formats include: A, for entry of uppercase letters or punctuation. a, for entry of lowercase letters or punctuation. N, for entry of numbers. X, for entry of uppercase letters. x, for entry of lowercase letters. For a complete list of formats, see the Wireless Application Protocol Wireless Markup Language Specification, Version 1.1. This value cannot be edited.
Mandatory	If this check box has been selected, then the parameter must have a value. If the check box is clear, then parameters are optional. This field cannot be edited.
Customizable	Specifies whether the end user using the service can enter values from a mobile device. You can make most output parameters customizable by the user.
Value	The default value for the parameter set using the Service Designer. You can override these default values using the Content Manger. If you specify a default value, then Wireless does not prompt the user for a value.

1. Enter a new value, if needed, for the service in the Value field.

2. Click Next. The Async Agent screen appears.

Figure 11-8 The Input Parameters Screen of the Service Creation Wizard

Text description of the illustration con_isrv.gif

11.3.5.4 Step 4: Assigning the Async Agent to the Service.

Perform the following if you selected a master service with Async Agent capability:

1. In the Short Name field, enter a short, easily referenced name for the service. This is a required field. End users use this name to invoke services through such means as email or SMS. Wireless checks to ensure that this name is unique.

2. Enter a text delimiter in the Delimiter field. This delimiter separates the input arguments that users enter when invoking async services using such means as email or SMS. The space (" ") is the default delimiter.

3. In the Help field, enter the command syntax or usage text. This text is returned to the user when the user issues an application help command to the Async Server.

4. In the Delivery Address List section, enter the service address to which users send the service invocation messages. Enter this address in the format appropriate to the following device types. For example, enter stock@oraclemobile.com as the service address for email. This is an optional parameter.
   • SMS

   • Email

5. In the Async Agent Argument List section, set the default value for each argument. Use the Move Up and Move Down to map the async agent arguments to the service input arguments.

6. Click Submit. The browse screen reappears, displaying the new service.

Figure 11-9 The Async Services Screen of the Service Creation Wizard

Text description of the illustration con_asrv.gif

11.3.6 Editing a Service

To edit a service:

1. From the Service Browse screen, select the service you wish to edit.

2. Click Edit. The Service Editing screen appears.

   Figure 11-10 The Edit Services Screen

   
   
   Text description of the illustration con_esrv.gif

3. From the left menu, select the values that you wish to edit. For information on entering values for basic parameters of a service, see Section 11.3.5.1. For information on master services, see Section 11.3.5.2. See Section 11.3.5.3 for information on input parameters, and Section 11.3.5.4 for Async Services. See for information on configuring the

4. Click Apply to save your changes. Clicking cancel clears any changes and returns the values to their original state.

11.3.6.1 Configuring a Module Service

You can configure a module service by entering the URL of its configuration page in the Module Configure URL field of the Service Creation Wizard's Master Service screen (Step 2 in the service creation sequence). After you complete the creation of the service, you can access the configuration URL through the service editing screen.

To access a module service's configuration page:

1. Select the service.

2. Click Edit. The Service Editing screen appears.

3. From the left panel, select Master Service.

4. In the Master Service screen, click Configure. The configuration page appears.

11.3.6.2 Deleting a Service

To delete a service:

1. From the browse screen, select the service you wish to delete.

2. Click Delete.

11.3.7 Testing a Service

The Content Manager enables you to test a service and display it on a phone simulator.

To test a service:

1. From the Service Browse screen, select the service you wish to test.

2. Click the telephone icon in the Run Services column that is located in the same row as the selected service. The phone simulator appears, displaying the service.

11.3.8 Debugging Services

The Content Manager enables you to simultaneously view a service on a phone simulator and in Wireless XML or device markup languages.

Transformers, in the form of XSLT stylesheets or Java classes, convert the content returned by Wireless adapters into the format best suited to a particular platform.

To test a service:

1. On the Browse Service screen, select a service.

2. Click Debug. The Debug Service screen appears.

3. Select from among the following output formats:
   • Adapter XML Result

     Selecting this result type enables you to see Wireless source content in the AdapterResult format, the intermediary format between the source and the target output device. Source content in the AdapterResult format must be converted into SimpleResult format before it can be delivered to a target device. If no text displays in the The Result panel, then no AdapterResult has been produced.

   • Wireless XML Result

     Selecting Wireless XML Result displays the source content in Wireless' SimpleResult format of the output that is returned by an adapter.

   • Device Result

     The DeviceTransformer drop-down menu lists the logical devices in the repository. Selecting a logical device enables you to see the final markup language for that device.

4. Click Set Parameters.

5. Click Run Service. The service appears on a phone simulator. The selected result appears in the Service Result window.

Setting the Display Length of the Logging File

The System Log section enables you to set the number of lines from the end of the server's system log file that you want to see.

To set the number of lines from the server: displays from the end of the system log.

1. Enter the number of lines from the end of the system log that you want to review:

2. Click Refresh Log. The specified number of lines from the end of the system log appear.

11.3.9 Creating User Bookmarks

Using the Content Manager, you can create a bookmark, a link which gives users quick access to a URL.

To create a bookmark:

1. The Service Browse screen, click Create Bookmark. The New Bookmark screen appears displaying the following parameters:

   Table 11-5 The Bookmark Parameters

   Parameter	Value
   Service Name	The name of the bookmark. This is a required field.
   Description	A description of the bookmark.
   Sequence	The order, as specified by an integer, in which the bookmarks appear on output devices. By default, these appear in order by sequence number, then name.
   URL	The URL for the bookmark. This is a required field.
   Cost	The cost to the user for accessing the bookmark.
   Language	A drop-down list of display languages for the bookmark. Users will not be able to access this bookmark if their display language differs from that associated with this bookmark.
   MIME Type	The MIME type, such as text/html.
   Region Name	The area, such as a continent, country, or city, that is associated with the bookmark. If you assign a region to a bookmark, then users can only view that bookmark and its contents when they are in the assigned region.
   Visible	Selecting this check box makes the bookmark visible to the end user. Leaving this check box clear prevents end users from seeing or accessing the bookmark.
   Personalizable	Selecting this option enables end users to customize their user views in the Wireless Customization or on the device by reordering or hiding and showing bookmarks.

2. In the New Bookmark screen, enter the name of the bookmark in the Bookmark Name field. This is a required field.

3. Enter a description of the bookmark which is meaningful to end users in the Description field.

4. Enter an integer to assign the bookmark's ranking in a display listing.

5. Enter the URL for the bookmark. This is a required field.

6. Enter the cost to the end users for bookmark access in the Cost field.

7. From the drop-down list, select a display language.

8. Enter the MIME type.

9. Click the flashlight icon to select a region for the bookmark.

10. Click the Personlalizable check box if you want to make a service that users can customize.

11. Click Finish to complete the bookmark. The browse screen reappears displaying the new bookmark. If you do not wish to complete the bookmark, click Cancel.

11.3.10 Editing a Bookmark

The Content Manager enables you to edit an existing bookmark. To edit a bookmark:

1. In the Service Browse screen, select the bookmark you wish to edit.

2. Click the Edit button. The Edit Bookmark screen appears.

3. Edit the desired fields. For information on entering information, see Section 11.3.9.

4. Click Finish to commit your changes. The browse screen reappears displaying the edited bookmark in the list of services. If you do not wish to continue editing a bookmark, click Cancel.

11.3.11 Deleting a Bookmark

To delete a bookmark:

1. From the Service Browse screen, select the bookmark you wish to delete.

2. Click Delete.

11.3.12 Moving Folders, Services, and Bookmarks

You can organize services, folders, and bookmarks in a business context appropriate to a user group by using the Content Manager's Move function.

To move services, folders, or bookmarks:

1. From the Service Browse screen, select the folder, service, or bookmark you want to move.

2. Click Move.

3. Select the new folder for the object. If necessary, click the folder to drill down to the appropriate subfolder. Wireless tracks your position in the hierarchy through the navigation path. For more information on the navigation path, see Section 11.3.2.

4. Click Move Here. The Content Manager displays the selected object in its new folder.

11.4 Creating User Home Root Folders

The User Home Root tab enables you to group user home folders by user community or by provider. Users are assigned to these home roots in the User Manager. When a user is assigned to a user home root folder, that user's home folder becomes the child of the user home root folder by being placed within it. In addition, user home folders inherit the folder rendering style of their user home root folder.

Selecting the User Home Roots tab displays the current root folders by name, description, object ID in the database, and by the date the folder was last modified. From this screen you can create, edit, and delete user home root folders.

To create a user home root folder:

11.4.1 Step 1: Setting the Basic Parameters

1. From the User Home Roots screen, click Create. The General screen appears, displaying the following parameters:

   Table 11-6 Parameters of the Content Manager Create Folder Screen

   Parameter	Value
   User Home Root Name	The name of the user home root folder. This is a required field.
   Description	A description of the folder.
   Renderer Type	A list of the renderer types for a folder. This is a required field. These include: System: The default system object sorting styles. Custom: The object display and sorting styles of another folder or service that dictates the display logic. Inherited: The display style of an ancestor folder which has a custom renderer. If there is no ancestor folder or if the ancestor has a no custom rendering, then the default system sorting style is applied.
   Title Icon URI	The URI of an image used as the icon that appears on top of the screen when this folder becomes the current folder. You do not need to specify the format type in this URI, as Wireless selects the image format appropriate to the user's device.
   Menu Icon URI	The URI of an image used as the icon that appears next to the folder in a menu listing. You do not need to specify the format type in this URI, as Wireless selects the image format appropriate to the user's device.
   Title Audio URI	The URI of the audio file (for example, a .wav file) read aloud by voice-reader software when users access a service. You do not need to specify the format type in this URI, as Wireless selects the audio file format appropriate to the user's device.
   Menu Audio URI	The URI of the audio file (for example, a .wav file) read aloud by voice-reader software along with the service in a menu listing. You do not need to specify the format type in this URI, as Wireless selects the audio file format appropriate to the user's device.

2. Enter the User Home Root Name the Create New User Home Root section. This is a required field.

3. Enter a description.

4. From the drop-down list, select a rendering type for the folder.

5. Enter the URI of an image used as the icon that appears on top of the screen when this folder becomes the current folder.

6. Enter the URI of an image used as the icon that appears next to the folder in a menu listing.

7. Enter the URI of the audio file read aloud by voice-reader software when users access a folder.

8. Enter the URI of the audio file read aloud by voice-reader software along with the folder name in the menu listing.

9. Click Continue. The Rendering screen appears.

11.4.2 Step 2: Assigning the Rendering Options

The Rendering screen displays options specific to the rendering type you selected when setting the basic parameters for the folder. Because user home folders are the children of the user home root folders, each user home folder inherits the rendering style of its parent, the user home root folder.

Setting the System Default Rendering Options

To set the System Default rendering options:

1. Select a sorting option from the drop-down list. These options include ascending and descending sorting style for folders by:
   • ID

   • Name

   • Last Modified Date

   • Sequence Number

   • Access Count

   By default, folders appear by sequence number, then by name.

2. Click Finish.

Setting the Customized Rendering Options

To set the Custom rendering options:

1. From the Rendering screen, select a folder or service with the appropriate rendering style.

2. Click Finish.

Setting the Inherited Rendering Options

To set the Inherited rendering style:

Click Finish in the Rendering screen. The inherited rendering for a user home root folder is the system default rendering.

11.4.3 Editing a User Home Root Folder

To edit a user home root:

1. From the User Home Root screen, select a user home root folder.

2. Click Edit. The Edit Folder screen appears displaying the values for the selected subfolder.

3. From the left menu, select the parameters you want to edit.

4. Edit the appropriate values and then click Apply to commit your changes. Clicking Cancel sets the parameters back to their original values and returns you to the browse screen. For information on the basic values of a user home root folder, see Section 11.4.1. For information on the rendering options, see Section 11.4.2.

11.4.4 Deleting a User Home Root Folder

To delete a user home root:

1. From the User Home Root screen, select a user home root.

2. Select a user home root.

3. Click Delete.

11.5 Managing Alerts

Selecting the Alerts tab of the Content Manager displays the topics and alerts browsing screen. This screen enables you to search for, create, edit, move, delete, and share alerts, services that notify users of important information or events. In addition you can add topics, which group topics and alerts.

11.5.1 Searching for Topics and Alerts

Using the topics and alerts browsing screen, you can search for a topic or an alert using a search field in conjunction with drop-down lists of search options, which enable you to either narrow or broaden your searches. The search results appear as a list on the Root Topics and Services screen.

Figure 11-11 The Topics and Alerts Browsing Screen

Text description of the illustration con_alrt.gif

The topics and alerts browsing screen displays search results as follows:

Table 11-7 Elements of the Topics and Alerts Browsing Screen

Element	Description
Type	The object type. The object can be an alert, or a topic.
Name	The name of an alert or topic. Topics appears as hyperlinks; clicking a topic displays alerts and subtopics.
Object ID	The Object ID stored in the database.
Master Alert	The master alert, created by the Service Designer, on which this alert is based.
Last Modified	The last time the topic or the alert were modified.

To find a topic or an alert:

1. Perform one or more of the following:
   1. Enter the name of the alert or topic.

   2. From the drop-down list box, select the type of object:

   • Alert

   • Topic

2. Select from among the following options for to sorting options for your search results:
   • Name (Sorts search results by name.)

   • Last Modified (Sorts search results by the last time the alert, or the topic, was modified.)

3. Click Search. The Search Result screen appears.

Figure 11-12 The Search Result Screen

Text description of the illustration con_srat.gif

The Search Result screen includes the following columns.

Table 11-8 Elements of the Search Result Screen

Element	Description
Name	The name of the alert or topic.
Object ID	The Object ID stored in the database.
Full Path	The route to a alert or topic. Each topic on the route is displayed as a hyperlink. Clicking a hyperlink reveals a browse screen showing the alerts organized under the topic. You use this browse screen for such functions as creating and deleting alerts and alert topics.
Last Modified	The time the alert or topic was created, or the last time the alert or topic was edited.

11.5.2 Creating an Alert

To create an Alert:

11.5.2.1 Step 1: Entering General Alert Information

1. From the topics and alerts browsing screen, click the Add Alert button. The General screen of the Create Alert wizard appears. The screen includes the following fields:

   Table 11-9 Fields of the General Screen of the Create Alert Wizard

   Field	Description
   Alert Name	The name of the alert.
   Description	A description of the alert.

2. Enter the name of the Alert in the Name field.

3. Enter a description of the alert in the description field.

4. Click Next. The Master Alert screen of the Alert Creation Wizard appears, where you create an alert based on a master alert created by a service designer.

11.5.2.2 Step 2: Basing the Alert on an Existing Master Alert

In the Master Alert screen of the Alert Creation Wizard, you select a master alert as the base object for your alert. To select a master alert:

1. Use the radio buttons to select the master alert.

2. Click Next. The Input Parameter screen appears.

11.5.2.3 Step 3: Entering Alert Input Parameters

The Input Parameters screen displays the input parameters for the master alert selected in Step 2.

The screen contains the following master alert input parameters:

Table 11-10 The Master Alert Input Parameters

Input Parameter	Description
Name	The name of the alert. This field cannot be edited.
Caption	The caption is the label that Wireless uses for the parameter when prompting input from users while they subscribe to alerts.
Data Type	The table column data type format for the input parameter. For each master alert, the system generates a table in the database. The system generates a column within this table for each input or output parameter. The data type of an input or output parameter is used as the column data type when the system generates the table in the database. This field cannot be edited.
Value	For most parameters, this value represents the default value for the parameter set using the Service Designer. If you specify a default value using the Content Manager, then this new default value replaces the default value set in the master alert by the service designer. If a default value exists, then a user does not have to enter any information in this field when subscribing to an alert.

If needed, complete the Input Screen as follows:

1. Enter the caption for the alert in the Caption field.

2. Enter the default value for the parameter in the Value field. Leaving this field blank instructs Wireless to prompt the user to enter a value.

3. Click Next. The Trigger Condition screen appears displaying the conditions set to trigger the alert as specified in the selected master alert.

11.5.2.4 Step 4: Setting the Trigger Conditions for the Alert

You use the Trigger Condition screen to enable the end user to set the conditions that invoke an alert on the Wireless Customization. For example, if you create an alert notifying users of a stock price, you can set the alert conditions that allow an end user to request a notification when the stock has risen above, or fallen below a certain price. The Trigger Condition contains the following fields:

Table 11-11 Parameters of the Trigger Condition Screen

Field	Description
Name	The name of the alert trigger for the master alert. This field cannot be edited.
Caption	The caption is the label that Wireless uses for the parameter when prompting user input.
Comment	For master alerts, you can use this column to document the parameter. The comment is only used internally. This field cannot be edited.
Trigger Parameter	The output parameter for the alert trigger.
Condition Type	The condition, in relation to the value set by you or the end user, which triggers the alert. This field cannot be edited.
Value	The default value for the parameter set using the Service Designer. You can override this value using the Content Manager. If you specify a default value, then the user does not have to enter any information for this trigger value when subscribing to an alert.

To set the trigger conditions for an alert:

1. Enter a caption describing the trigger in the Caption field.

2. Enter a value that relates to the predetermined condition type in the Value field.

3. Click Submit to complete the alert. Click Back to return to edit data entered in Steps 1 - 4. Clicking Cancel at any point terminates the wizard and clears all entries.

11.5.3 Editing an Alert

The Content Manager enables you to edit an alert.

To edit an alert:

1. In the Topic-Alert browsing screen, locate the topic containing the alert you wish to edit.

2. Select the alert.

3. Click Edit. The Edit Alert screen appears.

4. From the left menu, select from among the following alert components that you wish to edit.

5. Edit the alert as needed. See Section 11.5.2.1 for information on entering the basic information for an Alert. See Section 11.5.2.2 for selecting a master alert. For information on the input parameters, see Section 11.5.2.3. See Section 11.5.2.4 for information on trigger conditions for an alert.

6. Click Apply to commit your changes.

11.5.4 Deleting Topics and Alerts

To delete a topic or an alert:

1. From the Topic-Alert browsing screen, select the topic or alert.

2. Click Delete.

11.5.5 Moving Alerts

The Content Manager enables you to move alerts and topics, allowing you to organize the wireless portal in a business context.

To move alerts:

1. From the Top-Alert browsing screen, select the alert you wish to move.

2. In the Move Alerts screen, drill down to a destination topic for the alert.

3. Click Move Here.

4. The Alert-Topic browse screen reappears, showing the new destination topic as the current context topic. The alert displays in the table. Clicking the destination topic reveals the alert in its new location. Clicking Cancel while you are in the Move Alerts screen terminates the operation and returns you to the Topic-Alert browsing screen.

11.5.6 Creating a Topic

You can further organize your alerts by creating Topics.

To create a subtopic:

1. From the Topic-Alert browsing screen, click Add Subtopic. The New Subtopic screen appears.

2. Enter a topic name.

3. Select the Visible to make the subtopic visible (and accessible) to the end user.

4. Click Add.

11.5.7 Editing a Topic

To edit a Topic:

1. From the Topic-Alert browsing screen, select a subtopic.

2. Click Edit. The Edit Subtopic screen appears.

3. Edit the subtopic as needed. See Section 11.5.6 for information on subtopic parameters.

4. Click Apply.

11.5.8 Assigning Folders, Services, Bookmarks, and Alerts to User Groups

The Group tab enables you to assign folders, services, and bookmarks to user groups.

To make an object available to a group:

1. From the Groups screen, select the group to which you want to assign the object.

2. Click Assign Services. The Service Content screen appears.

3. From the Available Services section, select the objects that you want to assign.

4. Click Add To Group.

11.5.9 Removing Folders, Services, and Bookmarks from User Groups

The Content Manager enables you to remove services and folders from user groups.

To remove an object from a user group:

1. From the Group Accessible Service section of the Service Content screen, select the object that you want to remove.

2. Click Remove From Group.

11.5.10 Assigning Alerts and Topics to a User Group

The Group tab enables you to assign alerts and topics to user groups, making them available to several users.

To make an alert or topic available to a group:

1. From the Groups screen, select the group to which you want to assign the object.

2. Click Assign Alerts.

3. From the Available Alerts section, select the objects that you want to assign.

4. Click AddToGroup.

11.5.11 Removing Alerts and Topics from User Groups

The Content Manager enables you to remove alerts and topics from user groups.

To remove an alert or topic from a user group:

1. From the Group Accessible Alerts section, select the object that you want to remove.

2. Click RemoveFromGroup.