Skip Headers

Oracle9iAS Wireless Developer's Guide
Release 2 (9.0.2)

Part Number A90485-02
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

17
Mobile Studio

Each section of this document presents a different topic. These sections include:

Figure 17-1 Mobile Studio

Text description of feature9.gif follows.

Text description of the illustration feature9.gif

17.1 Oracle9iAS Wireless Mobile Studio Overview

This chapter introduces Oracle9iAS Wireless Mobile Studio. Oracle9iAS Wireless Mobile Studio is a 100% online, hosted environment for developing, testing, and deploying mobile applications for the Oracle9iAS Wireless platform. It also serves as a web portal, supporting the wireless developer community in the enterprise and on the Internet.

The Studio offers developers a simple, intuitive, easy-to-use web-based user interface to facilitate rapid configuration, testing, and deployment of Oracle9iAS Wireless XML applications. Developers need not download or install anything on their workstations; all they need is a web browser and access to the Studio server. Once the XML content is registered with the Studio, the developer can test their application using any mobile device or simulator (including voice), and can instantly access debug log information in the Studio. Once the application is successfully tested, the developer may choose to deploy it to a production server with the click of a button.

Service providers can brand the Studio and customize its look-and-feel and content in order to integrate it with their existing site. The Studio's intuitive administrator interface allows web masters to rapidly create a compelling developer portal that can serve both as an interactive development tool and as a one-stop source for up-to-date information and collateral on the wireless server platform. This makes it easy for service providers to support their developer community and attract new developers.

Key features for developers are:

Key features for service providers are:

17.2 Getting Started

17.2.1 Login and Registration

Once Oracle9iAS Wireless has been successfully installed, the Studio is immediately available for use without any further configuration. Use any web browser (e.g. Netscape 6.2 or Internet Explorer 6.0) to access the Studio main page at the following URL:

http://<studio_server>:<studio_port>/studio

where <studio_server> and <studio_port> are the name of the host running the Studio instance and the dedicated Studio port number, as configured in the Oracle Installer during the installation process.


Note:

The Studio has been optimized for the latest versions of the popular Netscape and Internet Explorer browsers. In particular, the Studio is not certified for Netscape 4.x or Internet Explorer 4.x.


If Oracle9iAS Wireless was installed correctly, the above URL takes you to the Studio login screen:

Figure 17-2 Login page

Text description of studio1.gif follows.

Text description of the illustration studio1.gif

From this screen, users can:

Figure 17-3 Registration page

Text description of regis.gif follows.

Text description of the illustration regis.gif


Note:

Single Sign-on (SSO): User profile information (including user ID and password) is stored in an Oracle Internet Directory (OID) repository and is shared by all SSO-enabled applications, including Oracle9iAS Wireless and all its components (such as Oracle Portal, etc.).


Additional configuration steps are required to enable single sign-on (SSO) support for the Studio. See Section 17.3, "Studio Configuration" for details.

17.3 Studio Configuration

To run the studio application successfully, you must configure certain parameters.

These parameters can be edited using the Mobile Studio Administration UI at this URL: http://myserver.myCompany.com:myport/studio/admin/config.jsp

Table 17-1 Parameters that must be configured
Name Description Example

deploy.ptg.url

Contains the URL of the remote Oracle9iAS Wireless server, to which the studio applications are deployed.

http://myserver.myCompany.com:myport/studio

samples.source.root.path

Contains the path to the folder which contains all the sample JSPs.

<WIRELESS_HOME>/wireless/j2ee/applications/studio/studio-web/samples

17.3.1 Sample Applications Configuration

New sample applications can be added to Mobile Studio using the Mobile Studio Administration UI.

Adding a sample applications involves following steps:

  1. Create a sample JSP file that is Mobile XML compliant.

  2. Store the sample JSP file in the samples root folder (this is same as the samples.source.root.path parameter listed above).

  3. Create a new Sample Application using the Mobile Studio Administration UI.
    Table 17-2 Mobile Studio JSPs
    JSP JSP JSP JSP

    login.jsp

    loginPortlet.jsp

    pageMenu.jsp

    pagePortlets.jsp

    loginInfoBox.jsp

    home.jsp

    createService.jsp

    editService.jsp

    deployService.jsp

    deployedServiceList.jsp

    profile.jsp

    domains.jsp

    registration.jsp

    newFolder.jsp

    editFolder.jsp

    moveOrCopy.jsp

    sendMessage.jsp

    viewLog.jsp

    quicklink.jsp

    samplesSource.jsp

    pageHeader.jsp

    pageFooter.jsp

17.3.1.1 login.jsp

This is the first page users see when opening the Mobile Studio URL; users can log in Mobile Studio via this page.

If users try to access other pages without logging in, they will be redirected to this page, and instructed to log in before proceeding.

Users can take these actions from this page:

Figure 17-4 Login page

Text description of studio1.gif follows.

Text description of the illustration studio1.gif

Table 17-3 Resources
Name Description Example

login.text.info

informational text

Oracle9iAS Wireless Mobile Studio is an online environment for quickly building, testing and deploying wireless applications.

login.text.title

page title

Welcome to Oracle9iAS Wireless Mobile Studio.

login.text.boxinfo

informational text in box

You can use Oracle9iAS Wireless Mobile Studio to write a single application that can be accessed via both wireless and voice interfaces.

login.text.boxtitle

box title

Developing Voice Applications

login.image.frontpage

340x340 splash image on login page

/images/frontpage.gif

Table 17-4 Action Fields
Name Type Description Condition

UserId

Input field

ID for the user.

Must be a valid user ID.

Password

Input field

Password for the user.

Must be a valid password.

Login

Button

Submits the login form.

Userid and password fields must not be empty.

Register

Link

Directs user to registration page.

17.3.1.2 loginPortlet.jsp

This page is included inside login.jsp. It contains a form for the user to complete for login.

Figure 17-5 loginPortlet

Text description of studio1a.gif follows.

Text description of the illustration studio1a.gif

Table 17-5 Resources
Name Description Example common.href.login

URL for the login page

login.jsp

common.label.login

label for login button

Log In

common.label.password

label for password text input field

Password

common.label.register

label for register button

Register

common.label.userid

label for userID text input field

User ID

common.title.login

portlet title text

Log In

17.3.1.3 pageMenu.jsp

This page is included inside login.jsp. It provides a link to different pages for users to browse.

Figure 17-6 pageMenu.jsp

Text description of studio3.gif follows.

Text description of the illustration studio3.gif

Table 17-6 Resources
Name Description Example common.label.home

Label for home button.

My Studio

common.label.domains

Label for domains button.

My Domains

common.label.profile

Label for profile button.

My Profile

common.label.glossary

Label for Tag glossary button.

Tag Glossary

common.label.help

Label for documentation button.

Documentation

common.label.logout

Label for logout button.

Log Out

common.href.home

Link to home page.

home.jsp

common.href.domains

Link to domains page.

domains.jsp

common.href.profile

Link to profile page.

profile.jsp

common.href.glossary

Link to Tag glossary page.

tagglossary.htm

common.href.help

Link to documentation page.

openHelpwindow()

common.href.logout

Link to logout page.

logout.jsp

Table 17-7 Action Fields
Name Type Description Condition

My Studio

Link

Directs user to Home page.

User should login first.

My Domains

Link

Directs user to Domain page.

User should login first.

My Profile

Link

Directs user to Profile page

User should login first.

Tag Glossary

Link

Directs user to Tag Glossary (wealth of information on Tags)

Help

Link

Directs user to help page.

Log Out

Link

Logs user out.

17.3.1.4 pagePortlets.jsp

This page is included inside login.jsp. It displays 2 portlets:

Figure 17-7 pagePortlets page

Text description of studio4.gif follows.

Text description of the illustration studio4.gif

Table 17-8 Resources
Name Description Example

common.title.sms

The title for short messaging

Short Messaging

common.text.sms

Informational text.

Click here to try the Oracle9iAS Wireless short messaging service.

sms.link.name

URL for short message page.

sendMessage.jsp

common.image.icon.sms

Image for the sms.

/images/icon_sms.gif

common.title.forum

Title of the forum portlet

Discussion forum

common.text.forum

The text for the forum portlet.

Click here to participate in the Oracle9iAS Wireless online discussion forum.

common.href.forum

The URL of the forum.

discuss.jsp

common.image.icon.forum

The image for the forum.

/images/icon_forum.gif

Table 17-9 Action Fields
Name Type Description

Condition

Short messaging

Link

Directs user to Short messaging page.

User must be logged in first.

Discussion Forum

Link

Directs user to discussion forum.

17.3.1.5 home.jsp

This is the main user page; it is the first page that a user sees when logging in. These are the Actions available from the home.jsp page

Table 17-10 Actions available from home.jsp page.

17.3.1.6 createService.jsp

Create a new service based on the information provided by the user.

Table 17-14 Resources
Name Description Example

createService.body.title

The body title for creating applications.

Create Application

common.labels.Name

The label for name field.

Name

editService.labels.name.hint

The hint for name field.

A short name for your Application.

common.labels.RemoteURL

The label for Remote URL field.

Remote URL

editService.labels.RemoteURL.hint

The hint for Remote URL field.

The URL of XML document that implements your application.

common.labels.Comments

The label for Comments.

Comments

editService.labels.comments.hint

The hint for comments field.

Comments about your application for your convenience.

common.labels.Keywords

The label for keywords.

Keywords

createService.labels.keywords.hint

The hint for keywords field.

Search keywords for your application.

common.labels.Description

The label for Description field.

Description.

common.labels.description.hint

The hint to the user for the description field

A short description for your application.

common.buttons.label.Create

The label for Create Button.

Create

common.buttons.label.Cancel

The label for Cancel Button.

Cancel

Table 17-15 Action Fields
Name Type Description Condition

Name

Input

Enter the name of the application.

Cannot be left empty

URL

Input

Enter the URL of the application

Cannot be left empty

Description

Input

Enter the description for application.

Keywords

Input

Enter the keywords.

Comments

Input

Enter the comments.

Create

Button

Submit the form for creating application.

Cancel

Button

Go back to home page.

17.3.1.7 editService.jsp

Users can view the application details and edit them.

Figure 17-8 edit application page

Text description of studio4c.gif follows.

Text description of the illustration studio4c.gif

Table 17-16 Resources
Name Description Example

common.labels.Name

The label for name field.

Name

editService.labels.name.hint

The hint for name field.

A short name for your Application.

common.labels.RemoteURL

The label for Remote URL field.

Remote URL

editService.labels.RemoteURL.hint

The hint for Remote URL field.

The URL of XML document that implements your application.

common.labels.Description

The label for Description field.

Description.

common.labels.description.hint

The hint to the user for the description field

A short description for your application.

common.links.Comments

The label for Comments.

Comments

editService.labels.comments.hint

The hint for comments field.

Comments about your application for your convenience.

common.labels.Keywords

The label for keywords.

Keywords

editService.labels.Keywords.hint

The hint for keywords field.

Search keywords for your application.

common.buttons.label.Save

The label for Save Button.

Save

common.buttons.label.Cancel

The label for Cancel Button.

Cancel

Table 17-17 Java Objects
Name Type Description

coreService

oracle.panama.studio.core.CoreService

Stores all the Oracle9iAS Wireless service details.

studioService

oracle.panama.studio.db.StudioService

Stores studio specific details.

Table 17-18 Action Fields
Name Type Description Condition

Name

Input

Edit the name of the application.

Cannot be left empty

URL

Input

Edit the URL of the application

Cannot be left empty

Description

Input

Edit the description for application.

Keywords

Input

Edit the keywords.

Comments

Input

Edit the comments.

Save

Button

Submit the form for saving the changes.

View Log

Button

View the runtime log for the application.

Cancel

Button

Go back to home page.

17.3.1.8 deployService.jsp

Enables users to deploy applications in their default domains. If an application is already deployed, then it is redeployed in that domain. In this way, if the name of an application is changed between 2 deployments, there will still be only one deployed application on the deployment server.

Figure 17-9 deploy service page

Text description of deploy.gif follows.

Text description of the illustration deploy.gif

Table 17-19 Resources
Name Description Example

deploy.body.title

The body title text for the page.

Deploy your application.

common.labels.Application.Name

The label for application name field.

Application Name.

common.labels.Mobile.Domain

The label for domain name field.

Domain Name.

common.labels.MobileURL

The label for Mobile URL field.

Mobile URL

common.labels.Description

The label for description field.

Description

common.links.Comments

The label for comments field.

Comments

common.labels.Keywords

The label for keywords field.

Keywords

common.buttons.label.Deploy

The label for deploy button.

Deploy

common.buttons.label.Cancel

The label for cancel button.

Cancel

Table 17-20 Action Fields
Name Type Description Condition

Description

Input

Edit the description for application.

Keywords

Input

Edit the keywords.

Comments

Input

Edit the comments.

Comments

Button

View all the comments for the application.

Deploy

Button

Submit the form for application deployment.

Cancel

Button

Go back to home page.

17.3.1.9 deployedServiceList.jsp

This page displays the list of the deployed services.

Available actions from this page:

Figure 17-10 deployedServiceList page

Text description of deployli.gif follows.

Text description of the illustration deployli.gif

Table 17-21 Resources
Name Description Example

The label for undeploy button

Undeploy

The label for view quicklink button

View quicklink

common.buttons.label.Cancel

The label for cancel button

Cancel

Table 17-22 Action Fields
Name Type Description Condition

Undeploy

Button

Submit the form for application undeployment.

Service should be selected first, and that service should be owned by the user.

Cancel

Button

Go back to domains page.

17.3.1.10 profile.jsp

Users can view and edit their profiles.

Figure 17-11 profile page

Text description of studio4f.gif follows.

Text description of the illustration studio4f.gif

Table 17-23 Resources
Name Description Example

profile.body.title

The body title text for the page.

My Profile

common.labels.User.ID

The label for users id.

User ID

register.label.accountnumber

The label for account number

123456

common.labels.Name

The label for Name field

Name

common.labels.email.address

The label for email field

Email

common.labels.Phone.Number

The label for Phone field

Phone

common.labels.Landmark

The label for landmark field

Landmark

common.labels.HOME

The label for home field

HOME

common.labels.home.address

The label for home address field

Home Address

common.labels.city

The label for city field

City

common.labels.stateZip

The label for state, zip field

State/Zip

common.labels.country

The label for country field

Country

common.labels.setDefault

The label for set default field

Set as Default

common.labels.WORK

The label for work field

WORK

common.labels.Company

The label for company field

Company

common.labels.work.address

The label for work address field

Work Address

common.labels.changePin

The label for change password field

Change Password

common.labels.NewPassword

The label for new password field

New Password

common.labels.NewPasswordAgain

The label for new password again field

New Password (again)

profile.text.changepin

The label for change pin field

Change PIN

register.label.voicepin

The label for voice pin field

Voice PIN

register.label.voicepinagain

The label for voice pin again field

PIN (again)

common.buttons.label.Save

The label for save button.

Save

common.buttons.label.Cancel

The label for cancel button

Cancel

Table 17-24 Action Fields
Name Type Description Condition

Name

Input

Edit the name.

Email

Input

Edit the email.

Cannot be left empty.

Phone

Input

Edit the Phone.

Cannot be left empty.

Home Address

Inputs

Edit the home address.

Work Address

Inputs

Edit the work address.

Password

Input

Change the password.

Cannot be left empty.

PIN

Input

Change the PIN.

Cannot be left empty.

Save

Button

Submit the form for saving the changes.

Cancel

Button

Go back to home page.

17.3.1.11 domains.jsp

Allows users to create, join, delete, and manage their domains. Displays a list of domains that users own or have joined.

Figure 17-12 domains page

. Text description of studio4g.gif follows.

Text description of the illustration studio4g.gif

Table 17-25 Resources
Name Description Example

domain.body.title

The body title text for the page.

My Domain

domain.labels.new.domain

The label for new domain title

Create New domain

common.labels.Name

The label for name field

Name

common.labels.Password

The label for password field

Password

common.labels.PasswordAgain

The label for password again field

Password (again)

common.buttons.label.Create

The label for create button.

Create

common.buttons.label.Cancel

The label for cancel button

Cancel

common.labels.setDefaultQ

The label for set default field

Set as default

domain.labels.joinDomain

The label for join domain title.

Join Domain

common.buttons.label.Join

The label for name field

Name

common.labels.owneddomains

The label for owned domains field

Domains Owned.

common.labels.joineddomains

The label for joined domains field

Domains Joined.

common.buttons.label.SetDefault

The label for set default button.

Set Default

common.buttons.label.LeaveDomain

The label for leave domain button

Leave Domain

common.buttons.label.Delete

The label for delete button

Delete

common.buttons.label.LISTAPPLICATIONS

The label for list applications button

List Applications

common.buttons.label.Cancel

The label for cancel button

Cancel

Table 17-26 Action Fields: Create Domain
Name Type Description Condition

Name

Input

The name of the domain to be created

Cannot be left empty

Password

Input

The password of the domain to be created

Cannot be left empty

Set as Default

Checkbox

Set the domain as default

Create

Button

Submit the form for new domain creation.

Cancel

Button

Go back to home page.

Table 17-27 Action Fields: Create Domain
Name Type Description Condition

Name

Input

The name of the domain to be Joined

Cannot be left empty

Password

Input

The password of the domain to be Joined

Cannot be left empty

Set as Default

Checkbox

Set the domain as default

Create

Button

Submit the form for joining domain.

Cancel

Button

Go back to home page.

Table 17-28 Action Fields: Manage Domains
Name Type Description Condition

Set Default

Button

Set the selected domain as the default one.

Leave Domain

Button

Leave the selected domain.

The selected domain should not be the one owned.

Delete

Button

Deletes the selected domain.

The selected domain should be the owned by the user.

List Applications

Button

List the applications for the selected domain

Cancel

Button

Go back to home page.

17.3.1.12 registraton.jsp

Users can register to Mobile Studio by filling in the registration form.

Figure 17-13 registration page

Text description of studio4h.gif follows.

Text description of the illustration studio4h.gif

Table 17-29 Resources
Name Description Example

common.href.register

The URL for registration page

Registration.jsp

register.text.title

The body title text for the page.

New User Registration

register.text.info

The informational message for registration

By registering, you indicate that you agree to our Terms of Use and Privacy policy. Fields marked with an asterisk (*) are required.

common.label.userid

The label for user id field

User ID

register.hint.userid

The hint for user id field.

Choose an alphanumeric userid.

common.label.password

The label for password field

Password

register.hint.password

The hint for password field

Choose an alphanumeric password.

common.label.password2

The label for password again field

Password (again)

register.hint.password2

The hint for password again field

Re-enter your password for verification.

register.label.accountnumber

The label for account number field

Voice account number

register.hint.accountnumber

The hint for account number

Choose an account number required for voice login.

register.label.voicepin

The label for voice pin

Voice PIN

register.hint.voicepin

The hint for voice pin

Choose a numeric PIN, required for voice login.

register.label.voicepinagain

The label for voice pin again.

PIN (again)

register.hint.voicepin2

The hint for voice again pin

Re-enter your PIN for verification.

register.hint.name

The hint for name field

Enter your first and last name, for example, John Smith.

common.label.email

The label for Email field

Email Address

register.hint.email

The hint for email

Enter your email address, for example, jsmith@company.com

common.label.phone

The label for phone field

Phone Number

register.hint.phone

The hint for phone field

Enter your phone number, including country and area code. for example, 16505151212

common.label.workaddr

The label for work address

Work Address

common.label.company

The label for company

Company Name

common.label.addr

The label for address line 1

Address Line 1

common.label.addr2

The label for address line

Address Line 2

common.label.city

The label for city.

City

common.label.state

The label for state

State

common.label.zip

The label for zip

Zip

common.label.country

The label for country

Country

register.label.setdefault

The label for set as default

Set as Default

register.hint.workaddr

The hint for work address

Enter your work address.

common.label.homeaddr

The label for home address

Home Address

register.hint.homeaddr

The hint for home address

Enter your home address.

common.label.register

The label for register button

Register

common.label.cancel

The label for cancel button

Cancel

Table 17-30 Action Fields
Name Type Description Condition

User Id

Input

Enter the user id.

Cannot be left empty. Should be unique.

Account Number

Input

Enter the account number.

Cannot be left empty. Should be unique.

Name

Input

Enter the name.

Email

Input

Enter the email.

Cannot be left empty. Should be unique.

Phone

Input

Enter the Phone.

Cannot be left empty. Should be unique.

Home Address

Inputs

Enter the home address.

Work Address

Inputs

Enter the work address.

Password

Input

Enter the password.

Cannot be left empty.

PIN

Input

Enter the PIN.

Cannot be left empty.

Register

Input

Submit the form for registration.

Cancel

Input

Go back to login page.

17.3.1.13 newFolder.jsp

Users can create new folders under their home folder or any of its sub-folders.

Figure 17-14 new folder page

Text description of studio4i.gif follows.

Text description of the illustration studio4i.gif

Table 17-31 Resources
Name Description Example

home.image.folder

Image of the folder

/images/omFolder.gif

newfolder.text.title

Title for the portlet

Create New Folder

newfolder.label.foldername

The label for the folder name

New Folder Name

newfolder.text.foldername

The text for the folder

New Folder

newfolder.label.create

The label for create button

Create

newfolder.label.cancel

The label for cancel button

Cancel

Table 17-32 Action Fields
Name Type Description

Condition

Folder Name

Input

The name of the new folder.

Cannot be left empty and should be unique

Create

Button

Submit the form for creating folder.

Cancel

Button

Go back to home page.

17.3.1.14 editFolder.jsp

Allows users to rename their folders or applications.

Figure 17-15 edit folder page

Text description of studio4j.gif follows.

Text description of the illustration studio4j.gif

Table 17-33 Resources
Name Description Example

rename.text.title

Title for the portlet

Rename fold1

rename.label.newname

Label for the name of folder

New Name

rename.label.rename

The label for the rename button

Rename

rename.label.cancel

The label for the cancel button

Cancel

Table 17-34 Action Fields
Name Type Description Condition

Name

Input

The name of the folder or service.

Cannot be left empty and should be unique

Rename

Button

Submit the form for renaming folder or service.

Cancel

Button

Go back to home page.

17.3.1.15 moveOrCopy.jsp

Allows users to move /copy their folders or services.

Figure 17-16 move/copy pages

Text description of studio4k.gif follows.

Text description of the illustration studio4k.gif

Table 17-35 Resources
Name Description Example

home.image.folder

The image of the folder

/images/omFolder.gif

move.label.to

The label for the destination folder

To

move.label.cancel

The label for the cancel button

Cancel

Table 17-36 Action Fields
Name Type Description Condition

To

Select

Users folders list.

Cannot be left empty and should be unique

Move

Button

Submit the form for moving folder/service.

Cannot move to same folder.

Copy

Button

Submit the form for copying folder/service.

Cannot copy to same folder.

Cancel

Button

Go back to home page.

17.3.1.16 sendMessage.jsp

Users can send messages to a number of people using Email, SMS, Voice, Two way pager and other supporting features that are available in Oracle9iAS Wireless.

Figure 17-17 send message page

Text description of studio4l.gif follows.

Text description of the illustration studio4l.gif

Table 17-37 Resources
Name Description Example

common.href.sms

The url for the send massage page

sendMessage.jsp

sms.text.title

The title for the page

Short Messaging

sms.text.info

The informational text.

Send a text message to any mobile phone. Also, send a voice message to any phone number in the United States.

sms.label.transport

The label for transport field

Transport

sms.hint.transport

The hint for transport field

Select the transport mode. Voice is currently only available for US phone numbers.

sms.label.sender

The label for sender field

From

sms.hint.sender

The hint for sender field

Enter your email address.

sms.label.recipients

The label for recipients field

Recipients

sms.hint.recipient

The hint for recipients field.

Enter up to 10 phone numbers, separating each entry with a comma.

sms.label.subject

The label for subject field

Subject

sms.label.message

The label for message field

Message Text

sms.hint.messagechar

The text for characters remaining

Characters remaining

sms.hint.message

The hint for message field

Text messages can be upto160 characters in length, including the senders email address, the subject and the message body.

sms.text.legal

The text for legal terms

Oracle mobile is not responsible for messages lost or misdirected due to interruptions or fluctuations in internet.

sms.label.sendmessage

The label for send message button

Send Message

Table 17-38 Action Fields
Name Type Description Condition

Transport

Select

List of the supported transport type.

From

Input

Senders email Id / Phone number.

Recipients

Input

Submit the form for copying folder/service.

Cannot be left empty

Subject

Input

Subject of the message.

Message Text

Input

Message text.

Send Message

Button

Submit the form for sending message.

17.3.1.17 viewLog.jsp

Users can test their services by viewing the log message for the service at runtime.

Figure 17-18 view log page

Text description of studio4m.gif follows.

Text description of the illustration studio4m.gif

Table 17-39 Resources
Name Description Example

viewlog.head.title

The head title for view log page.

View Log

viewlog.body.title

The body title for view log page.

View Log Messages

home.image.viewlog

The image for view log

images/viewlog.gif

viewlog.label.close

The label for close button

Close

viewlog.label.show

The text

Show

viewlog.label.requests

The text message

Most recent log messages

viewlog.label.refresh

The label for refresh button

Refresh Log

Table 17-40 Action Fields
Name Type Description Condition

No. of Logs

Input

Enter the no. of log messages to see.

Refresh Log

Input

Submits the form for refreshing logs.

Close Window

Input

Closes the window.

17.3.1.18 quicklink.jsp

Users can quicklink an application that is deployed. The next time when they log in to Oracle9iAS Wireless using their mobile devices, they can access this application.

Figure 17-19 quicklink page

Text description of studio4n.gif follows.

Text description of the illustration studio4n.gif

Table 17-41 Resources
Name Description Example

quicklink.text.title

The head title for the portlet

Quicklink

quicklink.body.title

The body title for the portlet

Processing Auto Quicklink

quicklink.text.info

Informational text

QuickLink this application to your wireless portal main menu.

quicklink.label.userid

The label for userid field

User ID

quicklink.label.password

The label for password field

Password

quicklink.label.linktitle

The label for quicklink name field

Quicklink Title

quicklink.label.cancel

The label for cancel button

Cancel

quicklink.label.next

The label for next button

Next

17.3.1.19 sampleSource.jsp

Displays the JSP source code of the sample application for users reference.

Figure 17-20 sample source page

Text description of studio4o.gif follows.

Text description of the illustration studio4o.gif

Table 17-42 Resources
Name Description Example

home.image.application

The image for the application

/images/app.gif

samplesrc.label.close

The label for close button

Close Window

17.3.1.20 pageHeader.jsp

This page is included as a header for all the customer facing JSPs.

Figure 17-21 page header

Text description of studio4p.gif follows.

Text description of the illustration studio4p.gif

Table 17-43 Resources
Name Description Example

page.title

window title

Home

site.name

site name

common.image.button.help

Help button image name

/images/button_help.gif

common.image.button.logout

Logout button image name

/images/button_logout.gif

common.image.window.left

left window border image name

/images/window_left.gif

common.image.window.top

top window border image name

/images/window_top.gif

common.image.window.topleft

top left window corner image name

/images/window_topleft.gif

common.image.window.topright

top right window corner image name

/images/window_topright.gif

common.href.help

URL of the Help page

documentation.jsp

common.href.logout

URL of the Logout action

logout.jsp

common.tooltip.help

tooltip text for the Help button

Help

common.tooltip.logout

tooltip text for the Logout button

Log out

17.3.1.21 pageFooter.jsp

This page is included as a footer for all customer facing JSPs.

Figure 17-22 page footer.

Text description of studio23.gif follows.

Text description of the illustration studio23.gif

Table 17-44 Resources
Name Description Example

common.image.window.bot

bottom window border image name

/images/window_bot.gif

common.image.window.botleft

bottom left window corner image name

/images/window_botleft.gif

common.image.window.botright

bottom right window corner image name

/images/window_botright.gif

common.image.window.left

left window border image name

/images/window_left.gif

common.image.window.line

window separator line image name

/images/window_line.gif

common.image.window.lineleft

window separator left joint image name

/images/window_lineleft.gif

common.image.window.lineright

window separator right joint image name

/images/window_lineright.gif

common.image.window.right

right window border image name

/images/window_right.gif

Table 17-45 Customizable User Messages
Name Value

error.accountnumber.exist

Account number already used. Please try another value.

error.create.user.exist

User of this name already Exist

error.create.user.generic

Unable to register user.

error.update.user.generic

Unable to update user profile.

error.create.email.exist

Email address already used by other user.

error.create.voice.exist

Phone number already used by other user.

error.login.user.param

Please log in using a valid User ID and password.

error.restricted.page.access

First login using valid UserId and Password.

error.select.service.edit

Select the service you want to edit.

error.select.service.deploy

Select the service you want to deploy.

error.select.service.delete

Select the service you want to delete.

error.delete.service.generic

Unable to delete the service. Please try again later.

error.create.service.generic

Unable to create the service. Please try again later.

error.create.service.exist

Service of same name already exist.

error.edit.service.generic

Unable to edit the service. Please try again later.

error.servicename.mobileurl.null

Service Name and the Mobile URL cannot be null.

error.deploy.service.generic

Unable to deploy the service. Please try again later.

error.deploy.service.name.exist

Service of same name already deployed by other user in same domain. Try other name or other domain.

error.default.domain.notexist

Currently you are not associated with any domain, either join or create one.

error.invalid.input.field

Please enter valid information in the given fields.

error.create.folder.generic

Unable to create the folder. Please try again later.

error.rename.folder.generic

Unable to rename the folder. Please try again later.

error.create.folder.exist

Folder of this name already exist.

error.copy.folder.same

Not allowed. The destination folder is same as folder.

error.move.folder.same

Not allowed. The destination folder is same as folder.

error.select.folder.rename

Select the folder you want to rename.

error.folder.name.null

Name of the Folder cannot be null.

error.select.folder.delete

Select the folder you want to delete.

error.delete.folder.generic

Unable to delete the folder. Please try again later.

error.quicklink.user.invalid

Please enter valid username and password.

error.create.quicklink.generic

Unable to quicklink the service. Please try again later.

error.get.domains.generic

Unable to fetch the domains. Please try again later.

error.domain.name.null

Domain name and password cannot be null.

error.create.domain.exist

Domain of same name already exist. try different name.

error.create.domain.generic

Unable to create domain. Please try again later.

error.select.domain.delete

Select the domain you want to delete.

error.delete.domain.notowner

Only the owner of the domain can delete it.

error.delete.domain.generic

Unable to delete domain. Please try again later.

error.join.domain.notexist

Invalid domain name / password.

error.join.domain.generic

Unable to join domain. Please try again later.

error.select.domain.leave

Select the domain you want to leave.

error.leave.domain.generic

Unable to leave domain. Please try again later.

error.select.domain.default

Select the domain you want to set as default.

error.deployedservice.list

No Services are deployed in this domain.

error.undeployservice.noprivilige

Only the owner of the service can undeploy it.

message.domain.not.found

No Domains found.

error.domain.alreadyowned

Domain already owned, no need to join it.

error.leave.domain.owned

You cannot leave the owned domains. Delete if not required.

error.resource.notFound

Resource "{0}" not found.

error.session.expired

Your session has expired. Please log in using a valid user ID and password.

error.login.invalidPassword

Incorrect password. Please log in using a valid user ID and password.

error.login.secureDocument

You have tried access a secure document. Please log in first.

error.user.notLoggedIn

User not logged in

error.privileges.generic

You do not have appropriate privileges.

error.create.generic

Unable to create. Please try again later.

error.rename.generic

Unable to rename. Please try again later.

error.move.generic

Unable to Move. Please try again later.

error.copy.generic

Unable to Copy. Please try again later.

error.create.folderOrService.exist

Name already used. Try different name.

error.select.generic

Please make a selection first.

success.edit.service

Changes saved.

success.create.service

Application created.

success.create.folder

Folder created.

success.create.domain

Domain created.

success.join.domain

Joined the requested Domain.

success.leave.domain

Left the requested Domain.

success.delete.domain

Domain deleted.

success.default.set.domain

Set Domain as default.

success.rename.service

Successfully renamed.

17.4 Administration

17.4.1 Login

Location: http://hostname:port/studio/admin/login.jsp

  1. Type in user name (for example, orcladmin)

  2. Type in password (for example, manager)

  3. Click on `Login'; if your user name and password are correct, you will be brought to the administration pages.


    Note:

    If you tried to access the administration pages without logging in first, you will be brought to this page automatically and the following error message will be shown on the top of the page: "Your session has expired. Please log in using a valid user ID and password".


Subsequent pages can be accessed only after you have logged in.

For any of the changes that an administrator makes through the Administration UIs to be visible to end-users, the administrator must press the "Reset" button that is located on the top right-hand side of the pages.

17.4.2 Site

Location: http://hostname:port/studio/admin/site.jsp

From the Sites page, you can find site(s) using a pattern, or you can add, edit, and delete sites.

To find a site (if, for example, you have many sites), type the name or a pattern for the site you are looking for, then click the "Find" button. You will be given a list of the sites that matched the name or pattern.

To add a site, click the "Add" button; you will be brought to another page, http://hostname:port/studio/admin/editSite.jsp, where you can create a site after you specify the name and description and pick a default locale for the site. If you click "Save", then the changes are stored and you are brought back to the Sites page. If you click "Cancel", no changes will be stored and you will be brought back to the Sites page.

To edit a site, first select the site you want to edit from the list of sites you have, then click the "Edit" button below the list of sites. You will be brought to the another page, http://hostname:port/studio/admin/editSite.jsp, where you can make changes to the site and store the changes. For a site created by an administrator, the name, description, and default locale can all be changed. However, only description is changeable for the default site.

To delete a site, select the site you want to delete and the click the "Delete" button. The save the deletion, click the "Save" button. To undo the deletion, click the "Undelete" button. The "Undelete" button appears if you have just deleted site(s), and you have not saved your changes yet.


Note:

The changes will not be stored until you click the "Save" button.


17.4.3 Configuration

Location: http://hostname:port/studio/admin/config.jsp

From the Configuration page, you can find configuration parameter(s) using a pattern, or you can add, edit, and delete configuration parameters.

To find a configuration parameter (if, for example you have many configuration parameters), type the name or a pattern for the parameter you are looking for in the textbox, and click the "Find" button. You will be given a list of the configuration parameters that match the name or pattern.

To add a configuration parameter, click the "Add" button, you will be brought to another page, http://hostname:port/studio/admin/editConfig.jsp, where you can create a configuration parameter. You must specify the name and description for a parameter before it can be created. You can add value(s) to the parameter by clicking the "Add" button. Once you have added a value to a list of values for the parameter, you can delete, or move them up/down the list.


Note:

The first value on the list is used as the value of the parameter while the other values are just for convenience.


When you click the "Save" button, the changes are stored and you are brought back to the configuration parameters page. If you click the "Cancel" button, no changes will be stored and you will be brought back to the configuration parameters page.

To edit a configuration parameter, select the configuration parameter you want to edit from the list of configuration parameters, then click the "Edit" button below the list of configuration parameters. You will be brought to another page, http://hostname:port/studio/admin/editConfig.jsp, where you can make changes to the configuration parameters and store them.

To delete a configuration parameter, select the configuration parameter you want to delete and the click the "Delete" button. To save the deletion, click the "Save" button. To undo the deletion, click the "Undelete" button. The "Undelete" button appears if you have just deleted configuration parameter(s), and you have not yet saved your changes.


Note:

The changes will not be stored until you click the "Save" button.



IMPORTANT:

The site you designate as the default site must be given this name:

oracle.panama.studio.resource.defaultSite

For a list of other import configuration parameters, see Section 17.3, "Studio Configuration" on studio configuration.


17.4.4 Locales

Location: http://hostname:port/studio/admin/locale.jsp

From the Locales page, you can either find locale(s) using a pattern, or you can add, edit, and delete locales.

To find a locale, type the name or a pattern for the locale you are looking for in the textbox, and click the "Find" button. You will be given a list of the locales that match the name or pattern.

To add a locale, click the "Add" button, a new entry will be added to the list of locales with the name and description fields left blank. You must specify the name and description for a locale before it can be created. Click the "Save" button to store the change(s).

To edit a locale, edit the name or description of the locale in the appropriate fields. Click the "Save" button to store the change(s). Note that the name of the default locale is not editable.

To delete a locale, select the locale you want to delete, then click the "Delete" button. To save the deletion, click the "Save" button. To undo the deletion, click the "Undelete" button. The "Undelete" button appears if you have just deleted configuration parameter(s), but have not yet saved your changes. Note that the default locale cannot be deleted.


Note:

The changes will not be stored until you click the "Save" button.


Mobile Studio comes with default bundles for 28 different locales as listed in the following table:

Locales of the default bundles for Mobile Studio.

Table 17-46 Mobile Studio locales
Name Description Name Description

ar

Arabic

ko

Korean

cs

Czech

nl

Dutch

da

Danish

no

Norwegian

de

German

pl

Polish

el

Greek

pt

Portuguese

es

Spanish

Pt_BR

Portuguese (Brazil)

es_ES

Spanish

ro

Romanian

fi

Finnish

ru

Russian

fr

French

sk

Slovak

fr_CA

French (Canada)

sv

Swedish

hu

Hungarian

th

Thai

it

Italian

tr

Turkish

iw

Hebrew

Zh_CN

Chinese (PRC)

ja

Japanese

Zh_TW

Chinese (Taiwan)

The locales are only enabled after the administrator has explicitly added them through this interface and reset the system by clicking the "Reset" button. For example, to support users whose preferred locale is `ru', the administrator must add `ru' and the description (for example: "Russian"), through the UI, save the changes, and click the "Reset" button to see the effects.

The following is a description of the algorithm that Mobile Studio uses to resolve the locale to use:

  1. Given the list of preferred locales for the user, which can be obtained from the request.

  2. Iterate through the list, and for each preferred locale L, check if it can be found in the list of enabled locales for Mobile Studio. If L can be found, return the found locale and the iteration stops. If L cannot be found, then another search on a new L' which is constructed using only the language part of L is tried. For example, if "en_US" cannot be found, then "en" will be tried instead. If the second try works, the new locale L' will be returned and the iteration stops.

  3. If after the iteration finished and no suitable locale can be found, then the default locale of the default site will be returned if it is enabled. Similarly, a second try will be given to this default locale as well.

  4. If after step 3, the preferred locale is still not found, locale "en" will be returned.

If an additional locale other than these 28 locales is needed (for example, "hi" for Hindi), it is the administrator's responsibility to provide the following resources to make sure Mobile Studio works consistently.

17.4.5 Sample Services

Location: http://hostname:port/studio/admin/samples.jsp

From the Sample Services page, you can either find the list of sample service(s) or you can add, edit, and delete locales.

To add a sample service, click the "Add" button; you will be brought to another page, http://hostname:port/studio/admin/editSamples.jsp. You must specify the name, description, the name of the service JSP and service URL before the new sample service can be stored. The JSP name of the service is the name of the JSP that supports the service, while the service URL is the URL used by Oracle9iAS Wireless server at runtime for the application. The sample service can be hidden from users by setting the Visible to "No", or it can be shown to users by setting it to "Yes". To save the changes, click the "Save" button.

To edit a sample service, click the "Edit" button; you will be brought to the http://hostname:port/studio/admin/editSamples.jsp page, where you can change the name, description, JSP name, the service URL, and the status of visibility of the sample service. Again, click the "Save" button if you want the change(s) stored.

To delete a sample service, first select the sample service from the list of services shown then click the "Delete" button.

17.4.6 Resources

Location: http://hostname:port/studio/admin/resource.jsp

From the Resources page, you can either browse the list of resources(s) or you can add, edit, and delete resources.

The resources are displayed in the fashion similar to a file directory structure. On first access to the resource page, the resources and folders inside the root folder are shown. To drill down a folder, click on the name of the folder. To go back up a level, click on the link called "Up One Level" on the front of the resource list.

To add a resource, click on the "Add" button, you will be brought to another page, http://hostname:port/studio/admin/editResource.jsp. You must specify the name, description, the type of the resource and default locale for the resource before the new resource can be created. To add a value for the resource, click the "Add" button on this page, select the site you want the resource to be bound to, the locale for the resource, and type in the value for the resource in the text box. Click the "Save" button to store the change(s). Only resources can be added to the system, however, folders can be added as a side effect. For example, if you are browsing the directory, "deploy.head", and then you decide to add a resource called "deploy.head.folder.resource", if the "deploy.head.folder" does not exist, it will be created in addition to the resource "deploy.head.folder.resource".

To edit a resource, select the resource from the resource lists then click the "Edit" button. You will be brought to http://hostname:port/studio/admin/editResource.jsp, where you can change the name, description, type of the resource, and default locale for the resource.


Note:

You CANNOT edit a folder at this location. For default resources, name and default value cannot be edited. Click the "Save" button to store the change(s).


To delete a resource, select the resource from the resources list, then click the "Delete" button.


Note:

folders and default resources cannot be deleted. To undo the deletion, click the "Undelete" button. Click the "Save" button to store the change(s). Remember, the changes WILL NOT be stored until you click the "Save" button.


17.5 Advanced Customization (Studio Tag Library)

17.5.1 Resources

Resources currently supported in Mobile Studio are divided into two categories: literal resources and http resources.

Literal resources are resources with a literal value, as the name suggests. Mobile Studio includes a set of literal resources; advanced users of Mobile Studio can customize them, although it is an involved process and therefore recommended only for advanced users. Literal resources can always be overridden (effectively, customized) from the Mobile Studio administration pages.

Http resources are usually static HTML pages that can be dynamically included at runtime and they should be stored inside a directory that can be seen by the web server.

All the resources can be accessed using the <om:res> tag; the only requirement for this tag to work is that the attribute with the given name must exist in the current context (that is, the current http request, the page context, or the current session).

At runtime, the tag library automatically determines the type of the resource and outputs its value dynamically (that is, the literal value or the HTML page).

17.5.2 Tag Library

<om:is />

Specification in taglib:

  <tag>
    <name>is</name>
    <attribute> 
      <name>attr</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute> 
      <name>value</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute>
      <name>name</name>
      <required>false</required>
      <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute> 
      <name>prefix</name>
      <required>false</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <tagclass>oracle.panama.studio.taglib.IsTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>Evaluate the body if the value found from the bean matches the given 
value</info>
 </tag>

Usage:

<om:is attr= "attrName" value= "attrValue" (name=  "beanName") (prefix= 
"prefixName") >...</om:is>


Note:

The attributes in parenthesis are optional.


<om:is> is a body tag, that is, if the condition evaluate is set to true, then the body content will be processed and output as appropriate. The attributes are explained as follows:

<om:not>

Specification in taglib:

  <tag>
    <name>not</name>
    <attribute> 
      <name>attr</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute> 
      <name>value</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute>
      <name>name</name>
      <required>false</required>
      <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute> 
      <name>prefix</name>
      <required>false</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <tagclass>oracle.panama.studio.taglib.NotTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>Evaluate the body if the value found from the bean does not match the 
given value.</info>
 </tag>

Usage:

<om:not attr= "attrName" value= "attrValue" (name=  "beanName") (prefix= 
"prefixName") >....</om:not>

<om:not> is a body tag (that is, if the condition evaluate is set to false, then the body content will be processed and output as appropriate.

The attributes are explained as follows:

<om:get />

Specification in taglib:

  <tag>
    <name>get</name>
    <attribute> 
      <name>attr</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute>
       <name>name</name>
       <required>false</required>
       <rtexprvalue>true</rtexprvalue>
    </attribute>
    <tagclass>oracle.panama.studio.taglib.GetTag</tagclass>
    <bodycontent>empty</bodycontent>
    <info>Gets the value of a bean attribute using reflection.</info>
  </tag>

Usage:

<om:get attr= "attrName" (name=  "beanName")/>

<om:get> is a simple tag, that is, it does not allow content inside its body. This tag tried to get the attribute from bean and output it if found. It does nothing if the bean or the attribute are not found.

The attributes are explained as follows:

<om:bean />

Specification in taglib:

  <tag>
    <name>bean</name>
    <attribute>
       <name>name</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
    </attribute>
    <tagclass>oracle.panama.studio.taglib.BeanTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>Sets up the context for the bean.</info>
  </tag>

Usage:

<om:bean name=  "beanName"/>

<om:bean> is a simple tag, that is, it does not allow content inside its body. This tag put the bean in the context (same as JSP page context) with the given name.

The attributes are explained as follows:

<om:test />

Specification in taglib:

  <tag>
    <name>test</name>
    <attribute> 
      <name>attr</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute>
       <name>value</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute>
       <name>prefix</name>
       <required>false</required>
       <rtexprvalue>true</rtexprvalue>
    </attribute>
    <tagclass>oracle.panama.studio.taglib.TestTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>Test if the value of a bean attribute is the same as given using 
reflection.</info>
  </tag>

Usage:

<om:test attr= "attrName" value= "attrValue" (prefix = "prefix")>....</om:test>

<om:test> is a body tag, that is, its body content is evaluated and output as appropriate if the test condition evaluates to true.

The attributes are explained as follows:

<om:equals />

Specification in taglib:

  <tag>
    <name>equals</name>
    <attribute> 
      <name>attr</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <attribute>
       <name>name</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
    </attribute>
    <attribute>
       <name>prefix</name>
       <required>false</required>
       <rtexprvalue>true</rtexprvalue>
    </attribute>
    <tagclass>oracle.panama.studio.taglib.EqualsTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>Test if the value of a bean attribute is the same as given using 
reflection.</info>
  </tag>

Usage:

<om:equals  attr= "attrName" name= "attrName" (prefix = "prefix")>....</om:equals>

<om:equals> is a body tag, that is, its body content is evaluated and output as appropriate if the test condition evaluates to true.

The attributes are explained as follows:

<om:indexIs />

Specification in taglib:

  <tag>
     <name>indexIs</name>
     <tagclass>oracle.panama.studio.taglib.IndexIsTag</tagclass>
     <bodycontent>JSP</bodycontent>
     <info>Test if the index inside iteration is the same as given by the 
user.</info>
     <attribute>
        <name>value</name>
	<required>true</required>
	<rtexprvalue>true</rtexprvalue>
     </attribute>
  </tag>

Usage:

<om:indexIs  value= "value" >....</om:indexIs>

<om:indexIs> is a body tag, that is, its body content is evaluated and output as appropriate if the test condition evaluates to true.

The attributes are explained as follows:

<om:indexEquals />

Specification in taglib:

  <tag>
     <name>indexEquals</name>
     <tagclass>oracle.panama.studio.taglib.IndexEqualsTag</tagclass>
     <bodycontent>JSP</bodycontent>
     <info>Test if the index inside iteration is the same as the value 
found.</info>
     <attribute>
        <name>name</name>
	<required>true</required>
	<rtexprvalue>true</rtexprvalue>
     </attribute>
  </tag>

Usage:

<om:indexEquals  name= "attrName" >....</om:indexEquals>

<om:indexEquals> is a body tag, that is, its body content is evaluated and output as appropriate if the test condition evaluates to true.

The attributes are explained as follows:

<om:index />

Specification in taglib:

  <tag>
    <name>index</name>
    <tagclass>oracle.panama.studio.taglib.IndexTag</tagclass>
    <bodycontent>empty</bodycontent>
    <info>Gets the current index during iteration.</info>
  </tag>

Usage:

<om:index/>

<om:index> is a simple tag, that is, there is no content inside the tag allowed. It simply outputs the index of the current bean which is used mostly inside <om:iterate>.

<om:res />

Specification in taglib:

  <tag>
    <name>res</name>
    <attribute> 
      <name>name</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <tagclass>oracle.panama.studio.taglib.ResourceTag</tagclass>
    <bodycontent>empty</bodycontent>
    <info>A generic "get-resource" tag.</info>
  </tag>

Usage:

<om:res name= "resName" >....</om:res>

<om:res> is a simple tag, that is, there is no content allowed inside its body.

The attributes are explained as follows:

The context is the defined as the HTTP request parameter, the JSP page context, or the current HTTP session.

<om:enc />

Specification in taglib:

  <tag>
    <name>enc</name>
    <attribute> 
      <name>name</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
    <tagclass>oracle.panama.studio.taglib.EncodeTag</tagclass>
    <bodycontent>empty</bodycontent>
    <info>A generic "encode-resource" tag.</info>
  </tag>

<om:exist />

Specification in taglib:

 <tag>
    <name>exist</name>
    <tagclass>oracle.panama.studio.taglib.ExistTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>A logical exists tag.</info>
    <attribute> 
      <name>name</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
  </tag>

Usage:

<om:exist name= "attrName" >....</om:exist>

<om:exist> is a body tag, that is, its body content is evaluated and output as appropriate if the test condition evaluates to true.

The attributes are explained as follows:

The context is the defined as the HTTP request parameter, the JSP page context, or the current HTTP session.

<om:notexist />

Specification in taglib:

 <tag>
    <name>notexist</name>
    <tagclass>oracle.panama.studio.taglib.NotExistTag</tagclass>
    <bodycontent>JSP</bodycontent>
    <info>A logical not-exists tag.</info>
    <attribute> 
      <name>name</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
  </tag>

Usage:

<om:notexist name= "attrName" >....</om:notexist>

<om:notexist> is a body tag, that is, its body content is evaluated and output as appropriate if the test condition evaluates to true.

The attributes are explained as follows:

The context is defined as the HTTP request parameter, the JSP page context, or the current HTTP session.

<om:if />

Specification in taglib:

  <tag>
     <name>if</name>
     <tagclass>oracle.panama.studio.taglib.IfTag</tagclass>
     <bodycontent>JSP</bodycontent>
     <info>A logical if tag.</info>
     <attribute>
       <name>name</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
     <attribute>
       <name>value</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
     <attribute>
       <name>op</name>
       <required>true</required>
       <rtexprvalue>false</rtexprvalue>
     </attribute>
  </tag>

Usage:

<om:if name= "attrName" value= "attrValue"  op= "equal" >
   <om:then> ....</om:then>
  <om:elseif name="attrName" value="attrValue" op="equal">
    <om:then> ...</om:then>
      <om:ese>
          <om:then> ...</om:then>
     </om:else>
  </om:elseif>
</om:if>

<om:if> is used in combination with <om:elseif>, <om:else> and <om:then>.

If the application of the operator between the value of the given attribute in context and the value given evaluates to true, then the immediate child <om:then> tag's content are evaluated and output. Otherwise, the <om:elseif> or <om:else> that is an immediate child of the <om:if> is evaluated, and its contents are output as appropriate to them.

The attributes are explained as follows:

The context is defined as the HTTP request parameter, the JSP page context, or the current HTTP session.

value: The value of the attribute being testing against.

<om:elseif>

Specification in taglib:

  <tag>
     <name>elseif</name>
     <tagclass>oracle.panama.studio.taglib.ElseIfTag</tagclass>
     <bodycontent>JSP</bodycontent>
     <info>A logical elseif tag, allowed only inside if or elseif.</info>
     <attribute>
       <name>name</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
     <attribute>
       <name>value</name>
       <required>true</required>
       <rtexprvalue>true</rtexprvalue>
     </attribute>
     <attribute>
       <name>op</name>
       <required>true</required>
       <rtexprvalue>false</rtexprvalue>
     </attribute>
  </tag>

Usage:

<om:if name= "attrName" value= "attrValue"  op= "equal" >
   <om:then> ....</om:then>
  <om:elseif name="attrName" value="attrValue" op="equal">
    <om:then> ...</om:then>
      <om:ese>
          <om:then> ...</om:then>
     </om:else>
  </om:elseif>
</om:if>

<om:elseif> is used in combination with <om:if>, <om:else> and <om:then>.

If the application of the operator between the value of the given attribute in context and the value given evaluates to true, then the immediate child <om:then> tag's content are evaluated and output Otherwise, the <om:else> that is the immediate child of the <om:elseif> is evaluated, and its contents are output as appropriate to it.

The attributes are explained as follows:

The context is defined as the HTTP request parameter, the JSP page context, or the current HTTP session.

value: The value of the attribute being tested against.

<om:else />

Specification in taglib:

  <tag>
     <name>else</name>
     <tagclass>oracle.panama.studio.taglib.ElseTag</tagclass>
     <bodycontent>JSP</bodycontent>
     <info>A logical else tag.</info>
  </tag>

Usage:

<om:if name= "attrName" value= "attrValue"  op= "equal" >
   <om:then> ....</om:then>
  <om:elseif name="attrName" value="attrValue" op="equal">
    <om:then> ...</om:then>
      <om:ese>
          <om:then> ...</om:then>
     </om:else>
  </om:elseif>
</om:if>

<om:else> is used in combination with <om:elseif>, <om:else> and <om:then>.

When the parent <om:if> or <om:elseif> evaluates to false, then the content of the child <om:then> tag is evaluated and output as appropriate, otherwise, it does nothing.

<om:then />

Specification in taglib:

  <tag>
     <name>then</name>
     <tagclass>oracle.panama.studio.taglib.ThenTag</tagclass>
     <bodycontent>JSP</bodycontent>
     <info>A logical else tag.</info>
  </tag>

Usage:

<om:if name= "attrName" value= "attrValue" op= "equal" >
   <om:then> ....</om:then>
  <om:elseif name="attrName" value="attrValue" op="equal">
    <om:then> ...</om:then>
      <om:ese>
          <om:then> ...</om:then>
     </om:else>
  </om:elseif>
</om:if>

<om:then> is used in combination with <om:if> , <om:elseif> and <om:else>.

If the parent <om:if> , <om:elseif> and <om:else> evaluates to true, then the contents of the <om:then> tag are evaluated and output as appropriate.

<om:iterate />

Specification in taglib:

 <tag>
    <name>iterate</name>
    <tagclass>oracle.panama.studio.taglib.IterateTag</tagclass>
    <!-- teiclass>oracle.panama.studio.taglib.IterateTagTEI</teiclass -->
    <bodycontent>JSP</bodycontent>
    <info>An iteration tag.</info>
    <attribute> 
      <name>name</name>
      <required>true</required> 
      <rtexprvalue>true</rtexprvalue> 
    </attribute>
</tag>

Usage:

<om:iterate name= "collectionName" >
...
</om:iterate>

<om:iterate> is used for iterating over a collection of bean objects. If an object with the given name is found in the context, and it is of Java Collection type, then the collection can be looped through, and each of the object inside the collection can be used as we loop through it. The body of the <om:iterate> tag will be output n times where n is the number of objects inside the collection.

<om:switch />

Specification in taglib:

<tag>
   <name>switch</name>
   <tagclass>oracle.panama.studio.taglib.SwitchTag</tagclass>
   <bodycontent>JSP</bodycontent>
   <info>A switch tag.</info>
   <attribute>
     <name>name</name>
     <required>true</required>
     <rtexprvalue>true</rtexprvalue>
   </attribute>
</tag>

Usage:

<om:switch name= "attrName">
	<om:case value= "value1">
	 ...
	</om:case>
	<om:case value= "value2" >
	...
	</om:case>
	...
	<om:default>
	...
	</om:default>
</om:switch>

<om:switch> is used in combination with <om:case> and <om:default>, where in <om:switch> the name of the attribute being tested is specified, and inside <om:case> the value of the attribute being testing against is specified. In case of a match, the body of the <om:case> that satisfies the match is evaluated and output as appropriate, otherwise if the <om:default> is specified, then its body is evaluated and output instead.

<om:case />

Specification in taglib:

<tag>
   <name>case</name>
   <tagclass>oracle.panama.studio.taglib.CaseTag</tagclass>
   <bodycontent>JSP</bodycontent>
   <info>A case tag.</info>
   <attribute>
      <name>value</name>
      <required>true</required>
      <rtexprvalue>true</rtexprvalue>
   </attribute>
</tag>

Usage:

See that of <om:switch >

<om:default />

Specification in taglib:
<tag>
   <name>default</name>
   <tagclass>oracle.panama.studio.taglib.DefaultTag</tagclass>
   <bodycontent>JSP</bodycontent>
   <info>A default tag. </info>
</tag>

Usage:

See that of <om:switch>


Go to previous page Go to next page
Oracle
Copyright © 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index