52 Integrating the RSS Service

52.2.2.1 About RSS Viewer Task Flow

The RSS service has a single task flow called RSS Viewer, which you can add to your application to enable your users to access an RSS feed. You can add multiple instances of the task flow to your application and use the Edit Task Flow Binding dialog to point to multiple RSS feed locations.

52.2.2.2 How to Add the RSS Viewer Task Flow to Your Application

To add the RSS Viewer task flow to your application:

1. Follow the steps in Section 7.2.1, "How to Prepare Your Application to Consume Services" to implement security, and create a customizable page in your application, if necessary.

2. Open the customizable page on which you want to add the RSS Viewer task flow.

3. If the RSS feed you want to use requires authentication, create an external application. If it does not require authentication, proceed to Step 4.

   Note:

   For more information about external applications, refer to Section 67.13, "Working with External Applications."

4. In the Resource Palette, open the WebCenter Services Catalog, then expand the Task Flows folder.

5. Click RSS Viewer, drag it to your page in the Design view, and choose Region.

6. In the Edit Task Flow Binding dialog, specify the URL of the RSS feed. If an external application is used for authenticating the RSS feed, specify its name (the application name, not the application display name), as shown in Figure 52-4.

   Figure 52-4 Example of the Edit Task Flow Binding Dialog for the RSS Service

   
   Description of "Figure 52-4 Example of the Edit Task Flow Binding Dialog for the RSS Service"
   
   

   Table 52-1 describes the possible values for the RSS Viewer task flow binding parameters.

   Table 52-1 RSS Viewer Task Flow Binding Parameters

   Parameter	Value
   rssFeedLocation	Enter the location of the RSS feed. For example, to use the Oracle Press Releases RSS feed, enter: ${'http://www.oracle.com/rss/rss_ocom_pr.xml'}
   extAppId	Enter the name of the external application you want to use to authenticate the WebCenter Portal application with the RSS feed. If the RSS feed does not require authentication, you do not need to set up and identify an external application for this service.

   
   

7. Click OK and save your page. The binding displays on your page.

   If you look at the Source tab of your page, you can see the RSS Viewer task flow in the page source, as shown in Example 52-1.

   Example 52-1 RSS Viewer Task Flow in the Page Source

   <af:form id="f1">
        <af:region value="#{bindings.RSSViewerTaskFlow1.regionModel}" id="r1"/>
        <af:region value="#{bindings.RSSViewerTaskFlow2.regionModel}" id="r2"/>
   </af:form>
   

52.2.2.3 How to Modify RSS Viewer Task Flow Parameters

The RSS Viewer task flow has required and optional task flow binding parameters.

You can adjust the parameter values when you drop the task flow onto a page or after you have placed a task flow on a page:

1. Navigate to the Edit Task Flow Binding dialog by clicking the Bindings tab at the bottom of the page (next to the Source tab).

2. Under Executables, the RSS Viewer task flow you added is listed (Figure 52-5).

   Figure 52-5 Page Data Binding Definition

   
   Description of "Figure 52-5 Page Data Binding Definition"
   
   

3. Select the task flow, and next to the Executables heading, click the Edit selected element (pencil) icon.

4. In the Edit Task Flow Binding dialog, revise the binding parameter values as required.

5. When you are finished, click OK.

6. Save and run your page to see the results.