Guidelines for Buttons in Edit Defaults Mode For consistency and user

Creating Java Portlets 6-7 Technically, JPS portlets do not have Full Screen mode. However, you can implement the equivalent of Full Screen mode for a JPS portlet with View mode Shared Screen mode and a maximized state for the window.

6.1.1.6 Help Mode JPS and Oracle Portal

A portlet uses Help mode to display information about the functionality of the portlet and how to use it. The user should be able to find useful information about the portlet, its content, and its capabilities with this mode. Portal users access a portlets Help mode by clicking Help in the portlet header. Guidelines for Help Mode The following guidelines should govern what you expose to users in Help mode: ■ Describe how to use the portlet. Users may not know all the features your portlet provides just from its interface. Describe the features and how to get the most out of them.

6.1.1.7 About Mode JPS and PDK-Java

Users should be able to see what version of the portlet is currently running, its publication and copyright information, and how to contact the author. Portlets that require registration may link to Web-based applications or contact information from this mode, as well. Portal users access a portlets About mode by clicking About on the portlet header. A new page appears in the same browser window. The portlet can either generate the content for this new page or take the user to an existing page or application. Guidelines for About Mode The following guidelines should govern what you expose to users in About mode: ■ Display relevant copyright, version, and author information. Users want to know what portlet they are using and where they can get more information. The about page may become important when supporting your portlets.

6.1.1.8 Link Mode PDK-Java

A portlet uses Link mode to render a link to itself that displays on a mobile page. When the user clicks the link, the portlet is called in Show mode. The portlet then renders itself in the mobile ViewShared Screen mode. For JPS portlets that declare support of the Oracle Mobile XML content type, Oracle Portal renders the link in one of two ways, as follows: ■ Call the portlets View mode with the MINIMIZED window state, if the portlet declares support for it. ■ Otherwise, render a link using the portlets title. Guidelines for Link Mode The following guidelines should govern what you expose to users in Link mode: ■ Limit content. The purpose of Link mode is to render a link without extraneous material. Link mode should simply render the short title and possibly some relevant summary information usually just a word or two. 6-8 Oracle Fusion Middleware Developers Guide for Oracle Portal

6.1.2 Guidelines for Navigation within a Portlet

In some ways, navigation between different sections or pages of a single portlet is identical to navigation between standard Web pages. Users can submit forms and click links. In the case of typical, simple Web pages, both of these actions involve sending a message directly to the server responsible for rendering the new content, which is then returned to the client. In the case of portlets, which comprise only part of a page, the form submission or link rendered within the portlet does not directly target the portlet. It passes information to the portlet through the portal. If a link or form within a portlet does not refer back to the portal, then following that link takes the user away from the portal, which is not typically the desired behavior. The portlet developer does not need to know the detailed mechanics of how the parameters of a form or link get passed around between the user, portal, and portlet. However, they must understand that they cannot write links in a portlet the same way they do for typical, simple Web pages.

6.1.2.1 Types of Links for Portlets

A portlet may render links of four classes, as follows: ■ Intraportlet links require the portlet to be aware of the address of Oracle Portal because they actually refer to it in some way. ■ Portal links , like intraportlet links, must be aware of the address of Oracle Portal for the same reason. ■ External links make no reference to Oracle Portal and behave in portlets as they would do in a normal Web page. ■ InternalResource links , like external links, also make no reference to Oracle Portal. Figure 6–1 contains a summary of these link types. The arrows indicate how the links reference the resources to which they logically refer. Figure 6–1 Oracle Portal Link Types