Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

25
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 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) Introduction 2) Overview 3) Scenario 4) Prerequisites 5) Development Steps 6) Conclusion 7) 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.

Transcript of Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

Page 1: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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) Introduction 2) Overview 3) Scenario 4) Prerequisites 5) Development Steps 6) Conclusion 7) 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.

Page 2: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 3: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 4: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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

Page 5: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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=SADMIN&Password=<……>

Page 6: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Page 7: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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

Page 8: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Name the project to DataControl.

Right click on DataControl to create a new WebService Data Control

Select Web Service Data Control under Web Services

Page 9: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 10: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 11: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Select an Empty Project in Projects.

Name the project as WebInterface.

Click the save all icon to save your work.

Page 12: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Creating the Insert Page:

Select JSF from New Gallery and select JSF Page Flow & Configuration.

Name the Configuration file faces-config.xml

Page 13: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 14: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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 JSF Navigation case from Component palette from QueryByID.jsp to ViewResult.jsp as shown above.

Add Navigation Rules to Viewresult.jsp as shown above.

Page 15: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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

Page 16: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

In step 2 select option as shown above.

Select the following libraries as show above to right pane.

Page 17: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Drag The PanelPage on to QueryByID.jspx page as shown above.

Page 18: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Right click on start---parameters and select ADF Parameter Form.

Page 19: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

Page 20: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g Copyright 1994 - 2008 Miracle Software Systems, Inc. All rights reserved.

Page 20 of 25

Double Click on ViewResult.jsp to edit it details

Click Next and make sure is selected and click Next again.

Page 21: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

From Data Control Palette expand SiebelWS to list Account under SiebelMessage And drag it on to the start in ID Details.

Page 22: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 23: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.

Page 24: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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-Tutorial6-ReceivingSiebelIntegrationObject.pdf Oracle Fusion Middleware and Siebel - Experts http://www.oracle.com/applications/crm/siebel/resources/oracle-crm-on-demand-integration-to-siebel-crm-datasheet.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.

Page 25: Integrating Siebel 7.8 CRM Services with Oracle SOA Suite 10g

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

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.