Consuming a Siebel Web Service in a WebCenter Application

Purpose

This tutorial shows you how to consume a Siebel Web service in an Oracle WebCenter application.

Time to Complete

Approximately 20 minutes

Topics

This tutorial covers the following topics:

 Overview
 Scenario
 Prerequisites
 Creating a WebCenter Application
 Creating a Data Control Based on a Siebel Web Service
 Creating the User Interface
 Testing 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

This tutorial shows how easily you can integrate a Siebel Web service in a WebCenter application. In the tutorial, you first create a new WebCenter application. Then you define a data control based on the Siebel Web service, selecting one of the available operations to expose in your application. You create two JSF pages: the first implements the QueryById operation from the data control. The second JSF page returns details based on the ID that the user provides in the query page.

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.

Scenario

The application that you will build uses a WSDL file that you created in another OBE using Siebel. Files with the WSDL extension contain Web service interfaces expressed in the Web Service Description Language (WSDL). WSDL is a standard XML document type specified by the World Wide Web Consortium. WSDL files are used to communicate interface information between Web service producers and consumers. The WSDL file provides all the information a client application needs to use the Web service. A WSDL description allows a client to utilize a Web service’s capabilities without knowledge of the implementation details of the Web service.

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 Siebel. In this example we are using Siebel Call Center v 8.0.

 

3.

Have the SiebelAccountInsertWS_80.wsdl file in a local directory. To meet this mandatory prerequisite, you must have completed this OBE: Create an Inbound Web Service for Siebel Account Business Service.

 

4. 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.

Back to Topic List

Creating a WebCenter Application

To create a WebCenter application, perform the following steps:

1.

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




2.

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

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.

 

3.

Click OK. Notice the three projects that have been created for you.

 

Back to Topic

Back to Topic List

Creating a Data Control Based on a Siebel Web Service

In this section of the tutorial, you create a data control based on a Web service. This Web service was created from a Siebel application, but you can follow the same steps using a Web service created by another application such as BPEL, JD Edwards, PeopleSoft, and so on.

To c reate a WSDL-based data control, perform the following steps:

1.

In the Applications Navigator, right-click the Model node and select New from the context menu.

 

2.

In the New Gallery, select All Technologies from the Filter By drop-down list.

Select Business Tier | Web Services as the category, select the Web Service Data Control item, and click OK.

 

3.

In the Create Web Service Data Control wizard, click Next to leave the Welcome page.

 

4.

In Step 1, type SiebelAccount_WS in the Name field and then click the Browse button for the URL field.

In the Select WebService Description, locate the directory where you downloaded the wsdl file and select the SiebelCustomerAccount_80.wsdl file.

Click Open.

In the wizard, notice the URL generated in the Service field.

Click Next.

 

5.

Step 2 shows all the operations available from this Web service. For this OBE, you will use a single operation. Select AccountQueryById. Using the Add button, shuttle the selection to the Selected pane.

Click Next.

 

6.

In the Applications Navigator, expand the Model node and its subnodes to view the entries that have been created. The Applications Navigator should look like this:

 

7.

Click the save all  icon to save your work.

 

 

Back to Topic

Back to Topic List

Creating the User Interface

In this topic, you use JDeveloper's JSF Navigation Modeler to diagrammatically create your application's pages and the navigation between them.

To create a page flow diagram, perform the following steps:

1.

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

 

2.

In the New Gallery, expand the Web Tier node and select JSF. In the Items pane, select JSF Page Flow & Configuration (faces-config.xml).

Click OK.

 

3.

In the Create JSF Configuration File, click OK to accept default values.

An empty page flow diagram opens. Notice the Component Palette and the Data Control Palette to the right of the diagram editor. You use this to create components for the JSF Navigation Model.

 

4.

Click the save all  icon to save your work.

To add pages and navigation to the page flow diagram, perform the following steps:

1.

In the JSF Navigation Diagram component palette, select JSF Page, and click the diagram.

Rename the page to QueryByID.

 

2.

From the Component Palette, click and drag another JSF Page and drop it next to the previous one.

Rename the page ShowResult.


3.

Select JSF Navigation Case in the JSF Navigation Diagram component palette. Click the icon for the source JSF page ( QueryByID), and then click the icon for the destination JSF page ( ShowResult) for the navigation case.

 

4.

Modify the default label ( success) by clicking it and entering toResult .

 

5.

Click the Overview tab at the bottom of the screen. Click Navigation Rules in the left-hand table. Notice that the rule you just created in the diagram is listed in the table.

Click the Source tab at the bottom of the screen. The <from-view-id> tag identifies the source page, and the <to-view-id> tag identifies the destination page.

JDeveloper gives you three views of the faces-config.xml file. As you've seen, the same information that is presented in the diagram is also accessible through a declarative dialog and directly from the source.


6.

Switch back to the diagram view, and select JSF Navigation Case in the Component Palette. Click the icon for the source JSF page ( ShowResult), and then click the icon for the destination JSF page ( QueryByID) for the navigation case.

 

7.

Modify the default label ( success) by clicking it and entering toQuery .

 

8.

Click the save all  icon to save the diagram.

 

Back to Topic

Back to Topic List

 

To create the QueryById page, perform the following steps:

1.

On the Page Flow diagram, double-click the QueryById icon to launch the Create JSF JSP Wizard.

 

2.

Click Next to leave the Welcome page.

 

3.

In Step 1 of the wizard, select the JSP Document (*.jspx) option.

Click Next.

 

4.

In Step 2, make sure Do Not Automatically Expose UI Components in a Managed Bean is selected.

Click Next.

 

5.

In Step 3, make sure the following libraries are selected:

ADF Faces Components 10_1_3_2_0
ADF Faces HTML 10_1_3_2_0
JSF Core 1.0
Cusomizable Components Core 10_1_3_2_0

Click Finish to create the page. An empty JSF page opens up in the Design tab of the editor.

 

6.

In the Customizable Components Core component palette, click ShowDetailFrame. The ShowDetailFrame appears in the page.

Note: Oracle WebCenter provides two customizable components: PanelCustomizable and ShowDetailFrame. These two components make it very easy to organize the content of your Web application, treating different panels as if they are almost stand-alone, portlet-like objects that can be minimized, rearranged, have their own drop-down menus, and so on.

7.

With the ShowDetailFrame selected, modify the Text property in the Properties Inspector to Query By ID. Press [Enter] to update the page in the Visual Editor.

 

8.

Open the Data Control palette and expand the SiebelAccount_WS node. Drag and drop the AccountQueryById(String) node onto the showDetailFrame on the page.In the popup menu, select Create | Parameters | ADF Parameter Form.

 

9.

In the Edit Form Fields, click OK.

 

10.

Select the AccountQueryById button generated in the page and in the Property Inspector pane, change the following properties:

Text Submit
Action toResult

 

11.

Select the input field corresponding to the input value, and in the Property Inspector, change the Label property to Account ID:

The page should now look like this:

 \

 

12.

Click the save all  icon to save your work.


Back to Topic

Back to Topic List

To create the result page, perform the following steps:

 

1.

Return to the Page Flow diagram (click the faces-config.xml tab), and double-click the ShowResult icon to launch the page wizard.

 

2.

Click Next to skip the Welcome page, and in Step 1 of the wizard, select the JSP Document (*.jspx) option.

Click Next.

 

3.

In Step 2 make sure Do Not Automatically Expose UI Components in a Managed Bean is selected.

Click Next.

 

4.

In Step 3, the following libraries should be selected:

ADF Faces Components 10_1_3_2_0
ADF Faces HTML 10_1_3_2_0
JSF Core 1.0

 

 

5.

Click Finish to create the page. A new empty page opens up on the Design tab of the editor.

 

6.

From the Customizable Components Core component palette, click ShowDetailFrame. The ShowDetailFrame component appears on the page.


7.

With the ShowDetailFrame selected, modify the Text property in the Properties Inspector to Query Results. Press [Enter] to update the page in the Visual Editor.

 

8.

In the Data Control palette, expand AccountQueryById | Return | SiebelMessage | ListofAccountInterface and select the Account node. Drop it on the page on the ShowDetailFrame.

From the popup menu, select Create | Forms | ADF Read-only Form.

 

9.

In the Edit Form Fields, using the Delete button, restrict the proposed fields to the following list:

AccountID
AccountStatus
NumberOfEmployees
CurrencyCode
Location
MainPhoneNumber
Name
Type

Check the Include Submit Button checkbox.

Click OK.

 

10.

In the Action Binding Editor, click OK.

 

11.

Select the Submit button and in the Property Inspector, change the title to Back to Query, and in the Action field select toQuery from the list.

 

12.

Click the save all  icon to save your work.

 

Testing the Application

Now that you have built your application, you need to test it. JDeveloper makes it easy to test JSF pages through a built-in application server. The server is automatically launched when you run a page from within JDeveloper.

 Querying for Siebel Account Values
 Testing the JSF Pages

Back to Topic List

Before you can query a Siebel Account using an ID, you need to determine the IDs that are available in your Siebel instance. To perform the next section, you need to have access to Siebel Call Center (refer to the prerequisite section if necessary).

To query for Siebel account values, perform the following steps:

1.

Log into Siebel Call Center, providing the relevant User ID / Password combination.

 

2.

Navigate to the Accounts List using Site Map

 

3.

Click the Accounts link.

 

4.

Click the Accounts List link.

 

5.

From the returned list, highlight the account you want to query.

 

6.

From top menus go to Help | About Record.

 

7.

Find the ID value in the Row # field.

Make a note of the value returned.

 

Back to Topic

Back to Topic List

Testing the JSF Page

1.

To test the pages, return to the page flow diagram. Right click the QueryById page icon and select Run from the context menu.


2.

Your page is loaded in your default browser and should look like the following:


3.

In the ID field, enter the value you previously noted in the ROW # field.

Click Submit.

 

4.

The Details page displays the detail information for the corresponding account.

To test another value, you can click Back to Query and enter a new query..

 

5 .

You have successfully completed this OBE. You can close the browser window.

 

Back to Topic

Back to Topic List

Summary

In this tutorial, you created an end-to-end application by using a WSDL file as data control and creating JSF pages that use operations provided by the Web service. You learned how to:

 Create a WebCenter Application
 Build the Data Model Based on a WSDL File
 Create the Page Flow
 Create Query and Result Pages
 Test the JSF Pages

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