You are here

Home

How To Use Local Web Service

Local Web Service is available in Siebel Enterprise Application version 7.5 and higher. Local Web Service provides customers with the ability to invoke inbound Web Service locally. When calling Local Web Service by the outbound Web Service, the request will not pass through the web server but directly call to the inbound Web Service. By using this characteristic you can use Local Web Service to test web service on a dedicated client.

How To Use Local Web Service

Setting up an Inbound Web Service as a Local Web Service

 
  1. Create a business service or a workflow process to be exposed. In this Technical Note, the Siebel Contact ASI will be used as an example.
 
  1. Activate the Siebel Contact ASI in the Siebel Web Services Administration View.
 
    1. In Siebel version 7.5, locate the view under Web Services Administration.
 
    1. In Siebel version 7.7 and higher, locate the view under Administration - Web Services.
 
    1. Navigate to the Inbound Web Services view and find the entry for Siebel Contact in the Name field.
 
    1. Change the status for this record from Inactive to Active.
 
 
  1. Click the Generate WSDL button, you may get a download popup asking where you want to save the file. You may want to change the FileName to a meaningful value such as SiebelContact.WSDL and save the file.
 
  1. Change the Service Ports for the Transport field which was created in step 3 to “Local Web Service“ and set the Address to the same value of port name:
 
 
Transport
Address
Binding
Local Web Service
<Port Name>
SOAP_RPC_ENCODED or SOAP_RPC_LITERAL
 

Creating Proxy Business Service and setting up an Outbound Web Service as a Local Web Service

 
  1. Launch Siebel Tools to import the WSDL and create the required objects.
 
    1. In Siebel Tools, launch the Web Service wizard. Go to File > New Object > EAI (tab) > Web Service.
 
    1. Fill in the required fields for the WSDL Import Wizard and click the Next button.
 
Required Field
Description
Project
A project to store business services and integration objects created. You can create a new project or use an existing project.
WSDL Document
This is the WSDL document that is generated in the previous step.
Runtime Data
This is a file that will be generated by the WSDL wizard. It will contain the values you will import into the Outbound Web Services Administration view.
Log File
This is the log that will be generated by the WSDL wizard. It will contain a summary of objects created and any errors.
 
 
    1. Check the summary and click the Finish button. After the wizard completes, you will have a new business service and new integration object, which is seen in the summary window:
 
 
NOTE: If you are testing with Siebel version 7.5 environments as a web service consumer, you will need to modify the Integration Object’s properties.
 
You will need to change the Cardinality property of the following:
 
Component Name
Original Cardinality
New Cardinality
ListOfContactInterfaceTopElmt
<blank>
One
/Contact
One or more
One
 
    1. Compile changes into the client's .srf file. Remember to compile both the business service and integration object.
 
  1. To register the imported WSDL, login to the Siebel Client and go to the Web Services Administration View for Outbound Web Services. Click on the Import button and point to the Runtime Data file generated by the Import WSDL wizard in step 1-c.
 
 
NOTE: If you have changed the name of the Proxy Business Service, you should change the value of the “ImplementationName” element to the new name of the proxy business service in the Runtime Data file generated by the Import WSDL wizard before importing.
 
 
In the above sample, the name of the Proxy Business Service is changed to “Default_SiebelContact_LWS”.
 
After the import completes, query for the newly registered Web Service, which will be called Siebel Contact.
 
 
If you get any errors while trying to import the XML file, make sure your Siebel client is using the .srf file with the compiled proxy business service and integration objects from the previous step.
 
  1. Change the Service Ports setting such as the following:
 
 

Testing Local Web Service

 
Outbound Web Service
 
  1. In the Siebel client, navigate to the Business Service test view.
 
    1. In Siebel version 7.5, locate the view under Business Service Administration.
 
    1. In Siebel version 7.7 and higher, locate the view under Administration – Business Service.
 
  1. In the Business Service Simulator, specify a Service Name and Method which you will test as follows:
 
Field
Value
Service Name
Default_SiebelContact_LWS (The name of the proxy business service)
Method Name
SiebelContactQueryById
 
  1. Click on the glyph next to the Property Name and enter in the input argument (you can check input arguments for methods in Siebel Tools) as follows:
 
Field
Value
Property Name
Siebel Contact SiebelContactQueryById  Input:PrimaryRowId
Property Value
<Row Id of Contact>
 
 
  1. Click the Run button to invoke the web service. If it is successful, you will see data returned to the Output Arguments.