About Soap Service

SOAP is an XML based protocol used to exchange information in a disturbed and decentralized environment. Services implemented using SOAP is often called as web services.

SOAP service is an instance of Rule-Service-SOAP class.

SOAP services generally process service requests synchronously. That is, they immediately perform their requested processing and return a configured response while the calling application waits. However, you can configure SOAP services to process service requests asynchronously, which means the service queues the request for asynchronous execution and the calling application calls back later for the results

In SOAP Service,

under Service Tab-

Activity Name- Specify the name of the activity that provides the processing for this service rule Called as Service Activity.

Execution Mode Option –

Execute synchronously- select this when you want the service to run the request immediately. Execute Asynchronously- select this when you want the service to queue the request and the calling application calls back later for the results.

Under Response Tab:

Data mapping of the Incoming SOAP request from an external client app to PRPC.

Request Header-

Name- of the external request header

Description:

Map To: The data type of a request header is String.

Map To Key:

Request Parameter:

Map To: Specify the destination in PRPC

Clipboard

RequestorID

Username

Password

XML ParseRule

Delimited ParseRule

Structured ParseRule

HTML PostData

Faults Tab:

Faults is a fatal processing error in the service, use the faults tab to specify data returned to the client application when the service encountered a fatal processing error and must return a SOAP fault message.

Mapping Error- If an error occurs while mapping incoming data from the request message to clipboard; the system returns an exception with the specified data.

Security Error- authenticating client credentials

Service error- if a valid instance of a service activity is not found

When

Queue

Response Tab: Data mapping for the Reply message will be configured in Response tab.

Response Header:

Map From: Specify the source of the value in PRPC

• Clipboard- The source is a property or a page on the clipboard.
• Constant- The source is a fixed value.
• XML Stream- The source is a stream of XML data formatted by an XML rule.
• HTML Stream- The source is a stream of HTML data formatted by an HTML rule.
• HTML Frame- The source is a stream of HTML data generated by the service activity.

Map From Key: Specify the key for locating the property or rule in the source specified in the MAP From Field

· Clipboard- Enter the reference to a property

· Constant-enter a literal string

· XML Stream-

· HTML Frame

• HTML Stream

WSDL: web Service Description language is an XML format in which messages containing either document oriented or procedure oriented informations.

A WSDL file describes a SOAP Service. It include XML Schema information that describes the input parameter values that need to be sent in a SOAP request message, and the output parameter values that can be extracted from a SOAP response message.