6 Managing Content

6.3.1 Searching for Repository Objects

The browsing page s search function enables you to search for and display the following repository objects:

• Application

• Asynchronous Application

• Bookmark

• Folder

The search field, when used in conjunction with the Type and Category lists, enable you to narrow your searches to a specific type and category. The results display in the Search Result page, which is described by Table 6-2.

6.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 link, allowing you to "drill down" or traverse deeper into the hierarchy with each successive click. OracleAS Wireless displays the structure of the hierarchy as a navigation path (Figure 6-3), enabling you to see the level that you currently access and to move back to any previous folder in the hierarchy.

Figure 6-3 The Navigation Path

Description of "Figure 6-3 The Navigation Path"

Creating a folder 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.

6.3.2.1 Step 1: Defining the Basic Parameters for a Folder

From the browsing page, click Add Folder. The General page appears, displaying the basic parameters of the folder (described in Table 6-3)

Table 6-3 Parameters of the Content Manager Create Folder Page

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 applications 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 applications and folders appear. By default, OracleAS Wireless sorts applications and folders in ascending order by sequence number, then by name.
Language	A drop-down list of display languages for the folder. Any applications or subfolders contained in this folder must have the same display language. Users cannot 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. These include: System: The default system object sorting styles. Custom: The object display and sorting styles of another folder or application 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. This is a required field.
Title Icon URI	The URI of an image used as the icon that appears on top of the page when this folder becomes the current folder. You do not need to specify the format type in this URI, as OracleAS 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 OracleAS 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 OracleAS 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 OracleAS 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 its contents are neither visible nor accessible to the end user.
Personalizable	Selecting this option enables end users to customize their user views using the OracleAS Wireless Customization or from the device by reordering, hiding, or showing this folder.

Figure 6-4 The Create Folder Page (General Parameters)

Description of "Figure 6-4 The Create Folder Page (General Parameters)"

6.3.2.2 Step 2: Assigning the Rendering Options

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

Selecting the System Rendering Options

If you select System as the rendering option, then you can select from among the following sorting options that include the 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.

Setting the Customized Rendering Options

If you select the Custom rendering options, then you select a folder or application with the appropriate rendering style.

Setting the Inherited Rendering Options

If the folder is not a child of another folder (or if none of its ancestor folders have a customized renderer), then OracleAS Wireless notes the inherited renderer as N/A until the folder is moved under a parent folder with a customized renderer. Use the Move function to place the folder within a folder configured with the appropriate rendering style. See Section 6.3.10 for information on moving objects.

Figure 6-5 The Folder Rendering Page

Description of "Figure 6-5 The Folder Rendering Page"

6.3.3 Editing a Folder

The Edit button enables you to modify the values for a selected folder. After you have modified the appropriate values, click Apply to commit your changes. Clicking Cancel sets the parameters back to their original values and returns you to the browse page. See Section 6.3.2.1 for information on the basic folder parameters. See Section 6.3.2.2 for information on the folder rendering options.

6.3.4 Creating an Application Link

You create an application link (also known as an application) to publish a master application to users. The master application, which is created using the Service Manager, formss the core of the application link. By clicking Add Application, you can create an application link using a wizard which guides you through each step of the creation process, from the first step of basing the application link on an existing master application, to the steps that follow for setting the general information for the application and editing or adding input parameters.

If you base the application link on an asynchronous-enabled application, then you can assign Async Agent properties to the application link, thus enabling customers to access the application using asynchronous messaging technologies such as SMS, e-mail or two-way pagers.

Step 1: Selecting a Master Application

From the Master Application page, you can select a master application as the basis for the application link. This master application is the core functionality of the application link.

Step 2: Entering the General Information

The General page enables you to set such basic information for the application link, such as the name for the application and the short names for the application (if it is based upon an asynchronous-enabled master application). A short name is an easily referenced name for the application entered by end users when accessing applications from asynchronous devices. Use the Up and Down arrows to prioritize the order in which these short names appear in a help message.

Selecting DRM Policies for a J2ME Application

If this application link is based on a J2ME application, then you can also select a DRM (digital rights management) policy, which controls the digital rights of the J2ME application by defining the user access to the application. For example, a digital rights policy can restrict the user's access to a downloaded application to a certain time period, (as in the case of a trial period), or can limit the number of times a user can download an application. The DRM policies are created by Foundation Developers. For more information, see Section 8.7.

Step 3: Entering New Input Parameters for the Application Link

The Input Parameters page enables you to set the input parameters for your application link. The input parameters for the application link are those set for the master application on which you based your application link. You can only change the parameters which the Application Developer designated as Modifiable. For more information on creating master applications, see the Oracle Application Server Wireless Developer's Guide.

Table 6-4 describes the input parameters included in the Input Parameters page.

Step 4: Assigning the Asynchronous Capabilities to the Application Link.

Use this page to assign the Async Agent capabilities to application. To use this page, you must base the application link on an asynchronous-enabled master application.

Table 6-5 describes the parameters for Async Agents.

6.3.5 Editing an Application Link

The editing page enables you to change or update the parameter values for a selected application link. To access the editing page, select the application link in the browsing page and then click the Edit button. From the editing page's menu, you can select the values that you want to edit, such as those for the general parameters, the input parameters, the Async-agent parameters (if applicable), and the additional parameters (Step 2 through Step 4 of the wizard). You cannot change the master application on which the application link is based.

6.3.6 Testing an Application Link

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

To test an application link:

1. From the browsing page, select the application link that you wish to test.

2. Click the telephone icon in the Run Application column, which is located in the same row as the selected application link. The phone simulator appears, displaying the application link.

6.3.7 Debugging an Application Link

The Content Manager enables you to simultaneously view an application link on a phone simulator, in OracleAS Wireless XML, or device markup languages.

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

To test a service:

1. On the browsing page, select an application link.

2. Click Debug. The Debug Application Link page appears.

3. Select from among the following output formats:

   • Adapter XML Result

     Selecting this result type enables you to see OracleAS Wireless source content in the AdapterResult format, the intermediary format between the source and to that of 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 Result panel, then no AdapterResult has been produced.

   • OracleAS Wireless XML Result

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

   • Device Result

     The Device Transformer menu lists the devices in the repository. Selecting a device enables you to see the final markup language for that device.

4. Click Set Parameters.

5. Click Run Application. The application link appears on a phone simulator. The selected result appears in the Application 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 view.

To set viewing options:

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.

6.3.8 Creating User Bookmarks

The Content Manager enables you to create a bookmark, a link enabling the user to quickly access an external resource, such as a Web page. In addition to providing the user a this shortcut, OracleAS Wireless enables you to create bookmarks that render their content on a variety of devices.

With OracleAS Wireless, a bookmark displays equally well on all of the different devices registered to a OracleAS Wireless user, because you can associate multiple URLs with a single bookmark. Each of these URLs supplies the markup suitable to the content type supported by the requesting device.

For example, you create a bookmark, myoracleBK, which has the following two URLs:

• www.oracle.com with the text/html MIME type

• wap.oracle.com with the text/hdml MIME type

Logging in through a desktop browser, a user sees myoracleBK. Clicking this bookmark reveals the page www.oracle.com.

A user logging in from a device supporting the text/hdml MIME type also sees myoracleBK, but clicking this bookmark reveals the page wap.oracle.com

Clicking Add Bookmark in the browsing page invokes the New Bookmark page, which includes the parameters described in Table 6-8.

In addition to these parameters, (whose values define the basic settings for the bookmark), the New Bookmark page also includes a table listing URLs and MIME types that you associate with this bookmark. This table also notes the default MIME type, which you can set by selecting a MIME type and then by clicking Set Default.

You can add other URLs or MIME types to the table by first clicking the Add button and then by defining the values for URL and MIME type in the following page (Figure 6-6.)

Figure 6-6 Adding a New MIME Type

Description of "Figure 6-6 Adding a New MIME Type"

6.3.9 Editing a Bookmark

The Edit Bookmark page, which enables you to alter a bookmark, which you access by selecting a bookmark and then by clicking Edit.

6.3.10 Moving Folders, Application Links, and Bookmarks

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

To move application links, folders, or bookmarks:

1. From the browsing page, select the folder, application link, or bookmark that 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. OracleAS Wireless tracks your position in the hierarchy through the navigation path. For more information on the navigation path, see Section 6.3.2.

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

6.4.1 Creating a Notification

By clicking the Quickly Create Notification button in the browsing page, you create a notification using a wizard that provides a separate page for each step of the creation process.

<SimpleResult>
   <SimpleContainer>
      <SimpleText>
      <SimpleTitle>OracleAS Wireless</SimpleTitle>
      <SimpleTextItem>Notification with price: $price; and change: $change: for stock: &sym;</SimpleTextItem>
      </SimpleText>
    </SimpleContainer>
</SimpleResult> 

6.5.1 Managing a User Group

Clicking the Access Control Content tab invokes the Groups page (Figure 6-7), which includes a table listing the current user groups. From this table, you can select a user group (using the Select button) and then edit it, delete it, or manage the objects assigned to it.

Figure 6-7 The Groups Page

Description of "Figure 6-7 The Groups Page"

Table 6-11 describes the fields and functions of the Groups page.

6.5.2 Managing the Contents of a User Group

To manage the contents of a user group, select the group and then click Assign Applications. The Application Content page for the selected groups appears (Figure 6-8, displaying the objects currently associated with the groups as well as the objects which can be assigned to the group. From this page, you can assign selected application links, bookmarks, or alerts (notifications) to a user group, or remove them from a user group by clicking either the Add to Group or Remove from Group buttons. Clicking Finish saves the changes made to the contents of a user group.

Figure 6-8 The Application Content Page

Description of "Figure 6-8 The Application Content Page"

6.6.1 Editing a User Home Root Folder

You can edit both the general parameters and the rendering options for a selected user home root folder. To do this, select a folder from the table in the User Home Roots page and then click Edit. The editing page appears and defaults to the general parameters set for the selected user home root folder. If you wish to edit the rendering options, select Rendering from the menu. Click Apply to save your changes. Clicking Cancel sets them back to their previous values.

6.6.2 Deleting a User Home Root Folder

You can delete a user home root folder by first selecting from the table in the User Home Roots page and then by clicking Delete.

6.7.1 Creating an Application Link Category

In the Create Application Category page, enter a name for the application link category. For example, enter Premium. This is a required field. If needed, enter a description. You then associate an access point with the category, thereby making all of the applications associated with this category accessible through the selected access point. (The access points are created using the System Manager. For more information, see Section 6.7.1.1). If needed, click Add to select additional access points.

6.7.2 Assigning Applications to an Application Link Category

After you create an application category, you add asynchronous applications to the application category. To do this, select an application from the browsing page of the Publish Content tab and then click Categorize. In the following page, use the Move arrows (> and >>) to move an application from the All Application Categories pane to the Associated Application Categories pane. To remove an application link from an application link category, use the Remove arrows (< and <<) to move the selected application link category from the Associated Application Category pane to the All Application Categories pane.

6.7.3 Adding SMS Routing Information

You can add SMS routing information when creating (or editing) Premium SMS-enabled application links. For example, you can assign the value of the Large Account, to which the reply message should be charged, to the Channel field. For more information, see Section 6.3.4.