Integrating Oracle E-Business Suite in a WebCenter Application

Purpose

This tutorial provides a step-by-step guide to building a WebCenter application that consumes a set of the E-Business Suite Release 12 portlets.

Time to Complete

Approximately 60 minutes

Topics

This tutorial covers the following topics:

 Overview
 Prerequisites
 Adding a Portlet to a JSF Page
 Configuring Application Security
 Running the Application
 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

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. The WebCenter Framework is integrated into JDeveloper and allows you to embed portlets, content, and customizable components in your application. Oracle WebCenter Framework portlet integration supports all the production portlet standards including JSR 168 and WSRP 1.0, as well as an early version of WSRP 2.0.

Oracle E-Business Suite Release 12 provides built-in portlets through a WSRP 1.0-compliant framework producer. You can consume these portlets in a WebCenter application.

In this tutorial, you use Oracle JDeveloper as the IDE for building your 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.3).

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/software/products/jdev/htdocs/soft10133.html.

2.

Have access to or have installed Oracle's E-Business Suite Release 12.

The E-Business Suite Release 12 instance must be configured for WebCenter integration. That means that the Oracle Applications Manager should have:

 Updated the list of nodes that have access to Portlet Producer URLs to include the machines where OracleAS 10g WebCenter, Oracle JDeveloper, and the Infrastructure database are installed. Note: This is requirement is for running the application from JDeveloper and not for clients that access the deployed application.
 Implemented Single Sign-On support on the E-Business Suite R12 instance. Users must be common to both the WebCenter application and the E-Business Suite instance that it accesses.
 Granted user access to E-Business Suite portlets.
 Defined a role named ValidUsers in the identity management system.

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 E-Business Suite portlets. After registering the E-Business Suite portlet producer, you add one of its portlets to the page.

 Create a new application and JSP
 Register the portlet producer
 Add portlets 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 EBusinessApp, 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 EBSportlets. 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.

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 EBSportlets.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 EBSproducer and click Next.

 

5.

On the Connection page, enter the Release 12 WSDL URL in the URL Endpoint field, using the format below:
http://<Release_12_host>:<port>/OA_HTML/portlets/WSRPBaseService?WSDL

For example: http://myEBSServer.us.oracle.com:8001/OA_HTML/portlets/WSRPBaseService?WSDL


6.

Click Next. The wizard uses the URL you just entered to connect to the WSRP portlet producer .

Note: Your E-Business Suite instance 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 E-Business Suite 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 EBSportlets page.

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

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

 

2.

Notice the list of portlets that you can add to any page in your application.


3.

Choose the portlet or portlets to add to the page. In this example, we chose the Applications Navigator - Flat Mode portlet. Click and drag the portlet and drop it on the page.

 

4.

Before adding security, let's run the page. Right-click the page in the Visual Editor and select Run.

 

5.

Notice that the portlet session couldn't be created. This is because you haven't yet configured security for the application.

Close your browser and return to JDeveloper.

 

6.

Before configuring security (the next topic in this tutorial), you must stop the embedded OC4J. From the main menu, select Run > Terminate > Embedded OC4J.

 

Back to Topic

Back to Topic List

Configuring Application Security

In this topic, you configure authentication settings for the new application, map a security role to a user, and grant access to the page that contains the portlet.

 Configure authentication settings
 Complete the security role mapping
 Secure the page

Back to Topic List

To use the ADF Security Wizard to configure authentication settings, perform the following steps:

1.

In the navigator, select the ViewController project and select Tools >ADF Security Wizard from the main menu.

 

2.

Click Next to leave the Welcome page.


3.

Select Enforce Authorization and click Next.

 

4.

Select Lightweight XML Provider (for testing the application from JDeveloper) and click Next .

 

5.

Set JAAS Mode to doAsPrivileged. Keep the default values for the other settings. Click Next.

The adfAuthentication resource (the authentication servlet) is already defined by default. You cannot edit or delete this resource, but you can specify the set of roles that may access the resource. To allow any valid user access to the adfAuthentication resource, you need to add a role named ValidUsers.

Note: The ValidUsers role will be mapped by the deployment descriptor to a real role defined in the identify management system. If a role of the same name exists in the identity management system, OC4J will automatically map them. The name "ValidUsers" is a convention used by WebCenter; however, you could choose to use a different name.

 

6.

To create the ValidUsers role and grant access to it, follow these steps:

a.

Click Manage Roles.

 

b.

Click Add.

 

c.

Enter ValidUsers as the name. Click OK.

Then click Close.

 

d.

Click the arrow to move the ValidUsers role to the Selected Roles list .

 

 

7.

Click Next and then click Finish.


8.

Click the Save All icon in the JDeveloper toolbar.

 

Back to Topic

To complete the security role mapping, perform the following steps:

1.

Select Tools >Embedded OC4J Server Preferences from the main menu.

 

2 .

Expand the Global | Authentication (JAZN) | Realms | jazn.com tree.

 

3.

Select Users and click Add .

 

4.

Enter the user name and password of a user that is already defined in your E-Business Suite installation. Click OK.

 

5.

Click the Roles branch under jazn.com and click Add.

 

6.

Enter ValidUsers in the Name field and click OK.


7. Click the Member Users tab.


8.

With the ValidUsers role selected in the top pane, select the user that you just created and click the arrow to move it to the Selected pane.

 

9. Click OK.


10.

Click the Save All icon in the JDeveloper toolbar.

 

Back to Topic

To set up authorization for the page, perform the following steps:

1.

Right-click EBSportlets.jspx in the Applications Navigator and select Go to Page Definition from the context menu.

 

2 .

In the Structure pane, right-click EBSportletsPageDef and select Edit Authorizations from the context menu.

 

3.

In the Authorization Editor, select the Grant checkbox for ValidUsers. Notice that selecting Grant caused all the other permission check boxes to be automatically selected for this role.

 

4.

Click OK.

 

5.

Click the Save All icon in the JDeveloper toolbar.

 

Back to Topic

Back to Topic List

 

Running the Application

Now let's run the application and test that the user you just defined is able to access the E-Business Suite portlet producer.

1.

Right-click EBSportlets.jspx in the Applications Navigator and select Run from the context menu.


2.

When the login.htm page opens in your browser, enter the user name and password of the authorized user and click Submit.

After successful authentication, the EBSportlets.jspx page opens. This time, content is displayed in the portlet.


3.

Click any link in the portlet.


4.

When prompted, enter your Single Sign-On user name and password and click OK.


The relevant Application Navigator for Oracle E-Business Suite is now displayed in your browser.


Note: You may wonder why you were prompted to log in a second time. When two applications use SSO for authentication through the same SSO server (domain), then only a single login is necessary. However, JDeveloper's embedded OC4J does not support SSO. Instead, authentication in your WebCenter application is done by the container using form-based user credential input (that is, login.html) and a local user/credential store (system-jazn-data.xml). So, the first login has no connection to any SSO server. Therefore, when you access the E-Business Suite Web interface, which is protected by SSO, authentication through SSO is required.

Back to Topic

Back to Topic List

 

Summary

In this lesson, you learned how a WebCenter application can consume Oracle E-Business Suite portlets. You also saw how to configure roles and users in a WebCenter application and authorize user access to a 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