7
Managing Logical Devices

This chapter describes how Content Developers use the Service Designer to create and manage logical devices in the repository. Each section of this document presents a different topic. These sections include:

• Section 7.1, "Overview of the Service Designer"
• Section 7.2, "Logging into the Service Designer"
• Section 7.3, "What is a Logical Device?"

7.1 Overview of the Service Designer

The Service Designer is a Web-based interface that enables Content Developers to create a logical devices, repository objects that represent either a physical device, such as an Ericsson mobile phone, or an abstract device, such as an email server. Logical devices represent the interface between transformers and the target devices or applications.

In addition, the Server Designer enables developers to create the following repository objects. For more information on these objects, refer to the Getting Started and System Guide for Oracle9iAS Wireless.

Master Services

Master services provide the actual implementation of the service. They specify the adapter used for the service and any service-specific parameters. By mapping an adapter to device transformers, master services link Wireless content sources to delivery platforms. Each master service is based on one adapter. A master service creates its own instance of the adapter it uses. Therefore, several services can use the same type of adapter, and each can pass its own service-specific argument values.

Content Managers create services based on master services and assign them to user groups.

Asynchronous Agent Services

The Service Designer enables you to augment master services by making them accessible by protocols other than HTTP. For example, you could assign an asynchronous agent service for services accessed by users whose devices do not have a Web browser, but support two-way messaging or email.

With asynchronous agent-enables services, users can access Web content. For example, asynchronous agent services enable end users who subscribe to OracleMobile to retrieve such Web content as stock quotes, traffic reports, or horoscopes by sending a message to [e-mail]. The Ask listener running on the iAS Wireless Server intercepts this message, which can be either an email or a short message, routes the request to the correct service or application, and then sends the requested information back to the user.

Master Alerts

A master alert is a template for an alert, a notification service delivered to users based on the trigger conditions they set when subscribing to an alert service. Master alerts designate the data feeders used for an alert service as well as the trigger parameter definition, trigger condition definition and optionally input parameter definition for an alert service. In addition, the master alert presents a simple result XML message template.

An alert service can deliver alert messages which are drawn from data feeds on a determined value, or at a scheduled time.

The default delivery mechanism of the alert message is through the transport module. The alert engine may provide hooks to invoke a customized message delivery mechanism to handle the alert delivery event.

Data Feeder

A data feeder is a repository object that retrieves content from both internal and external content sources and then converts that content into a standard XML format. The data feeder mechanism then publishes the content to the alert engine, which formats and sends alert messages that use the content that the data feeder retrieved and rendered from the content source.

Preset Definitions

Presets enable users to personalize services by defining their own input parameters for an application. When a user requests a service, an adapter loads the user-defined input parameters, or presets. The service presents these presets as a list for the user, who must then select an item to execute the application. Wireless saves users presets on a table specific to each service.

Transformers

Transformers are Java programs or XSLT stylesheets that convert a document into either the target format or to another Wireless format. Transformers not only map source tags to target format tags, but they can also manipulate content. Because transformers can rearrange, filter, and add text, you can present content in the format, as well as the form factor that is best suited for the target device.

The Wireless initial repository includes transformers for several target formats, such as CHTML, HDML, HTML, MML, VoiceXML, VoxML, and WAP (WML). By modifying the provided transformers, or by creating new ones, you can target new device platforms and optimize content presentation for specific devices. Wireless publishes device transformation rule files so that anyone can create support for any type of device and markup language.

The transformer associated with a logical device is that device's default transformer. Default transformers are typically generalized for a markup format, but they can also be specific to a target device. Wireless uses the device's default transformer to convert any service targeted for that type of device, unless a custom device transformer overrides the default transformer. A custom device transformer enables you to control how a service appears on a specific device. While several devices can use a single default transformer, a custom transformer can be associated with only one master service and one device. The custom transformer optimizes the presentation of that service for a particular device and can only be used for that device.

When you create a transformer, you map the elements in the source content to the result format.

Adapters

An adapter is a Java application that retrieves data from an external source and renders it in Wireless XML. In the Oracle9iAS Wireless architecture, adapters constitute the interface between the Wireless server and the content source. When invoked by a master service, an adapter returns an XML object that contains the service content. This XML object is processed by the core of the Wireless and then delivered to the user's device as a the response to the user's service request.

Regions

Wireless uses regions to enable developers to assign a location to a service, making the service location-based, unique to a specified area.

7.2 Logging into the Service Designer

Before using the Service Designer, you must first log in to the Webtool 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.)

After you successfully login, the Service screen of the Service Designer appears with the Service Designer Tab selected. The Service Designer Tab contains the following subtabs:

• Master Services
• Data Feeders
• Master Alerts
• Data Feeders
• Logical Devices
• Preset Definitions
• Transformers
• Adapters
• Regions

The Service Designer provides a tab for each of these repository objects. Each tab has a browsing screen, which enables you to search for an object, as well as access to functions for creating, editing and deleting, and testing objects.

Figure 7-1 The Browse Folder Screen of the Service Designer's Master Service Tab

Text description of the illustration cdv_brow.gif

7.3 What is a Logical Device?

A logical device is an object in the Wireless repository that represents either a physical device, such as a Nokia mobile phone, or an abstract device, such as email. Logical devices represent the interface between Wireless transformers and the target devices or applications.

Wireless determines the type of device that is requesting a service from the HTTP header. A device agent identifies the user's device address, such as an email address or telephone number and device type. This information enables Wireless to deliver notifications to the user.

Wireless includes a default set of logical devices which represent several different device types and formats. If you wish to create a device, that is one not included in the default set, then you must use the Service Designer.

To access the functions to create a logical device, you click the Logical Devices tab. When you click the Logical Device tab, the Browse Logical Devices screen appears, displaying a list of logical devices in the repository. Using the Browse Logical Device screen, you can search for, create, delete, and edit the user agents of a logical device.

Figure 7-2 The Browse Logical Devices Screen

Text description of the illustration cdv_brlo.gif

7.3.1 Searching for a Logical Device

From the Browse screen, you can search for logical devices using the Keyword field. You can sort your search results by name, user agents, or transformers.

To search for a logical device:

1. Select, if needed, one of the following search result sorting options:
   • Name
   • Transformers
   • User Agents
2. Enter the keyword for your search.
3. Click Go. The Search Results screen appears. To return to the Browse screen, click OK.

Figure 7-3 The Search Results Screen (for Logical Devices)

Text description of the illustration cdv_sldv.gif

7.3.2 Creating a Logical Device

You create a logical device using the logical device creation wizard. The logical device creation wizard guides you through each step of creating a logical device. When you complete a screen, you move to the next screen in the sequence by clicking the Next button. Clicking the Back button takes you to the preceding screen in the sequence, allowing you to perform edits.

7.3.2.1 Step 1: Entering the Basic Information for the Logical Device

1. From the Browse Logical Devices screen, click Create Logical Device. The Basic Info. screen appears displaying the following parameters:

Table 7-1 Parameters of the Logical Device Creation Wizard Basic Information Screen

Parameter	Value
Name	The name of the logical device.
Description	An optional description of the logical device
Encoding	The logical device's content encoding, which is used to transport the result of the device type.
Preferred MIME Type	The MIME-type of the logical device. At runtime, if Wireless cannot detect a user agent HTTP header, the Wireless fails over to another device in the database that has the same MIME type.
Device Class	A Drop-down list of device types. The menu includes the following: VOICE MICRO_BROWSER PDA_BROWSER PC_BROWSER MICRO_MESSENGER MESSENGER
Prolog	Specifies the format of the prolog required by the device. The prolog frequently includes processing instructions and meta tags.

• Enter the name of the logical device into the Name field. This name must be unique. For example, enter Email.
• Enter, if needed, a desciption of the device.
• Enter the content encoding parameters for the logical device. For example, enter UTF-8.
• Enter the MIME type in the MIME field. For example, enter text/html.
• From the Device Class drop-down list, select the appropriate display size of the user's device.
• Enter the prolog required by the device.
• Click Next. The Transformers screen appears.

7.3.2.2 Step 2: Selecting the Appropriate Transformers

1. From the Transformer screen, select transformers appropriate to the MIME type of the logical device from Eligible Transformers to Selected Transformers using the Move functions (>>or >>). Use the Remove functions (<< or <<) to remove the transformers you do not wish to use from Selected Transformers.
2. Click Next.

7.3.2.3 Step 3: Adding User Agents

The User Agent screen enables you to assign a user agent to the logical device by selecting from a list of user agents, mechanisms that identify device type and address.

To add a user agent.

1. Enter the user agent name. For example, enter WIG Browser/1.1*
2. If needed, click Add Another Row to add another user agent.
3. Click Next. The Device Attributes screen appears, displaying the following parameters:

Table 7-2 Parameters of the Device Attributes Screen

Parameter	Value
Maximum Native Document Size	The maximum number of bytes that can be sent to the device. This is a guideline for caption lengths.
Display Properties
Screen Width	Use this option to describe the width of the screen of the physical device in points.
Screen Height	Use this option to describe the height of the screen of the physical device in points.
Screen Columns	The screen size in characters. Use this option if you want to break text into pages.
Screen Rows	The screen size in characters. Use this option if you want to break text into pages.
Number of Softkeys	Allows users to map a hot link to a phone soft key.
Supports Cookie
Color Capable	Select this check box to create a device that supports color.
Bits per Pixel	The number of bits of color or grayscale information per pixel.
Voice Capable	Select this check box to create a device that supports voice.
Image Capable	Select this check box for a device that supports images. Use the Move functions (> or >>) to select the preferred image formats from Available Formats. Use the Remove functions (< or <<) to remove the image formats you do not wish to use from Preferred Formats.
Video Capable	Select this check box for a device that supports video. Use the Move functions (> or >>) to select the preferred video formats from Available Formats. Use the Remove functions (< or <<) to remove the video formats you do not wish to use from Preferred Formats.
Streaming	Select this radio button for real-time video. You can only select this option if you have selected Video Capable.
Buffered	This option essentially acts as a time-delay, storing bits of incoming video data before playing them. Using this option ensures a smooth presentation, one in which users see all frames. You can only select this option if you have selected Video Capable.

7.3.2.4 Step 4: Setting the Device Attributes for the Logical Device

Complete the Device Attributes screen as follows:

1. Enter the Maximum Native Document Size.
2. Set the display properties as follows:
   1. Enter the points for the screen width.
   2. Enter the points for the screen height.
   3. Enter the number of screen columns.
   4. Enter the number of rows.
   5. Enter the number of softkeys that the end user can use to create short-cuts.
3. Select the Color Capable check box if the device supports color.
4. Enter the number of bits per pixel.
5. Select the Voice Capable check box if the device supports audio.
6. Select the Image Capable box if the device supports images.
7. Use the Move functions (> or >>) to select the preferred image formats from Available Formats. Use the Remove functions (< or <<) to remove the image formats you do not wish to use from Preferred Formats.
8. Select the Video Capable check box if the device supports video.
9. Select this check box for a device that supports video. Use the Move functions (>or >>) to select the preferred video formats from Available Formats. Use the Remove functions (< or <<) to remove the video formats you do not wish to use from Preferred Formats.
10. Select the Streaming option for real-time video. You can only select this option if you have selected Video Capable.
11. Select the Buffered option for storing bits of incoming video data before playing them. Using this option ensures a smooth presentation, one in which users see all frames. You can only select this option if you have selected Video Capable.
12. Click Next. The User Agents screen appears.

7.3.2.5 Step 5: Creating the Login Page

The Login Page screen enables you to create the XSLT stylesheet that generates the login page on the device.

1. Provide a stylesheet using one of the following methods:
   1. Enter the XSLT stylesheet manually into the Login Page field.
   2. Copy the XSLT stylesheet from a text editor into the Login Page field.
   3. Import the XSLT stylesheet by clicking Import. In the Import screen, enter the name of the file in the Import File field and then click Import, or retrieve the file using the Browse function and the Upload window. After you select the file, Click Open. From the Import Screen, click Import.
2. Click Next. The Error Page screen appears.

7.3.2.6 Step 6: Creating the Error Page

The Error Page screen enables you to create an XSLT stylesheet that generates the error page for the device.

1. Provide a stylesheet using one of the following methods:
   1. Enter an XSLT stylesheet manually into the Login Page field.
   2. Copy an XSLT stylesheet from a text editor into the Login Page field.
   3. Import the XSLT stylesheet by clicking Import. In the Import screen, enter the name of the file in the Import File field and then click Import, or retrieve the file using the Browse function and the Upload window. After you select the file, Click Open. From the Import Screen, click Import.
2. Click Finish to complete the logical device.

7.3.3 Modifying a Logical Device

The Wireless Service Designer enables you to modify a logical device in the repository. To modify a logical device:

1. From the Browse Logical Device screen, select the logical device you wish to edit.
2. Click Edit. The Edit Logical Device screen appears. From the left menu, select the component of the logical device you wish to edit. For information on setting the values for the basic information of a logical device, see Section 7.3.2.1. See Section 7.3.2.2 for information on selecting transformers. See Section 7.3.2.4 for setting the device attributes. See Section 7.3.2.3 for selecting or adding user agents. For information on creating a login page, see Section 7.3.2.5. See Section 7.3.2.6 for information on creating the error page.
3. Click OK to commit your changes.

7.3.4 Deleting a Logical Device

To delete a logical device from the repository:

1. From the Browse Logical Device screen, select the logical device.
2. Click Delete.