Director Tutorials

Creating a Container Page

Objective

To create a container page and learn about its default portlets: Portal Page Controller, Page Navigation, and Page Header.

Before you begin See About exteNd Director Tutorials.

Audience These exercises are designed for portal administrators—users who belong to the PortalAdmin administrator ACL group.

Concepts

Exercises

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

Starting the Portal Administration tool

You use the Portal Administration tool to create and maintain container pages. This tool provides a GUI for creating pages, adding and arranging content, selecting layouts, and assigning pages to users and groups.

Procedure To start the Portal Administration tool:

Start the exteNd Application Server where the Express Portal application has been deployed.
Start a browser.
Start the Express Portal application by entering this URL in your browser:

http://host/ExpressPortal

The default page for a guest user opens in your browser.
Click Login.

The Login dialog opens in your browser:
Log in as a portal administrator, then click login or the Enter key.

TIP: A portal administrator is a user who is a member of the PortalAdmin administrator ACL group. Check with your system administrator for the username and password to use.

The default page for portal administrators opens in your browser.
Start the Portal Administration tool by selecting Portal Administration.

The Portal Administration tool opens in your browser.

Now you are ready to create a container page. Leave the Portal Administration tool running and move to the next exercise.

Creating a container page

Portal administrators can create and maintain container pages using the Portal Administration tool. A container page is a page that wraps shared and personal pages with a consistent look and feel.

Procedure To create a container page:

Select Maintain Container Pages in the Portal Administration tool:

The container page administration tool opens in your browser.
Select New Page.

A new, untitled page appears in the Container Pages list.

In the fields provided, enter the following information about the new container page:

Field	What to specify
Page URI	Enter MyContainerPage.
Page Name	Enter MyContainerPage.
Default Shared Page	Do not enter a default shared page.
Description	Enter a description of the page.
Categories	Do not assign any categories to the container page. NOTE: If you have not created any page categories, you will see the message No Categories Defined.
Priority	Enter 999 (the highest allowed value). NOTE: The priority setting determines which container page to display if there is no explicit page assignment for the logged in user. The page with the highest priority value is the page displayed.

Click Update Page.

The new page and its specifications are recorded in the portal.

Now you are ready to view the default layout of your container page. Leave your new container page selected in the container page administration tool and move to the next exercise.

Viewing the layout of a container page

exteNd Director provides a Portal Layouts tool for assigning layouts to portal pages. The default layout for container pages is the Header Nav Content layout, as described in the next procedure.

Procedure To view the layout of a container page:

With your container page selected in the container page administration tool, select Choose Layout.

The Portal Layouts tool opens:

Note that the Header Nav Content layout is selected by default. As its name suggests, this layout partitions the page into header, navigation, and content areas. This is the layout you will use for your container page.
Scroll through the other layouts to see what options are available, but leave the Header Nav Content layout selected.
Click Cancel to close the Portal Layouts tool and return to the container page administration tool.

You are now ready to add content to your new container page. Leave the page selected in the container page administration tool and move to the next exercise.

Adding content to a container page

The content of container pages—and all other types of exteNd Director portal pages—is generated by portlets. You add portlets to portal pages using the Content Selector tool, as described in the next procedure.

exteNd Director provides a set of prebuilt portlets that encapsulate business logic that you can add to your pages. You can also develop your own portlets in exteNd Director to generate custom content for portal pages, as described in Strategies for Developing Portlets.

Procedure To add content on a container page:

With your container page selected in the container page administration tool, select Choose Content:

The Content Selector tool opens in a new browser window.
Look at the Available Content list.

This is a list of all portlets that have been registered in the Express Portal application. Registered portlets are also called portlet registrations.

Look at the Selected Content list.

Note that three registered portlets have been added to the container page by default:

Portlet	Description
Page Header	Provides a mechanism for creating a customized look and feel for Web pages in an organization—typically in the header pane of a container page
Page Navigation	Provides a graphical user interface that lets users navigate to all container, shared, and personal pages that they are authorized to access—typically in the navigation pane of a container page
Portal Page Controller	Displays the currently selected shared page or personal page in the container page—typically in the content pane. IMPORTANT: Every container page must contain one Portal Page Controller portlet to designate the area for displaying the content of a shared or personal page. The Portal Administration tool automatically adds this portlet to each container page you create.

Portlet

Description

Page Header

Provides a mechanism for creating a customized look and feel for Web pages in an organization—typically in the header pane of a container page

Page Navigation

Provides a graphical user interface that lets users navigate to all container, shared, and personal pages that they are authorized to access—typically in the navigation pane of a container page

Portal Page Controller

Displays the currently selected shared page or personal page in the container page—typically in the content pane.

IMPORTANT: Every container page must contain one Portal Page Controller portlet to designate the area for displaying the content of a shared or personal page. The Portal Administration tool automatically adds this portlet to each container page you create.

You will learn more about these portlets in later exercises.

Add the Bookmark portlet to your container page by following these steps:
1. Select Accessory Portlets from the Filter dropdown:
  
  The complete list of accessory portlets appears in the Available Content list.
2. Select Bookmark and click Add.
  
  The Bookmark portlet is added to the Selected Content list.
Click Save Contents to record your changes and dismiss the Content Selector.

Now you are ready to arrange content based on the layout of your container page. Leave the page selected in the container page administration tool and move to the next exercise.

Arranging content on a container page

You use the Layout Selector to position portlets within the layout of the container page.

Procedure To arrange content on a container page:

With your container page selected in the container page administration tool, select Arrange Content:

The Layout Selector tool opens in your browser.

NOTE: The Portal Administration tool makes its best guess as to where to place portlets within the Header Nav Content layout. For example, it appropriately places the Page Header portlet in the Header pane, Page Navigation portlet in the Nav pane, and Portal Page Controller portlet in the Content pane. However, you will move the Bookmark portlet to the Nav pane in the next step.
In the Layout Selector tool, click the title bar of the Bookmark portlet, then click the area under the Page Navigation portlet.

The Bookmark portlet should move under the Page Navigation portlet, as shown:
Click Save Layout to record your changes and dismiss the Layout Selector tool.

Now you are ready to choose a default shared page to display inside your new container page. Leave the page selected in the container page administration tool and move to the next exercise.

Choosing a default shared page for a container page

In this exercise you will choose a default shared page to be displayed inside your container page (if no other shared or personal page has been selected).

Procedure To choose a default shared page for a container page:

In the container page administration tool, select MyContainerPage in the list of Container Pages, then click Pick Default under the Default Shared Page field:

The Portal Shared Page Picker opens in a separate window.
Select exteNd Welcome from the list of shared pages and click OK.
Click Update Page.

Now you are ready to view your container page. Close all browser windows and move to the next exercise.

Viewing a container page

There are several ways to view a container page:

From a navigation link on a portal page
By typing an URL directly in a browser

This section describes both procedures.

Procedure To view a container page from a navigation link:

In this exercise, you will view your container page from a navigation link on the default portal page for portal administrators. The navigation links are generated by the Page Navigation portlet. You will learn more about this portlet in a later exercise.

Open a new browser, start the ExpressPortal application, and log in again as the same portal administrator.

TIP: You can review these steps in Starting the Portal Administration tool.

MyContainerPage displays in your browser:

As you can see, the Portal Page Controller portlet displays the content of exteNd Welcome—the page you designated as the default shared page for your container page in the exercise Choosing a default shared page for a container page. This shared page contains two portlets—Novell exteNd Introduction and Welcome Message—which generate the content you see in the Content pane of MyContainerPage.

Procedure To view a container page by typing an URL directly in a browser:

In your current browser session, enter the following URL to view MyContainerPage:
```
  http://server/ExpressPortal/portal/cn/MyContainerPage
```
For example, if your server is localhost, enter:
```
  http://localhost/ExpressPortal/portal/cn/MyContainerPage
```
MyContainerPage displays in your browser.

NOTE: If you enter the URL in a new browser session, you will need to log in again as the portal administrator, as described in Starting the Portal Administration tool.