22.2 Creating and Maintaining Container Pages

The process of creating and maintaining container pages involves the following steps:

  1. Create a new container page or select an existing container page, as described in Creating Container Pages.

  2. Add content (in the form of portlets) to the page, as described in Adding Content to a Container Page.

    You can also delete content from the page, as described in Deleting Content from a Container Page.

  3. Choose a portal layout, as described in Modifying the Layout of a Container Page.

  4. Arrange the order and position of content on the selected layout, as described in Arranging Content on the Container Page.

  5. Immediately display the new page by specifying the container page URL in your browser, as described in Displaying a Container Page.

You can switch layouts for container pages without losing page contents. When you apply a new layout to a container page, portlets in the page are automatically displayed using the new layout. You might need to fine-tune the content placement in the new layout.

22.2.1 Creating Container Pages

You can create container pages from scratch or by copying existing pages. This section describes both procedures.

To create a container page from scratch:

  1. On the Page Admin page, select Maintain Container Pages.

    The Maintain Container Pages panel displays.

  2. Select the New page action (in the bottom left section of the panel).

    An untitled, uncategorized container page is created.

  3. Specify the page properties of the container page:

    Property

    What to do

    Page Link Name (URI)

    Specify the URI name for the page (as it is to appear within the user interface URL). For example, if you specify the URI:

    MyContainerPage

    it appears within the URL like this:

    http://myappserver:8080/IDMProv/portal/cn/MyContainerPage

    NOTE:The User Application does not support multibyte characters in the Page Link Name (URI) for a portal page. Multi-byte characters are supported in the Page Name.

    Page Name

    Specify the display name for the page. For example:

    My Container Page

    Click Localize to specify localized versions of this name for other languages.

    Navigation Priority

    Specify one of the following:

    • None if you don’t need to assign a priority to this container page.

    • Set value to assign a priority to this container page, relative to other container pages. The priority must be an integer between 0 and 9999, where 0 is the lowest priority and 9999 is the highest.

      Setting priority values is useful if you want to ensure a particular order when pages are listed by priority, or if you want to ensure a particular selection when multiple default pages exist (in the case of a user who belongs to multiple groups).

    Default Shared Page

    See Selecting a Default Shared Page for a Container Page.

    Assign Categories

    Select zero or more of the following categories in which you want the page to belong:

    • Administration

    • General

    Assigning categories is useful if you want to ensure proper organization when pages are listed by category, or if you want to ensure an appropriate subset when pages are filtered by category.

    You Cannot Create New Administration Pages The administrator cannot new Administration pages. If you attempt to create a new page in the Administration category, the page will not be displayed under Application Configuration.

    Description

    Type text that describes the page.

  4. Click Save Page (at the bottom of the page properties section).

To create a container page by copying an existing page:

  1. On the Page Admin page, select Maintain Container Pages.

    The Maintain Container Pages panel displays (as shown in the previous procedure).

  2. In the list of container pages, select the page you want to copy.

    If the list is long, you can refine it (by category or starting text) to more easily find the desired page.

  3. Select the Copy page action (in the bottom left section of the panel).

    A new container page is created with the name Copy of OriginalPageName.

  4. Specify the page properties of the container page (as described in the previous procedure).

  5. Click Save Page (at the bottom of the page properties section).

22.2.2 Adding Content to a Container Page

After you create a container page, the next step is to add content by selecting portlets to place on the page. You can use prebuilt portlets supplied with the Identity Manager User Application or other portlets you have registered.

To add content to a container page:

  1. Open a new or existing page on the Maintain Container Pages panel, then click the Select Content page task (at the bottom of the panel).

    The Content Selector displays in a new browser window.

  2. If you want to display a specific category of available content, select a category from the Filter list.

  3. Select one or more portlets from the Available Content list.

    Hold down Control to select multiple non-contiguous portlets from the list; use Shift to make multiple contiguous selections.

  4. Click Add to move your choices to the Selected Content list.

  5. You can click Content Preferences to edit the preferences of any portlet you have selected for your container page. The preference values you specify take effect for the instance of the portlet that appears on your page.

  6. Click Save Contents.

    Now that you have chosen the content for your container page, you can select a new layout as described in Modifying the Layout of a Container Page, or arrange the content on the current layout as described in Arranging Content on the Container Page.

22.2.3 Deleting Content from a Container Page

In the process of creating container pages, you might want to delete content by removing portlets from a page. You can use the Content Selector or Layout Selector, as described in the following procedures.

To delete content from a container page using the Content Selector:

  1. Open a page on the Maintain Container Pages panel, then click the Select Content page task (at the bottom of the panel).

    The Content Selector displays in a new browser window as shown in Step 1.

  2. Select a portlet you want to delete from the Selected Content list and click Remove.

    The portlet is removed from the page.

  3. Click Save Contents.

To delete content from a container page using the Layout Selector:

  1. Open a page on the Maintain Container Pages panel, then click the Arrange Content page task (at the bottom of the panel).

    The Layout Selector displays in a new browser window, showing the portlets on that page.

  2. Click the X button for a portlet you want to remove.

  3. When you’re prompted for confirmation, click OK.

    The portlet is removed from the page.

  4. Click Save Layout.

22.2.4 Modifying the Layout of a Container Page

When you modify the layout of a container page, existing content is shifted to accommodate the new layout. In some cases, you might need to fine-tune the end result.

To modify the layout of a container page:

  1. Open a page on the Maintain Container Pages panel, then click the Select Layout page task (at the bottom of the panel).

    The Portal Layouts list displays in a new browser window.

  2. Scroll through the choices and select the layout you want.

  3. Click Select Layout.

22.2.5 Arranging Content on the Container Page

After you have designated the content and layout for your container page, you can position the content in the selected layout, add other portlets in specific locations, or delete portlets.

  1. Open a page on the Maintain Container Pages panel, then click the Arrange Content page task (at the bottom of the panel).

    The Layout Selector displays in a new browser window, showing the portlets on that page.

  2. To add a portlet to the page:

    1. Click Add Content in the desired layout frame.

      The Portlet Selector displays in a new browser window.

    2. If you want to display a specific category of available content, select a category from the Filter drop-down list.

    3. Select a portlet you want from the Available Content list.

    4. Click Select Content.

      The Portlet Selector closes and the portlet you selected appears in the target layout frame of the Layout Selector.

  3. If you want to move a portlet to a different location in the layout, follow these browser-specific steps:

    Browser

    What to do

    Internet Explorer

    1. Move your cursor over the title bar of the portlet until the cursor changes to a hand shape.

    2. Hold down the left mouse button and drag the portlet to the desired location in the layout.

    Mozilla

    1. Click the portlet you want to move.

    2. Click inside the destination layout frame.

    The portlet moves to the destination.

  4. If you want to remove a portlet from the layout, follow these steps:

    1. Click the X button for the portlet you want to remove.

    2. When you’re prompted for confirmation, click OK.

      The portlet is removed from the layout.

  5. To edit the preferences of a portlet:

    1. Click the pencil button for the portlet you want to edit.

      The portlet’s Content Preferences display in your browser.

    2. Change preference values, as appropriate.

      The preference values you specify take effect for the instance of the portlet that appears on your page.

    3. Click Save Preferences.

  6. Click Save Layout to record your changes and close the Layout Selector.

22.2.6 Displaying a Container Page

You can display your page by going to the container page URL in your browser. Specify the following URL in your web browser:

http://server:port/IDM-war-context/portal/cn/container-page-name

For example, to display the container page named MyContainerPage:

http://myappserver:8080/IDMProv/portal/cn/MyContainerPage