Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Abstract The objective is to integrate Siebel 7.8 with Oracle SOA Suite 10g through Web Services using Oracle Adapter for Siebel. Table of Contents 1) 2) 3) 4) 5) 6) 7)
Introduction Overview Scenario Prerequisites Development Steps Conclusion References
1. Introduction Oracle Fusion Middleware provides a wide set of capabilities to enable, manage, and integrate services and events across Siebel CRM and all other services and applications that may exist in your company. OracleAS Integration provides a unique design time experience for easy-to-use and rapid configuration of Adapters. The tool has built-in support for introspecting the EIS application metadata and to automatically generate the metadata for Adapter Services. Users can browse or search for specific EIS interfaces, business objects and operations. The Adapter for Siebel provides comprehensive, bi-directional, standards-based, real-time connectivity to Siebel 8 application systems. The Adapter supports both JCA and Web Service standards for creation of open and reusable service-oriented applications (SOA). The Adapter provides an easy-to-use, robust, scalable connectivity platform to non-intrusively access and expose the critical business logic and data contained with Siebel for building an integrated enterprise. The Oracle AS Adapter provides bi-directional connectivity to Siebel. It uses the Siebel COM and Java Data Bean API to synchronously invoke Siebel transactions - Siebel Business Objects and Business Services. It uses Siebel’s robust EAI framework to asynchronously receive events from Siebel in the form of Siebel Integration Objects. It supports more than one way of receiving events from the Siebel application namely Files, HTTP and MQSeries and ensures guaranteed delivery of Siebel events. It translates Siebel native data to standard XML format and back. The following diagram explains the communication between Siebel and OracleAS Adapter.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 1 of 25
2. Overview In this article we first create a Web service from a Siebel Call Center 7.8 and we take a Siebel Business Service to generate a WSDL file, which can be used in Oracle BPEL process to connect to Siebel Account through Oracle Siebel Adapter service. If you use Web services as your business service technology, model information will be exposed to the view and controller layers through ADF data control interfaces implemented by thin, Oracle-provided adapter classes. We use the direct web services for integration and finally demonstrate on how to use BPEL Process Manager to consume a Siebel generated WSDL to invoke an inbound Siebel Account Web Service through Oracle ADF to generate an account in Siebel.
3. Scenario The process starts with consuming a prepared Siebel Business Service through the Administration-Web services functionality from Siebel Thin Client, and expose it as an inbound Web service. After adding operations to the inbound Web service, we generate a WSDL file. Next we perform Web Service Data Control form JDeveloper to interact with the Web service that is generated and provide the operations for data control to build the required JSF pages using Oracle ADF. The operation within WSDL files are used to create the data control and exposes the Siebel Account details. From the JDeveloper IDE we create two JSF pages to handle QueryByID operation from the available data control, and the other JSF page to return details based on the ID given in the query page to return the required details from the Siebel Customer Account. The Web service (i.e. WSDL) form Siebel is deployed into Oracle SOA Suite and invoked from BPEL console to create a data control based on the running Web service and create a JSF page using the data control. This Web service allows us to create a new customer and returns the Customer ID provided for this new customer. Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 2 of 25
4. Prerequisites This guide assumes that: • You have installed Oracle SOA Suite 10g (10.1.3.1). • You have installed Oracle JDeveloper 10g. (10.1.3.4). • You have access to Siebel Call Center 7.8. • You have installed and configured Oracle Siebel Adapter through Application Explorer from OracleAS 10g Adapters.
5. Development Steps Go to Oracle Siebel Call Center 7.8 login page and login with the defined credentials.
On the Home page click on Site Map
icon.
In the Accounts Home page click on Accounts link. Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 3 of 25
On Administration -Web Services page click on Inbound Web Services and navigate to the Siebel Customer Account under Name tab.
Double click on Siebel Customer Account to view the Service Ports
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 4 of 25
Note down the Address for CustAccount and the type of Transport protocol used (HTTP) under Service Ports For Example: http:/localhost:8081/eai_enu/start.swe?SWEExtSource=WebService&SWEExtCmd=Execute&UserName=SAD MIN&Password=<……>
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 5 of 25
Create the above shown Operations for Insert, QuerById, QueryByExample and set the Authentication type to None. Go to Menu and click on Save Record under Operations, Service Ports and Inbound Web Services tab for the changes to take effect.
Click on Generate WSDL button to save the WSDL file on to your system.
The generated xml file is displayed in your browser.
Save the file as SiebelWS.wsdl on your local system. This file is used later in the BPEL process.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 6 of 25
Create A Web Service Data Control: Now we use Oracle JDeveloper 10.1.3.4 and ADF (Application Development Framework) components to develop a Web application with Siebel Call Center 7.8. We use the created Web service (SiebelWS.wsdl) from a Siebel Call Center application as a data control for the JSF pages. Here the data from Siebel application is used to build a JSP user interfaces using Oracle ADF. Start JDeveloper and create a new application as shown below
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 7 of 25
Name the project to DataControl.
Right click on DataControl to create a new WebService Data Control
Select Web Service Data Control under Web Services
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 8 of 25
In the Create Web Service Data Control wizard, click Next to skip the Welcome page. In Step 1, type SiebelWS as the name for this data control.
Next step shows the operations available: select CustAccount and use the Add button to shuttle the selection in the Selected pane for QueryById.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 9 of 25
click Finish to create the data control. In the Applications Navigator, expand the nodes that now exist and review the new entries that have been created. The Applications Navigator should look like this:
Click the save all icon to save the workspace. Creating an user interface: Now we create a second project for the JSF views. In the Applications Navigator, right-click the Siebel_OracleAS_Integration node and select New Project from the context menu.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 10 of 25
Select an Empty Project in Projects.
Name the project as WebInterface.
Click the save all
icon to save your work.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 11 of 25
Creating the Insert Page:
Select JSF from New Gallery and select JSF Page Flow & Configuration.
Name the Configuration file faces-config.xml
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 12 of 25
Drag a JSF Page from Component Palette into faces-config.xml pane and name it QueryByID.jsp
Drag another JSF page and name it Viewresult.jsp as shown below.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 13 of 25
Add the JSF Navigation case from Component palette from QueryByID.jsp to ViewResult.jsp as shown above.
Add Navigation Rules to Viewresult.jsp as shown above.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 14 of 25
Add the Folowing navigation Case as shown above and rename it to toViewResult.
Double click the QueryByID.jsp and select JSP Document.
Click Next for Component Binding
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 15 of 25
In step 2 select option as shown above.
Select the following libraries as show above to right pane.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 16 of 25
Drag The PanelPage on to QueryByID.jspx page as shown above.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 17 of 25
Right click on start---parameters and select ADF Parameter Form.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 18 of 25
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 19 of 25
Double Click on ViewResult.jsp to edit it details
Click Next and make sure
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
is selected and click Next again.
Page 20 of 25
From Data Control Palette expand SiebelWS to list Account under SiebelMessage And drag it on to the start in ID Details.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 21 of 25
Right click start and select ADF read-only Form to display Edit Form Fields.
Select the following Value Binding as shown above & delete the other bindings.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 22 of 25
Run the application by right clicking the QueryByID.jsp You will see the following web page.
Enter the Account ID’s generated in the Siebel Business Object to retrieve information.
The Details of the Account Customer10 are shown below which are retrieved from Siebel system.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 23 of 25
6. Conclusion: This article shows a step-by-step approach to integrating Siebel 7.8 with Oracle SOA Suite 10g and also demonstrates on how to expose Siebel related functions/services as data control to use them as simple and easily consumable functions/objects through Oracle ADF.
7. References: Support Integration | Oracle and Siebel http://www.oracle.com/siebel/support/index.html Adapter Tutorial http://www.oracle.com/.../products/integration/adapters/pdf/adapter-Tutorial6ReceivingSiebelIntegrationObject.pdf Oracle Fusion Middleware and Siebel - Experts http://www.oracle.com/applications/crm/siebel/resources/oracle-crm-on-demand-integration-to-siebel-crmdatasheet.pdf Oracle Application Server fro Siebel Data Sheet http://www.oracle.com/technology/products/integration/adapters/pdf/DS_OracleASAdapter_SEBL.pdf
About the authors: Ramesh Nambala Email:
[email protected] / 1-248-233-1816
Ramesh Nambala is an Integration Specialist & Fusion Developer at Miracle Software Systems, Inc. His primary focus has been on the SOA Integration space using Oracle Fusion Middleware Technologies. He has several years of experience helping various customers across Telecom, Manufacturing, and Retail banking domains using Oracle Business Integration Tools.
Sharma Raj Marella Email:
[email protected] / 1-248-233-1816
Sharma Raj Marella is a specialist in and passionate exponent of standards based Service Oriented Architecture and in particular Oracle BPEL, ESB. He has several years of experience in troubleshooting and managing critical j2ee/soa projects within Miracle Software Systems Inc. supporting POCs & takes care the overall cross-product integration. Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 24 of 25
Copyright 2008 © Miracle Software System, Inc. Miracle acknowledges the proprietary rights of the trademarks and product name of the other companies mentioned in this paper. The information provided in this document is intended for the sole use of the recipient and for educational purposes only. Miracles make no express of implied warranties relating to the information contained in this document or to any derived results obtained by the recipient from the use of the information in the document. Miracle further does not guarantee the sequence, timeliness, accuracy or completeness of the Information and will not be liable in any way to the recipient for any delays, inaccuracies, errors in, or omissions of, any of the information of in the transmission thereof, of for any damages arising there from. Opinions and forecasts constitute our judgment at the time of release and are subject to change without notice. This document does not contain information provided to us in confidence by our clients.
Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.
Page 25 of 25