Adding a PeopleSoft Portlet to a WebCenter Application

Purpose

This tutorial shows you how to consume a PeopleSoft self-service page as a WRSP portlet in an Oracle WebCenter application.

Time to Complete

Approximately 20 minutes

Topics

This tutorial covers the following topics:

 Overview
 Scenario
 Prerequisites
 Creating a WSRP Portlet from a Self-Service Page
 Adding a Portlet to a JSF Page
 Summary
 Related information

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: This action loads all screenshots simultaneously, so response time may be slow depending on your Internet connection.)

Note: Alternatively, you can place the cursor over each individual icon in the following steps to load and view only the screenshot associated with that step.

Overview

This tutorial shows how easily you can integrate PeopleSoft portlets in a WebCenter application.

Oracle WebCenter is an integrated suite of technology designed to deliver a unified, context-aware user experience that integrates structured and unstructured content, business intelligence, business processes, communication, and collaboration services. Oracle WebCenter is part of the Oracle Fusion Middleware product family and is based on an open, standards-based architecture. A key feature of WebCenter is that it removes the boundaries between Web-based portals and enterprise applications, and enables the rapid creation of a new generation of context-centric, composite applications that will change the way people work.

In this tutorial, you work with the WebCenter Framework, which is integrated into JDeveloper and allows you to embed portlets, content, and customizable components in your application.

Back to Topic List

Scenario

You first log in to Peoplesoft and verify that the self-service portlets are available and accessible. After enabling WRSP for a self-service page and copying the WSRP URL, you create a WebCenter application and a JSP page, register the portlet producer, and add the portlet to the JSP. Finally, you run the page to verify that the portlet has successfully been integrated in your WebCenter application.

 

Back to Topic List

 

Prerequisites

Before starting this tutorial, you should:

1.

Have access to or have installed Oracle JDeveloper Studio Edition (10.1.3.2.0 or later).

This release includes all the functionality you need to build WebCenter applications. You can download JDeveloper Studio Edition from the Oracle Technology Network at http://www.oracle.com/technology/products/jdev/index.html.

2.

Have access to or have installed Oracle's PeopleSoft Enterprise Applications.

In this OBE, we used Peoplesoft HCM 9.0 with Peopletools 8.48.

 

Back to Topic List

Creating a WSRP Portlet from a Self-Service Page

In this topic, you log in to PeopleSoft, locate the Self Service page that you want to add to your WebCenter application, and enable WSRP for the page. You copy the URL, which you need to register the portlet producer with your WebCenter application.

 Find the self-service page
 Get the WSRP URL

Back to Topic List

To navigate to the Personal Information Summary page, perform the following steps:

1.

In a browser, enter the URL for accessing your PeopleSoft Enterprise instance.

 

2.

Enter a valid user ID and password. Click Sign In.

 

3.

In the menu on the left, scroll down to PeopleTools, and click the PeopleTools link.

 

4.

In the PeopleTools menu, click Portal.

 

5.

In the Pagelet Wizard sub-menu, click Structure and Content.

 

6.

Click Self Service.

 

7.

Click the Edit link next to Personal Information Summary.

 

8.

In the Personal Information Summary page, select the WSRP Producible checkbox.

 

9.

Click Save.

Back to Topic

To copy the WSRP URL and test it, perform the following steps:

1.

In the menu on the left, click WSRP Production.

 

2.

Click the arrow to the left of Web Service Endpoint URL to expand it.


3.

Copy the URL to the clipboard. To do this, highlight the URL and press [Ctrl]+[C].

 

4.

Paste the URL in the address field of your browser and press [Return]. The Personal Information Summary portlet has been exposed as a Web service. The Web Services Description Language (WSDL) that you see in your browser describes this Web service.

 

Back to Topic

Back to Topic List

Adding a Portlet to a JSF Page

In this topic, you use JDeveloper Studio to create a WebCenter application and a JSF page to display the PeopleSoft portlet. After registering the portlet producer, you add the portlet to the page.

 Create a new application and JSP
 Register the portlet producer
 Add the portlet to the page

Back to Topic List

To create a new WebCenter application and a JSP, perform the following steps:

1. Start JDeveloper: Double-click the JDeveloper executable ( jdeveloper.exe) found in the root directory ( <jdev_home>) where you unzipped it.

If the Migrate User Settings dialog box opens, click NO.

Close the Tip of the Day window.

 

2.

In the Applications Navigator, right-click Applications and select New Application.


3.

In the Create Application dialog box, rename the application to Employees, choose WebCenter Application [Portlet, Content Repository, JSF] from the Application Template pull-down, and click OK.

The WebCenter template creates the projects that you need, and helps target JDeveloper so that only those options applicable to a WebCenter application are presented to you.

 

4.

In the Applications Navigator, right-click the ViewController node and select New.

 

5.

In the New Gallery window, expand the Web Tier node in the Categories tree, select JSF, and choose JSF JSP as the item. Click OK.

The Create JSF JSP Wizard opens.

 

6.

Click Next to leave the Welcome page.

 

7.

Rename the file name from untitled to PersonalInfo. Select the JSP Document (*.jspx) option and click Next.

A JSP document is the XML version of a JSP page.

 

8.

On the Component Binding page of the wizard, ensure that the Do Not Automatically Expose UI Components in a Managed Bean option is selected and click Next.

 

9.

On the Tag Libraries page of the wizard, click the double arrows to move all available libraries to the Selected Libraries pane. Click Finish.

By default, only JSF libraries are selected; however, to build WebCenter applications, you also need to add ADF and WebCenter libraries to your project.

 

10.

Click Finish.

 

11.

Notice that PersonalInfo.jspx, which is currently blank, is automatically opened in the Visual Editor.

Back to Topic

To register the portlet producer, perform the following steps:
1.

In the Application Navigator, right-click the ViewController project, and select New.

Note: Registration is part of consuming a portlet, so you should right-click the ViewController project, not the Portlets project. The Portlets project is for producing portlets—that is, creating, enhancing, and deploying them—whereas the ViewController project is used to create the JavaServer Faces pages for the UI of your application and to consume portlets.

 

2.

In the New Gallery, expand Web Tier in the Categories tree, and select Portlets .

In the Items list, select WSRP Producer Registration.

Click OK to launch the Register WSRP Producer Wizard.


3.

Click Next to leave the Welcome page of the wizard.

 

4.

Rename the producer PeopleSoftProducer and click Next.

 

5.

On the Connection page, paste the WSDL URL in the URL Endpoint field. This is the URL that you used in your browser to test the portlet.

If a proxy is required for you to access the Internet, then you also need to provide proxy details. You can copy the proxy details (host and port) from the connection settings in your browser. Of course, your proxy will be different from the example in the screenshot.

 

6.

Click Next. The wizard connects to the WSRP portlet producer, using the URL you just entered.

Note: The portlet container that holds the portlet producer must be running for this step to succeed.

 

7.

In the Registration Details page, click Finish to accept the default timeout value of 30 seconds.

The two remaining wizard pages apply to security and key store location. In this simple example, you have not configured key stores on the PeopleSoft instance or in the OC4J that is running the WebCenter application, so simply click Finish.

 

 

8.

Click OK to acknowledge the successful registration of your portlet producer.

 

Back to Topic

Now that the application knows about the portlet, we can add the portlet to the PersonalInfo page.

To add the portlet to the PersonalInfo page, perform the following steps:
1.

On the Components tab (top right), find and select PeopleSoftProducer in the list of component palettes.

 

2.

Click and drag the Personal Information Summary portlet, and drop it on the PersonalInfo.jspx page in the Visual Editor.


3.

To run the page, right-click and select Run from the shortcut menu.

 

4.

Notice the messages being written to the Embedded OC4J Server - Log.

Tip: To maximize any JDeveloper tab, double-click its header. Double-click again to restore the tab to its previous size.

When the page is running, you are prompted to log in to PeopleSoft. This is because you haven't configured any security for the application.

 

5.

Enter your PeopleSoft user ID and password. Then click Sign In.

The Personal Information Summary page is displayed on the JSP as a portlet..

Back to Topic

Back to Topic List

 

Summary

In this lesson, you learned how to:

 Create a WSRP portlet from a self-service page
 Create a WebCenter application and a JSP page
 Register a portlet producer
 Add a portlet to a page
 Run the page

Back to Topic List

Related Information

To learn more about Oracle WebCenter, you can refer to:

 WebCenter demonstrations ( viewlets )
 WebCenter Quick Start page on the OTN Web site
 Oracle WebCenter Framework: Building a WebCenter Application Step by Step ( tutorial )

Back to Topic List

 Place the cursor over this icon to hide all screenshots.

 

 

 

Left Curve
Popular Downloads
Right Curve
Untitled Document