Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter
11g Release 1 (11.1.1)
E10149-01
  Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

28 Working with the RSS Service

The RSS service provides the ability to publish content from WebCenter services as news feeds in RSS 2.0 and Atom 1.0 formats. News feeds deliver content update information to your favorite RSS or Atom reader. In addition, the RSS service also enables you to view news feeds from external sources on your application pages in an RSS Viewer.

The RSS service exposes its features in three ways:

This chapter describes how to use the RSS service features. It contains the following sections:

Audience

This chapter is intended for users interested in publishing news feeds from external sources on their application pages. Additionally, WebCenter Spaces users interested in accessing published content from WebCenter Services as news feeds may find this chapter useful.

The WebCenter Spaces application administrator has the authority to expose or hide task flows from a particular service. Tasks discussed in this chapter are not available to you if the relevant service is hidden.


Note:

For information about WebCenter Spaces seeded user roles, see Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

28.1 What You Should Know About the RSS Service

The RSS icon on a service task flow enables you to publish content from the WebCenter service as news feeds, and the RSS task flow enables you to view news feeds from external sources.

28.1.1 RSS Icon

Oracle WebCenter Spaces service news feeds deliver content update information on the Recent Activities, Discussions, Lists, and Announcements services. Figure 28-1 shows the RSS icon available on a Recent Activity task flow in a WebCenter Spaces page.

Figure 28-1 RSS Icon on a Recent Activity Task Flow

RSS icon on a Recent Activity task flow
Description of "Figure 28-1 RSS Icon on a Recent Activity Task Flow"

In a WebCenter Spaces application, you can obtain news feeds from individual task flow instances and, also from the RSS Manager (Figure 28-2).

Figure 28-2 Detail of the RSS Manager in WebCenter Spaces

Detail of the RSS Manager
Description of "Figure 28-2 Detail of the RSS Manager in WebCenter Spaces"

Access the RSS Manager by clicking the RSS link at the bottom of the application (Figure 28-3).

Figure 28-3 The RSS Link in the WebCenter Spaces Application

RSS link in WebCenter Spaces
Description of "Figure 28-3 The RSS Link in the WebCenter Spaces Application"

The RSS Manager displays nodes for all the group spaces that have enabled RSS feeds to be published (Figure 28-4).

Figure 28-4 Expanded Group Space Nodes in the RSS Manager

RSS page
Description of "Figure 28-4 Expanded Group Space Nodes in the RSS Manager"

Expand a group space node to obtain both RSS 1.0 and Atom 2.0 news feeds from individual services.

A group space must be news feed-enabled before you can obtain feed URLs from it (see Section 11.3.5, "Enabling or Disabling RSS News Feeds for a Group Space"). Additionally, your reader of choice must support HTTP authentication.

When you access a news feed item in your reader of choice, the item links back into your WebCenter application. Because the application itself requires authentication before you can access much of its content, your reader must be equipped to pass your login credentials to securely deliver access.

The level of detail provided through a WebCenter service news feed depends on the feed source. For example, when you pull a news feed for recently added or modified lists, your news reader provides the list titles and (if provided) list descriptions of the most recently added or modified lists (Figure 28-5).

Figure 28-5 A Group Space Lists News Feed

Group space lists news feed
Description of "Figure 28-5 A Group Space Lists News Feed"

The list titles in a feed are linked. Click a list title, and it takes you back into your WebCenter application with the selected list displayed as a top-level tab (Figure 28-6).

Figure 28-6 A List Opened from an RSS Feed and Displayed as a Top-Level Tab in WebCenter Spaces

List displayed as top-level tab
Description of "Figure 28-6 A List Opened from an RSS Feed and Displayed as a Top-Level Tab in WebCenter Spaces"

In contrast, when you pull a news feed from a particular list, it shows recently added or revised row details and provides links to individual rows (Figure 28-7).

Figure 28-7 List Details in an RSS Feed

List details in an RSS feed
Description of "Figure 28-7 List Details in an RSS Feed"

When you click such a link, it also takes you back into your WebCenter application, with the list displayed as a top-level tab (see Figure 28-6).

The news feeds you obtain from a WebCenter Spaces application are context-aware, providing content only from the space from which they originate. For example, if you provide a list feed from the Finance group space, your news reader displays list content that is unique to the Finance group space. If you add a list feed from the Languages group space, your news reader displays list content that is unique to the Languages group space.

Additionally, you can grab a news feed URL from a Recent Activity list located in your personal space. That RSS feed can provide add and update news from a particular group space.

In WebCenter Spaces, you can obtain news feed URLs for all applicable services from two locations:

The RSS service delivers news feeds from four services:

  • Recent Activities service

    The recent activity news feed tracks updates to your WebCenter application that are normally reflected in a Recent Activity list and that have occurred within the last three days. For more information, see Section 28.2.1, "Obtaining the Recent Activities News Feed."

  • Discussion Forums

    The discussion forums news feed tracks updates to all discussion forums in a particular group space in the WebCenter Spaces application. See Section 28.2.2, "Obtaining the Discussion Forums News Feed."

  • Lists (WebCenter Spaces only)

    There are two types of news feeds that can be delivered from the Lists service—all newly created or changed lists in a group space (from the List Manager task flow) and revisions to the data of a particular list in a group space (from the List Viewer task flow). The news feed content depends on whether you get the news feed URL from the List Manager task flow or from the List Viewer task flow. For more information, see Section 28.2.3, "Obtaining List News Feeds."

  • Announcements

    The Announcements news feed tracks additions and revisions to announcements from a particular group space, from all group spaces, or application-wide, depending on the location of the feed source. For more information, see Section 28.2.4, "Obtaining an Announcements News Feed."

28.1.2 RSS Task Flow

If you want to add a news feed from an external site to your WebCenter application, the RSS service provides an RSS task flow (Figure 28-10) through the Catalog dialog box in Edit mode of the page.

Figure 28-10 The RSS Task Flow

RSS task flow
Description of "Figure 28-10 The RSS Task Flow"

You can place the RSS task flow on a page and configure it to display content from any external RSS feed. Additionally, the RSS task flow supports login credential passing by using an external application.


Notes:


The RSS task flow can render news feeds outside of the corporate firewall. However, to consume external news feeds outside of the firewall, your application administrator must have configured proxies for the RSS service. Contact your application administrator if you cannot consume external feeds but want to do so. See Section 2.7, "Contacting Your Application Administrator" for information.

Accessing External Applications

Every time you access a secure news feed item, you must log in to that secure application to view content. You can either supply login credentials each time you access an application, or let an external application store and manage your login credentials. After your credentials for a particular application are stored, you are logged in to that application automatically when you log in to your WebCenter application. You can provide this capability for all frequently-used external application. For more information about external applications, see Section 3.8, "Working with External Applications."

If a secured application you want to access is not registered as an external application, then do the following:

28.2 Obtaining Service News Feeds

Each participating service provides news feeds from locations unique to that service. This section steps you through obtaining those feeds. It contains the following subsections:

28.2.1 Obtaining the Recent Activities News Feed

Use news feeds from the Recent Activities service to keep track of the wide range of activity happening in one or more group spaces within the last three days. To consume a group space Recent Activities news feed, you must be a member of the selected group space and the group space must be enabled to provide news feeds.

WebCenter Spaces provides two locations for pulling a news feed from the Recent Activities service: the RSS Manager and the Recent Activity task flow.

Both the RSS Manager and the Recent Activity task flow provide the same news feed content: additions or revisions to group spaces and group space pages, documents, discussion forums, lists, and the like. (For more information, see Chapter 27, "Working with the Recent Activities Service.")

Assuming a default configuration, a news feed URL from a Recent Activity task flow in a group space provides information about the activity in that group space. A news feed URL from a Recent Activity task flow in your personal space provides information about the activities in a particular group space.


Note:

A Recent Activity task flow can be configured to display the recent activity of a group space other than the one where it has been placed. In such a case, the news feed from that list provides information on the activities of the group space identified during configuration. For information about setting properties on a Recent Activity task flow, see Section 27.3, "Setting Recent Activities Service Task Flow Properties."

This section describes how to obtain a news feed for the Recent Activity task flow from both locations. It contains the following subsections:

28.2.1.1 Obtaining a Recent Activity News Feed URL from the RSS Manager

The RSS Manager provides news feeds for both RSS 2.0 and Atom 1.0 news readers. It lists all RSS-enabled group spaces of which you are a member. Each listed group space can be expanded to display the services for which it offers news feeds (Figure 28-11).

Figure 28-11 The Recent Activity Service under a Group Space in the RSS Manager

Recent Activity service in the RSS Manager
Description of "Figure 28-11 The Recent Activity Service under a Group Space in the RSS Manager"

To obtain a Recent Activity list news feed URL from the RSS Manager:

  1. Log in to WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Click the RSS link at the bottom of the WebCenter Spaces application (Figure 28-12).

    Figure 28-12 The RSS Link

    Description of Figure 28-12 follows
    Description of "Figure 28-12 The RSS Link"

    The RSS Manager opens (Figure 28-13).

    Figure 28-13 The RSS Manager

    RSS page
    Description of "Figure 28-13 The RSS Manager"

  3. If necessary, expand the node of the group space for which you want to monitor recent activities.

    You can expand a group space node by clicking the Expand icon to the left of it or by right-clicking the group space name and selecting an expand option from the resulting context menu (Figure 28-14).

    Figure 28-14 Expand Context Menu in RSS Manager

    Expand icon and Expand context menu in RSS Manager
    Description of "Figure 28-14 Expand Context Menu in RSS Manager"

  4. Under the relevant group space, right- click the RSS 2.0 or Atom 1.0 icon next to the Recent Activity list you want to monitor, and, from the resulting browser context menu, select the copy-link command.

    The command you select depends on your current browser. For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

  5. Go to your news reader and initiate an add-subscription action.

    How you do this depends on the news reader you use.

  6. Paste the link you copied in step 4 into the relevant field in your news reader.

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.1.2 Obtaining a News Feed URL from the Recent Activity Task Flow

The Recent Activity task flow has its own RSS icon. Using this you can get the Recent Activity list news feed URL. Recent Activity RSS feeds provide the same information that you can find in a Recent Activity list. This includes such things as additions or revisions to pages, documents, discussion forums, lists, and the like. The news feed tracks activity occurring over the last three days.

For an RSS icon to be active in a Recent Activity task flow, you must be a member of the group space from which you want to obtain the news feed and news feeds must be enabled for the relevant group space.

To obtain a Recent Activity list news feed URL from the Recent Activity list:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to your personal space or the group space that contains the Recent Activity list from which you want to obtain an RSS feed.

    For information about navigating to a group space, see Section 2.4.4, "Opening Group Spaces." Typically, your personal space tab is always on view. If necessary, click the Personal Space tab to bring it forward. A group space may be configured to display in full-screen mode. For more information, see Section 10.7.5, "Setting the Group Space Default Display Mode".

  3. Right- click the RSS icon in the toolbar of the Recent Activity list (Figure 28-15), and, from the resulting context menu, select the copy-link command.

    Figure 28-15 The RSS Icon on the Recent Activity List

    RSS icon on the Recent Activity list
    Description of "Figure 28-15 The RSS Icon on the Recent Activity List"

    The command you select depends on your current browser. For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Alternatively, drag the RSS icon and drop it into your news reader of choice. This may allow you to skip the other steps in this procedure. If you drag-and-drop, you may have to enter WebCenter Spaces log-in information at this point. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  4. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  5. Paste the link you copied in step 3 into the relevant field in your RSS reader.


    Note:

    The news feed URL in a Recent Activity task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.2 Obtaining the Discussion Forums News Feed

Use Discussion Forum news feeds to keep track of additions and revisions to a selected group space's discussions. There are three locations from which to obtain discussion forums news feed URLs: in the RSS Manager, on the Discussions page, and from a Discussion Forum Manager task flow. All discussion RSS and Atom URLs provide the same feed, that is, additions and revisions to all discussions in a selected group space.

This section describes how to get a news feed URL from the Discussions page, the RSS Manager, and a Discussion Forum Manager task flow. It contains the following subsections:

28.2.2.1 Obtaining a Discussion Forum News Feed from the RSS Manager

The RSS Manager provides Discussion Forum news feeds for both RSS 2.0 and Atom 1.0 news readers. Select a feed from any news-feed-enabled group space of which you are a member. Use discussion forum news feeds to track additions and revisions to a selected group space's discussion forums. This section tells you how.

To obtain a discussion forum news feed URL from the RSS Manager:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Click the RSS link at the bottom of the WebCenter Spaces application (Figure 28-16).

    Figure 28-16 The RSS Link

    RSS button
    Description of "Figure 28-16 The RSS Link"

    The RSS Manager opens (Figure 28-17).

    Figure 28-17 The RSS Manager

    RSS page
    Description of "Figure 28-17 The RSS Manager"

  3. If necessary, expand the node of the group space that contains the discussions you want to use as a news feed.

    You can expand a group space node by clicking the Expand icon to the left of it or by right-clicking the group space name and selecting an expand option from the resulting context menu (Figure 28-18).

    Figure 28-18 Expand Context Menu in RSS Manager

    Expand icon and Expand context menu in RSS Manager
    Description of "Figure 28-18 Expand Context Menu in RSS Manager"

  4. Right-click the RSS 2.0 or Atom 1.0 icon next to Discussions (Figure 28-19), and, from the resulting context menu, select the copy-link command.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-19 RSS and Atom Icons Next to a Discussions Node in the RSS Manager

    RSS and Atom icons next to a Discussions node
    Description of "Figure 28-19 RSS and Atom Icons Next to a Discussions Node in the RSS Manager"

    Alternatively, if you drag the RSS icon and drop it into a news reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  5. Go to your news reader and initiate an add-subscription action.

    How you do this depends on the news reader you use.

  6. Paste the link you copied in step 4 into the relevant field in your preferred news reader.

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.2.2 Obtaining a News Feed from the Discussions Page

The Discussions page provides a convenient location for grabbing a news feed URL while monitoring discussions.

To get an RSS URL for all of a selected group space's discussions from the Discussions page:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to the group space that contains the discussion forums you want to use as an RSS feed.

    For information about navigating to a group space, see Section 2.4.4, "Opening Group Spaces." For information about showing hidden pages, see Section 2.4.3, "Showing Hidden Pages."

  3. Click the Discussions tab to bring the Discussions page forward.

    If the Discussions tab is not available, open the Manage Pages dialog box and select the Discussions page for display. When the tab opens, click it to bring the page forward. For more information about locating and opening pages, see Section 2.4, "Hiding, Showing, Opening, and Closing Pages."

  4. Right-click the RSS icon on the Discussions page (Figure 28-20), and, from the resulting context menu, select the copy-link command.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-20 An RSS Icon on a Discussions Page

    RSS icon on a Discussions page
    Description of "Figure 28-20 An RSS Icon on a Discussions Page"

    Alternatively, if you drag the RSS icon and drop it into your news reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  5. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  6. Paste the link you copied in step 4 into the relevant field in your preferred RSS reader.


    Note:

    The news feed URL on the Discussions page is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.2.3 Obtaining a News Feed from a Discussion Forum Manager Task Flow

The Discussion Forum Manager task flow provides another location from which you can obtain a discussions news feed for a selected group space. The placement of this task flow within a group space is at the discretion of the space's designers, so we cannot pinpoint where you may find this task flow. But, wherever you find it, an RSS icon is also available to provide you with an RSS news feed URL. This section describes how to use it.

To obtain a news feed URL from a Discussion Forum Manager task flow:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to the page in a group space that contains a Discussion Forum Manager task flow.

    For information about navigating to a group space, see Section 2.4.4, "Opening Group Spaces." For information about showing hidden pages, see Section 2.4.3, "Showing Hidden Pages."

  3. Right-click the RSS icon on the task flow (Figure 28-21), and, from the resulting context menu, select the copy-link command.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-21 An RSS Icon in a Discussion Forum Manager Task Flow

    RSS icon in a Discussion Forum Manager Task Flow
    Description of "Figure 28-21 An RSS Icon in a Discussion Forum Manager Task Flow"

    Alternatively, if you drag the RSS icon and drop it into your news reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  4. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.


    Note:

    The news feed URL in the Discussions task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.3 Obtaining List News Feeds

Lists provide a vital form of tracking just about everything within an organization. For example, a group might want a membership list that outlines assigned roles and contact information. A project lead might set up a list that tracks issue resolution.

It follows that it would be useful to you to track creation of and revisions to such lists from one convenient location: your favorite news reader.

The Lists service provides two options for keeping track of changes through a news reader:

  • Keep track of all recently added or modified lists in a given group space.

  • Keep track of recently added or modified data rows in one list.

You can obtain the news feed URL for lists from three locations: the RSS Manager, the Lists page, and any Lists task flow on a given page. The RSS Manager and the Lists page provide access to both types of Lists feeds. Individual List task flows provide feeds for data changes to the rows of the displayed list.

This section describes how to obtain a news feed for recently added or modified list rows or lists from a selected group space. It includes the following subsections:

28.2.3.1 Obtaining a List News Feed from the RSS Manager

The RSS Manager provides two types of list news feeds: a feed of recently added or revised lists in a group space and a feed of recent data changes to the rows of one particular list. Additionally, the RSS Manager provides feeds for an RSS 2.0 reader and an Atom 1.0 reader. The main requirement for any news reader you use is that it supports HTTP authentication (for more information, see Section 28.1, "What You Should Know About the RSS Service").

To obtain a list news feed from the RSS Manager:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Click the RSS button at the bottom of the WebCenter Spaces application (Figure 28-22).

    Figure 28-22 The RSS Link

    RSS button
    Description of "Figure 28-22 The RSS Link"

    The RSS Manager opens (Figure 28-23).

    Figure 28-23 The RSS Manager

    RSS page
    Description of "Figure 28-23 The RSS Manager"

  3. In the RSS Manager, expand the node for the group space that contains the lists from which to obtain an RSS feed.

    If you want to get a feed from a particular list, expand the List Service node.

  4. Right-click the RSS 2.0 or Atom 1.0 icon next to List Service for all lists or next to a selected list (Figure 28-24), and, from the resulting context menu, select the copy-link command.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-24 The Lists Service Node on the RSS Page

    List Service node on RSS page
    Description of "Figure 28-24 The Lists Service Node on the RSS Page"

    Alternatively, if you drag the news feed icon and drop it into your reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  5. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  6. Paste the link you copied in step 4 into the relevant field in your preferred RSS reader.

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.3.2 Obtaining a News Feed from the Lists Page

Each group space has its own Lists page, where lists are born. Each Lists page provides RSS news feeds for recent additions and revisions to all of the lists it contains and, also for recent data changes to the rows of an individual list.

This section describes how to obtain news feed URLs from the Lists page. Note that the Lists page provides news feeds for RSS 2.0 readers only. If you want to obtain a feed for an Atom 1.0 news reader, use the RSS Manager. For more information, see Section 28.2.3.1, "Obtaining a List News Feed from the RSS Manager."

To obtain a news feed from the Lists page:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to the group space that contains the list you want to track.

    For information about navigating to a group space, see Section 2.4.4, "Opening Group Spaces." For information about showing hidden pages, see Section 2.4.3, "Showing Hidden Pages."

  3. Click the Lists tab to bring the Lists page forward.

    If the Lists tab is not available, open the Manage Pages dialog box and select the Lists page for display. For more information, see Section 2.4, "Hiding, Showing, Opening, and Closing Pages."

  4. To obtain a news feed of recently added and revised lists in a group space, right-click the RSS icon in the Lists pane on the left side of the Lists page (Figure 28-25), and select the copy-link command from the resulting context menu.

    To obtain a news feed of data changes to the rows of an individual list, display the list in the right pane by selecting the list name from the left pane (Figure 28-25); right-click the RSS icon that appears above the list, and select the copy-link command from the resulting context menu.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-25 Selecting a List on the Lists Page

    Selecting a list on the Lists page
    Description of "Figure 28-25 Selecting a List on the Lists Page"

    Alternatively, if you drag the news feed icon and drop it into your reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  5. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  6. Paste the link you copied in step 4 into the relevant field in your preferred RSS reader.


    Note:

    The news feed URL on the Lists page is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.3.3 Obtaining a News Feed from a List Task Flow

As you navigate through group space pages in your WebCenter Spaces application, you may come across a list you find particularly informative, for example, a list of project issues. It may be useful to you to track recent additions and revisions to such a list. Luckily, each List task flow comes with its own RSS news feed, making it easy to subscribe to the list on-the-spot. This section tells you how.

To obtain a news feed from a List task flow:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to the group space that contains the List you want to track.

    For information about navigating to a group space, see Section 2.4.4, "Opening Group Spaces". For information about showing hidden pages, see Section 2.4.3, "Showing Hidden Pages."

  3. Right-click the RSS icon at the top-right of the List task flow (Figure 28-26), and, from the resulting context menu, select the copy-link command.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-26 A List Task Flow

    List Task Flow
    Description of "Figure 28-26 A List Task Flow"

    Alternatively, if you drag the RSS icon and drop it into your news reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  4. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.


    Note:

    The news feed URL in the List task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.4 Obtaining an Announcements News Feed

Announcements are excellent candidates for news feeds. Usually they are short, to the point, and full of timely and valuable information. If you are a member of multiple group spaces, it would be convenient to be able to access all announcements from one location: your favorite news reader.

You can obtain an Announcement news feed from three locations: the RSS Manager, the Announcements page, and an Announcements task flow. This section tells you how. It contains the following subsections:

28.2.4.1 Obtaining an Announcements News Feed from the RSS Manager

The RSS Manager provides two types of feeds for Announcements: RSS 2.0 and Atom 1.0. Use either of these to keep track of all new and revised Announcements in a particular group space. This section tells you how.

To obtain an Announcements news feed from the RSS Manager:

  1. Log in to Oracle WebCenter Spaces.

    For information about logging in, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Click the RSS link at the bottom of the WebCenter Spaces application (Figure 28-27).

    Figure 28-27 The RSS Link

    RSS button
    Description of "Figure 28-27 The RSS Link"

    The RSS Manager opens (Figure 28-28).

    Figure 28-28 The RSS Manager

    RSS page
    Description of "Figure 28-28 The RSS Manager"

  3. In the RSS Manager, expand the node for the group space that contains the announcements you want to track through a news reader.

  4. Right-click the RSS 2.0 or Atom 1.0 icon next to Announcements (Figure 28-24), and, from the resulting context menu, select the copy-link command.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-29 Announcements Node on the RSS Page

    List Service node on RSS page
    Description of "Figure 28-29 Announcements Node on the RSS Page"

    Alternatively, if you drag the news feed icon and drop it into your reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  5. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  6. Paste the link you copied in step 4 into the relevant field in your preferred RSS reader.

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.4.2 Obtaining a News Feed from the Announcements Page

The Announcements service provides an Announcement Manager task flow, which is exposed from the main Announcements page in the WebCenter Spaces application. You can use this task flow to create and revise announcements and to obtain an announcements news feed URL.

Unlike the RSS Manager, the Announcement Manager task flow provides a news feed only for RSS 2.0 news readers. If you prefer an Atom 1.0 feed, use the RSS Manager to obtain the feed URL in lieu of the Announcement Manager task flow. For more information, see Section 28.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager."

To obtain a news feed from the Announcement Manager task flow:

  1. Log in to your application.

    For information about logging in to WebCenter Spaces, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. WebCenter Spaces users, click the Announcements tab to bring the Announcements page forward.

    If the Announcements tab is not available, click the Settings tab and then the Services tab, and select the Announcements page for display. When the tab appears on the page, click it to bring the page forward. For more information, see Section 2.4, "Hiding, Showing, Opening, and Closing Pages."

    Alternatively, custom application and WebCenter Spaces users, click the Open Announcement Manager icon in the Announcements task flow to view the Announcement Manager task flow.


    Note:

    The Open Announcement Manager icon is not displayed in the Announcements task flow if you do not have the required privileges.

  3. Right-click the RSS icon on the right side of the Announcements page (Figure 28-30), and select the copy-link command from the resulting context menu.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-30 The RSS Icon on the Announcements Page

    Selecting a list on the Lists page
    Description of "Figure 28-30 The RSS Icon on the Announcements Page"

    Alternatively, if you drag the news feed icon and drop it into your reader you can skip most of the other steps. In WebCenter Spaces, you may have to enter log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  4. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  5. Paste the link you copied in step 4 into the relevant field in your preferred RSS reader.


    Note:

    The news feed URL on the Announcements page is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.2.4.3 Obtaining a News Feed from an Announcements Task Flow

The Announcements task flow also provides access to a news feed URL. Like the Announcements page, the task flow provides feeds only for RSS 2.0 news readers. If you prefer an Atom 1.0 feed, use the RSS Manager to obtain the feed URL in lieu of the Announcements task flow. For more information, see Section 28.2.4.1, "Obtaining an Announcements News Feed from the RSS Manager."

To obtain a news feed from an Announcements task flow:

  1. Log in to your application.

    For information about logging in to WebCenter Spaces, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to the page that contains the Announcements task flow you want to view.

  3. Right-click the RSS icon on the right side of the Announcements task flow (Figure 28-31), and select the copy-link command from the resulting context menu.

    For example, in the Firefox browser, the copy-link command is Copy Link Location. In the Internet Explorer browser, the copy-link command is Copy Shortcut.

    Figure 28-31 RSS Icon in an Announcements Task Flow

    RSS icon in an Announcements Task Flow
    Description of "Figure 28-31 RSS Icon in an Announcements Task Flow"

    Alternatively, if you drag the news feed icon and drop it into your reader you can skip most of the other steps. You may have to enter WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

  4. Go to your RSS reader and initiate an add-subscription action.

    How you do this depends on the RSS reader you use.

  5. Paste the link you copied in step 3 into the relevant field in your preferred RSS reader.


    Note:

    The news feed URL in the Announcements task flow is for RSS 2.0 news readers only. If you prefer to use an Atom 1.0 news reader, do either of the following:

    At this point, you may also have to supply your WebCenter Spaces log-in information. To learn more, see Section 28.1, "What You Should Know About the RSS Service."

28.3 Working with the RSS Task Flow

The RSS task flow enables you to include an RSS viewer, which can be used to view content from external news feeds within your application page.

This section contains the following subsections:

28.3.1 Adding an RSS Task Flow to a Page

You can incorporate news feeds from external sources into your application pages by using the RSS task flow. You can add the RSS task flow from the component catalog in Oracle Composer.


Note:

In custom applications, the RSS task flow is available in the component catalog only if your application administrator has included it in the catalog and you have the privileges to add this task flow to your page.

Each instance of the RSS viewer displays news feeds from one source. If you plan to display multiple external news feeds on a particular page, you can place multiple RSS task flows on that page.

To display content from an external RSS feed, proxies must be configured in your application. Contact your application administrator if you have problems accessing external RSS feeds in your task flow

WebCenter applications provide the ability to store and manage your login credentials by using external applications. After your credentials for a particular application are stored, you are logged in to that application automatically when you log in to your WebCenter application.

So if an external RSS news feed or WebCenter service requires your login credentials, when you get to the step where you specify the feed URL, you may have to also specify the name of the external application that is configured to store your login credentials for reading the secure RSS feed.

To add the RSS task flow to your page:

  1. Log in to your application.

    For information about logging in to WebCenter Spaces, see Section 2.2.1, "Logging In to a WebCenter Application."

  2. Go to the page where you want to place the RSS task flow.

  3. Switch to Edit mode of the page.

  4. Select the Box component in which you want to place the RSS task flow and click Add Content.

  5. In the Catalog dialog box, locate RSS and click the Add link to the right of this component.

  6. Click Close on the Catalog dialog box to return to the page in Oracle Composer.

    The RSS task flow displays with the following message:

    To display an RSS feed, edit this page, then use the Edit action to enter the RSS feed location on the Parameters tab
    
  7. Click the Edit icon on the header of the task flow to display the Component Properties dialog box in which you can specify the RSS feed for this task flow.

  8. In parallel, start a new browser session and go to the Web site that provides the RSS feed you want to view through the RSS viewer. Copy its RSS URL.

  9. Go back to your application page and on the Parameters tab that is selected by default in the dialog box, for RSS Feed Location, paste the URL that you copied in the previous step.

  10. If the external RSS feed requires authentication, then for External Application Id, specify the name of the external application that is configured to store your login credentials for accessing that feed.

    For information about configuring an external application, see Section 3.8, "Working with External Applications."

  11. Click Apply in the Component Properties dialog box to save your changes and remain in the dialog box.

    Click Close to save your changes and close the dialog box.

    Content from the external feed you specified is displayed within the RSS task flow.

  12. Click Save at the top-right corner of Oracle Composer to save your changes and remain in Oracle Composer.

  13. Optionally, click Close to exit Oracle Composer.


Note:

For generic information about placing a task flow, including the RSS task flow, on a page, see Section 7.1.3, "Adding Task Flows to a Page."

28.3.2 Refreshing an RSS Task Flow

The RSS task flow, along with other page components, gets refreshed with every server request. However, as the content from news feeds may be dynamic, you have the option of refreshing the RSS task flow yourself by using the Refresh icon (Figure 28-32), when required.

Figure 28-32 The Refresh Icon on an RSS Task Flow

Description of Figure 28-32 follows
Description of "Figure 28-32 The Refresh Icon on an RSS Task Flow"

The task flow updates and displays latest data from the external source.

28.3.3 Deleting an RSS Task Flow From the Page

If you have the required privileges, you have the option to delete the RSS task flow from a page by using the Remove icon on the task flow (Figure 28-33) in Edit mode of the page.

Figure 28-33 Remove Icon on an RSS Task Flow

Description of Figure 28-33 follows
Description of "Figure 28-33 Remove Icon on an RSS Task Flow"

When you click the Remove icon, the Delete Component dialog box displays. Click Delete in this dialog box to delete the task flow from the page.

28.3.4 Editing Feed Information for an RSS Task Flow

Whether it is an RSS task flow in a custom application or WebCenter Spaces application, you can change the feed URL or external application ID at any point of time. This section tells you how.

To change the feed for the RSS task flow:

  1. Go to the Web site that provides the RSS feed you want to view through the RSS viewer, and then copy its RSS URL.

  2. Log in to your application.

    For information about logging in to a WebCenter Spaces application, see Section 2.2.1, "Logging In to a WebCenter Application."

  3. Go the page where you have placed the RSS task flow.

  4. Switch to the page's Edit mode.

  5. Click the Edit icon on the header of the RSS task flow (Figure 28-34).

    Figure 28-34 The RSS Task Flow

    WebCenter Spaces RSS reader
    Description of "Figure 28-34 The RSS Task Flow"

    In the Component Properties dialog box, click the Parameters tab to open it (Figure 28-35).

    Figure 28-35 Properties of the WebCenter Spaces RSS Reader

    Selected component and its associated showDetailFrame
    Description of "Figure 28-35 Properties of the WebCenter Spaces RSS Reader"

  6. In the RSS Feed Location field, paste the URL that you copied in step 1.

    For information about the RSS task flow parameters, see Section 28.4.1, "Region Parameters."

  7. If the feed you want to publish requires authentication, then for External Application Id specify the name of the external application that is configured to store your login credentials for accessing that feed.

    For information about external applications, see "Accessing External Applications".

  8. Click Apply in the Component Properties dialog box to save your changes and remain in the dialog box.

    Or click Close to save your changes and close the dialog box.

    Content from the external feed you specified is displayed within the RSS task flow.

  9. Click Save at the top-right corner of Oracle Composer to save your changes and remain in Oracle Composer.

  10. Optionally, click Close to exit Oracle Composer.

28.4 Setting RSS Service Task Flow Properties

The RSS service task flow has associated properties, which users with sufficient privileges can access from the Component Properties dialog box in Oracle Composer. The method for accessing task flow properties is the same from task flow to task flow. For more information, see Section 7.4, "Setting Properties on Page Content."

The task flow parameters listed on the Parameters tab control the default task flow content and facilitate the wiring of the task flow to page parameters and page definition variables. Parameters are unique to the task flow type. This section describes the parameters provided by the RSS task flow.


Note:

For information about wiring components and consuming page parameters and variables, see Chapter 8, "Wiring Pages, Task Flows, Portlets, and UI Components".

Changes to the display- and style-related properties listed on the other tabs affect the appearance and behavior of the RSS task flow instance for all users. These properties are common for all task flows. For more information, see Section 7.4, "Setting Properties on Page Content."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 7.4.7, "Working with Component Contextual Events."

28.4.1 Region Parameters

The RSS task flow has two associated region parameters and Table 28-1 describes these parameters.

Table 28-1 RSS Task Flow Region Parameters

Parameter Description

RSS Feed URL

The URL to access the RSS Feed. For example, to use the Oracle Press Releases RSS Feed, enter:

http://www.oracle.com/rss/rss_ocom_pr.xml

External Application ID

The name of the external application that is configured to store a user's login credentials for reading a secure RSS feed.

If you are not sure whether there is an external application configured to store your credentials, then contact your application administrator. For information about contacting your application administrator, see Section 2.7, "Contacting Your Application Administrator."


For detailed information about Region Parameter properties, see Section 7.4.3, "Working with Component Parameters."