Bookshelf v7.5: Outbound Web Services

Integration Platform Technologies: Siebel eBusiness Application Integration Volume II > Web Services >

Outbound Web Services

An outbound Web Service definition acts as a proxy to a Web Service published by an external application. The outbound Web Service can be based on one of the following:

External Web Service definition (WSDL) file

Outbound Application Service Interface (ASI)

Outbound Web Services Based on an External WSDL File

The following procedure describes how to use the WSDL Import Wizard to read an external WSDL document.

To read an external WSDL document

Start Siebel Tools.

Create a new project and lock the project, or lock an existing project in which you want to create your integration object.

Choose File > New Object... to display the New Object Wizards.

Select the EAI tab, select the Web Service icon, and click OK.

The WSDL Import Wizard appears.

Select the Project where you want the objects to be held after they are created from the WSDL document.

Specify the WSDL document that contains the Web Service or Web Services definition that you want to import.

Specify the file where you want to store the run-time data extracted from the WSDL document.

Specify the log file where you want errors, warnings, and other information related to the import process to be logged.

Click Next to view and verify a summary of your import information.

Click Finish to complete the process of importing the business service into the Siebel repository.

This procedure generates three objects in Siebel repository.

An outbound proxy business service of CSSWSOutboundDisptacher class.

NOTE: For RPC services, the order of input arguments is important. You can set the order through the Preferred Sequence property of the business service method argument in Siebel Tools. By specifying this parameter, the outbound dispatcher makes sure that the sequence parameters for an operation are in the correct order. The Preferred Sequence property is only supported with outbound services.

One or more integration objects representing input and output parameters of the service methods.

An XML document containing the run-time parameters that should be imported into the Siebel client. For details, see To import run-time data about external Web Service.

Outbound Web Services Administration

The WSDL Import Wizard exports the data to a file that you must import to the run-time database (the Web Services address) using the Outbound Web Services screen.

To import run-time data about external Web Service

Restart the Siebel Server (or Mobile Web Client) with a recompiled version of the .srf file that includes the new objects created by the Web Services Import Wizard.

NOTE: You do not need to update your .srf file at design time. However, the service definition must exist in the .srf file during run time.

From the application-level menu, choose View > Site Map > Web Services Administration> Outbound Web Services view.

In the Outbound Web Services list applet, click Import to bring up the EAI Web Service Import dialog box.

Specify the export file created by the Web Services Import Wizard.

Click Import to import the Web Service definition into the database.

WSDL does not provide native bindings for EAI MQSeries and EAI MSMQ transports. If your business requires you to pick up messages using these transports, you can manually create an outbound Web Service definition and update a corresponding business service in Siebel Tools to point to that Web Service. The following procedure describes this process.

To manually create a new outbound Web Service

From the application-level menu, choose View > Site Map > Web Services Administration> Outbound Web Services view.

In the Outbound Web Services list applet, create a new record.

Enter the namespace of the Web Service in the Namespace column.

Enter the name of the Web Service in the Name column.

Select Active or Inactive in the Status field.

Enter a description of the Web Service in the Comment column.

NOTE: When importing an external Web Service, you do not need to specify the proxy business service, integration objects, or the run-time parameters.

In the Service Ports list applet, create a new outbound service ports record.

Enter the name of the Web Service port in the Name column.

Select a type of proxy for the Port Type column.

Select a transport name for the protocol or queuing system for the Transport.

Enter the address appropriate for the transport chosen.

For the Local Workflow or the Local Business Service transports, enter the name of a Business Process or Business Service that should be called.

For the Local Web Service transport, enter the name of the inbound port.

For the HTTP Transport, enter an HTTP address of the Web Service to be called—for example,http://mycompany.com/webserivice/orderservice.

For the EAI MQSeries AMI or EAI MSMQ Server transports, enter one of the following:

mq://send receive service point name@policy name

msmq://queue name@queue machine name

Select whether the port uses SOAP document, SOAP RPC, or property set Binding.

NOTE: Property Set Binding should be used when the input Property Set to the proxy service is forwarded without changes to the destination address. This is intended primarily for use in combination with Local Workflow or Local Business Service transport to avoid overhead of processing XML.

Enter a description of the Port in the Comment column.

In the Operations Bindings applet, create a new Operations record.

Enter the name of the Web Service in the Name column.

Enter the name of the Binding Property in the Binding Property column; for example, SOAPAction.

Enter the value of the Binding Property in the Binding Value column; for example, CreateOrder.

Generate the WSDL file. For details, see To generate a WSDL file.

Once you have created your outbound Web Service, you need to update a corresponding outbound proxy business service in Siebel Tools to point to that Web Service. This associates the outbound proxy business service and the outbound Web Service. The following procedure outlines the steps you need to take to accomplish this task.

To update an outbound Web Service proxy business service to point to an outbound Web Service

Open Siebel Tools.

Select the outbound Web Service proxy business service you want to use to call your outbound Web Service.

Add the following user properties for this business service and set their values based on the outbound service port of your Web Service.

siebel_port_name

siebel_web_service_name

siebel_web_service_namespace

Integration Objects as Input Arguments to an Outbound Web Service

The property set that is used as an input argument to the outbound Web Service should have the same name as the input argument's name of the outbound Web Service proxy.

You can do this using one of the following options:

Change the output from all your business services that provide the input to the outbound Web Service from SiebelMessage to the actual outbound Web Service argument name specified in Siebel Tools. You need to change the output from your business services in Siebel Tools, as well as the name of the property set child that contains integration object instance.

Change the property set name from SiebelMessage to the actual outbound Web Service argument name by using an eScript service before calling the outbound Web Service.

Integration Platform Technologies: Siebel eBusiness Application Integration Volume II
Published: 18 July 2003