20.2 Enabling Users to Subscribe to a Page or Item

You can enable users to subscribe to a page or items on a page, so that they can be notified whenever that page or item is updated. Note, however, that subscriptions are not possible unless Enable Approvals and Notifications is enabled for the relevant page group.

You can add the Subscribe link or icon to any page or region at any time. However, the Subscribe link or icon is visible only if the page group administrator has enabled approvals and notifications for the page group. See Section 5.4.2, "Enabling Approvals and Notifications for a Page Group."

Additionally, to enable users to subscribe to a page, you must have at least Manage Content privileges on the page. To enable users to subscribe to an item, you must have at least Manage privileges on the page that contains the item.

Enabling Users to Subscribe to a Page

Subscribing to a page automatically subscribes a user to every item on that page. To enable users to subscribe to a page:

  1. Go to the page you will work with.

    For information on locating a page, see Section 8.1, "Locating Pages in Oracle Portal."

  2. Switch to Edit mode.

  3. Click the Add Item icon in an item region.

    If the page does not have any item regions, you will need to add a new region to the page and make that region an item region.

    Even if there is already an item region in the page, you may want to create a new region at the top of the page specifically for the Subscribe link. If the page includes a navigation page, you may want to consider adding the Subscribe link to the navigation page instead of the page itself.

  4. From the Built-In Navigation Item Types list, select Portal Smart Link.

  5. Click Next.

  6. In the Portal Smart Link list, choose Subscribe.

  7. If you want to use the default label for the Subscribe link, select Use The Default Display Name.

    Using the default display name means that the display name will be automatically translated if users view the page in a different language.

    When you select this check box, the Display Name field is cleared.

  8. If you want to provide your own label for the Subscribe link, enter it in the Display Name field.

  9. If you want to use an image instead of a label:

    1. Provide the name of the image in one of the Image fields:

      You can add images in the JPEG, GIF, or PNG formats.

      In the first field, click the Browse button to locate and select a file on your file system.

      OR

      In the second field, either enter the URL and file name of an image on the Web, or enter the internal name of an image already uploaded to Oracle Portal, for example 1655.gif. To get the internal name of the image, right-click the image in your portal, and select Properties from the resulting menu.

      If you are using item versioning and you always want to show the current version of an image—whether the image is the item itself or an attribute associated with the item—use the image's durable URL instead of the internal file name. The durable URL always picks up the latest version of the image. For more information, see Section 14.12.4, "Images and Item Versioning."

    2. In the Image Alignment field, choose how you want the image to be aligned within the region.

      For descriptions and examples of image alignment options, see Table 13-1, "Item Image Alignment Options" in Chapter 13.

  10. Click Finish.

    Users can now click the Subscribe link to be notified whenever that page is updated. Subscribing to a page automatically subscribes a user to every item on that page.

Users are notified through the My Notifications portlet of the changes to pages or items they have subscribed to. Users must have access to a page that includes the My Notifications portlet. Also, the My Notifications portlet must be set up to display subscription notifications. See Section 2.4.3, "Setting Up the My Notifications Portlet to Show Your Subscriptions."

Enabling Users to Subscribe to an Item

To enable users to subscribe to an item:

  1. Go to the page you will work with.

    For information on locating a page, see Section 8.1, "Locating Pages in Oracle Portal."

  2. Switch to Edit mode.

  3. Click the Edit icon in the region you will work with.

  4. Click the Attributes tab.

  5. From the Available Attributes list, select Subscribe.

  6. Click the Move icon to move the attribute to the Displayed Attributes list.

  7. Click Apply.

    It is very important that you click Apply. If you do not click Apply, any changes that you make to the list of displayed attributes will be lost when you click Close.

  8. Click Close.

    Users can now click the Subscribe icon next to any item in the region to be notified whenever that particular item is updated.

Users are notified of changes through the My Notifications portlet. Users must have access to a page that includes the My Notifications portlet. Also, the My Notifications portlet must be set up to display subscription notifications.

If you include a Subscribe link on a template, all the pages that are based on the template will include the link. When users subscribe to the pages, they will receive notifications when the pages and the template itself are updated.

Enabling Users to Subscribe to Items on a Tab

If your page contains tabs, you can add a Subscribe link at the tab level. Subscribing to a tab automatically subscribes a user to every item on that tab.

Note:

Provide Subscribe links at the page level or the tab level, but not both. When a user subscribes to a page, the user is automatically subscribed to all items on the page (including items on tabs). If you provide a Subscribe link on a tab, it has no effect if the user is already subscribed to the page, and this behavior could be confusing for the user.

To enable users to subscribe to a tab:

  1. Go to the page you will work with.

    For information on locating a page, see Section 8.1, "Locating Pages in Oracle Portal."

  2. Switch to Edit mode.

  3. Click the Add Item icon in the tab.

  4. From the Built-In Navigation Item Types list, select Portal Smart Link.

  5. Click Next.

  6. In the Portal Smart Link list, choose Subscribe.

  7. If you want to use the default label for the Subscribe link, select Use The Default Display Name.

    Using the default display name means that the display name will be automatically translated if users view the page in a different language.

    When you select this check box, the Display Name field is cleared.

  8. If you want to use an image instead of a label, enter Image and Image Alignment details as described previously in Section 20.2, "Enabling Users to Subscribe to a Page" - Step 9.

  9. Click Finish.

    Users can now click the Subscribe link to be notified whenever items on that tab are updated.

Users are notified of changes through the My Notifications portlet. Users must have access to a page that includes the My Notifications portlet. Also, the My Notifications portlet must be set up to display subscription notifications.