Director Tutorials


Working with Accessory Portlets

 
Top of page

Objective

Add some accessory portlets to a personal page, use the portlet options, and access portlet preferences.

Before you begin   See About exteNd Director Tutorials

Audience   This section is for portal end-users.

 
Top of page

Concepts

 
Top of page

Exercises

This section provides exercises that show you how to perform the following tasks:

 
Top of section

Adding accessory portlets to a page

Accessory portlets are a set of production-quality portlets that you can use on personal or shared pages in the ExpressPortal project or in your own exteNd Director project. They provide rich interaction with web sites, access to local applications, form-based authentication, and other functions of interest to general users. Some of the accessory portlets have been converted from Novell Portal System (NPS) gadgets. All of the accessory portlets conform to the Java Portlet 1.0 specification.

Procedure To access ExpressPortal:

  1. Start the exteNd Application Server where the Express Portal application has been deployed.

  2. Start a browser.

  3. Open the Express Portal application by typing this URL:

      http://host/ExpressPortal
    

    NOTE:   host is the machine on which the Express Portal application is running. If the application is running on your local machine, use localhost.

    The default page for a guest user opens in your browser:

    GuestUserPage

  4. Click Login on the right side of the portal title bar.

    ExpressPortalLoginSelectAnnot

    The login page displays:

    tutwwpXpressPortalLoginDialog

  5. If you have logged in to ExpressPortal previously you can use the same name and password to access the default ExpressPortal page. Otherwise, create a new user by following these steps:

    1. Click the New User? link on the login page.

    2. Fill in all of the requested fields. For example:

      Field

      Sample Entry

      User ID

      MDoe

      password

      mdoe

      First Name

      Mary

      Last Name

      Doe

      Email

      mdoe@tutorial.com

    3. Click Register.

    The login page reappears with a message indicating the new user has been successfully created.

  6. Log in using the new user and password.

    The default page for a non-administrator user opens in your browser.

    NewUserPage

Now you are ready to create a personal page with accessory portlets. Leave the default user page running in the browser and move to the next exercise.

Procedure To create a personal page and add accessory portlets:

  1. Click Personalize on the right side of the page.

    The Portal Personalizer opens in your browser:

    Personalizer

  2. Under Personal Pages select New.

  3. Enter the following properties:

    Property

    What to specify

    Page Name

    Enter My Accessory Portlets

    Description

    Enter Tutorial

  4. Click Update.

    My Accessory Portlets is added to the Personal Pages list.

  5. With the new page selected, click Choose Content.

    The Content Selector opens in a new browser window:

    ContentSelector

  6. From the Filter dropdown list choose Accessory Portlets.

  7. From the Available Content list, select the following portlets and add them to the page by clicking Add:

    TIP:   You can select multiple items by pressing the Ctrl key while clicking, then add all items as a group.

  8. Close the Content Selector by clicking Save Contents at the bottom of the form.

    You return to the Portal Personalizer.

  9. Choose Arrange Content.

    The Layout Selector opens in a new browser window.

  10. Move Shortcut and Rss News Feed into the right column by clicking their title bars, then clicking inside the right column.

    The Layout Selector should look like this:

    Layout

  11. Click Save Layout at the bottom of the form.

    The Layout Selector closes and you return to the Portal Personalizer.

  12. In the Portal Personalizer, choose Portal.

    The default ExpressPortal page opens in your browser.

    Notice the new page, My Accessory Portlets, listed under Personal Pages in the navigation pane

  13. Select My Accessory Portlets.

    PageWithMyAccessoryPortlet

    The new page opens in your browser, displaying the IFrame, Shortcut, and Rss News Feed portlets in the content frame. It should look something like this:

    MyAccessoryPortlets

Now you are ready to learn about portal options. Leave this page running in your browser and move to the next exercise.

 
Top of section

Using portal options

A portal option is text or an image that appears in the title bar of a portlet. Each portal option specifies a link that controls which action will be performed when the user clicks on the option. For example, a portlet title bar can provide buttons to allow users to edit, minimize, or restore the portlet.

Procedure To use portlet options:

  1. Move your cursor to the title bar of the RSS News Feed portlet and click the minimize button, as in this example:

    RssNewsFeedMinimize

    TIP:   To display a tool tip, hover over the option with your mouse.

    The RSS News Feed portlet window is minimized and the minimize button is replaced with a restore button.

  2. Click the restore button.

    RssNewsFeedRestore

    The Rss News Feed portlet is restored to its original size.

  3. Move your cursor to the title bar of the IFrame portlet and click the maximize button:

    IFrameMaximize

    The IFrame portlet window is maximized to occupy the entire browser window. The maximize button is replaced with a restore button.

  4. Click the restore button to return the IFrame portlet to its original size.

    NOTE:   The IFrame portlet also has an edit option that allows you to access and modify the preferences defined for this portlet:

    IFrameEdit

 
Top of section

Accessing help for accessory portlets

Each accessory portlet provides online help that can be accessed from an option in its title bar.

Procedure To access help for accessory portlets:

  1. Click the help icon in the title bar of each portlet.

    Help

    A general description of the portlet appears in the portlet window.

  2. Choose Click here to Return at the bottom of each help window to dismiss the help text and restore the original content:

    HelpReturn

Now you are ready to learn about portlet preferences. Leave your My Accessory Portlets page running in your browser and move to the next exercise.

 
Top of section

Accessing portlet preferences

Each of the accessory portlets has default content and behavior, defined and stored as preferences. You can customize portlets by modifying portlet preferences.

Procedure To access preferences for a portlet:

  1. Click Personalize on the right side of the My Accessory Portlets page.

    The Portal Personalizer opens.

  2. In the Portal Personalizer select Choose Content.

  3. From the Selected Content box select IFrame and choose Content Preferences:

    IFramePreferences

    The Content Preferences editor opens for the IFrame portlet:

    IFramePreferencesEditor

Now you are ready to access help for portlet preferences. Leave the Content Preferences editor open and move to the next exercise.

Procedure To access help for portlet preferences:

  1. Select Descriptions at the bottom of the Content Preferences editor.

    Help for each preference appears in the Descriptions column of the editor:

    IFramePreferencesDescriptions

  2. Select Hide Descriptions.

  3. Close all browser windows.

 
Top of page

What to do next



Copyright © 2004-2005 Novell, Inc. All rights reserved. Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved.  more ...