Common Properties

Top  Previous  Next

Authentication Type (Accepts MScript)

This property defines the authentication method for the SOAP call. The available methods are:

1.Basic Authentication
This authentication type requires only User Name and Password.
2.WSS4J Authentication. Stands for Web Service Security for Java and if this method is selected the SOAP envelope must contain a message header as follows:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <wsse:UsernameToken>
        <wsse:Username>${username}</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">${password}</wsse:Password>
        <wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">${nonce}</wsse:Nonce>
        <wsu:Created xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">${created}</wsu:Created>
      </wsse:UsernameToken>
      <wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <wsu:Created xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">${created}</wsu:Created>
        <wsu:Expires xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">${expires}</wsu:Expires>
      </wsu:Timestamp>
    </wsse:Security>
  </soap:Header>
  <soap:Body/>
</soap:Envelope>

End Point URL (Accepts MScript)

This property defines the End Point URL which the SOAP Call will be directed to.

SOAP Action URI (Accepts MScript)

This property defines the SOAP Action URI that will handle the request.

SOAP Envelope (Accepts MScript)

The SOAP Envelope in XML format should be defined in this property. Since the property accepts MScript functions,SOAP Envelope, can be formed dynamically according to the values of the input parameters or pool variables.

Replace (Accepts MScript)

In some cases it is desirable to manipulate the XML response received from the web service. In this property one or more replace definition can be made. The definitions should be separated with "|::|" characters from each other.

Syntax of a replace definition:

text-to-change[|:|new-text ]

The text-to-change and new-text should be delimited with "|:|" characters. If new-text is omitted then the occurrences of text-to-change are removed from the output.

Note that extra space characters should be avoided between the delimiter and the texts.

Examples:

 xmlns="http://kps.nvi.gov.tr/WS"   

 The new-text definition id omitted. All occurrences of xmlns="http://kps.nvi.gov.tr/WS" will be removed from the SOAP Message response.   

 

 xmlns="http://kps.nvi.gov.tr/WS"|::|city-code|:|cityCode 

There are two replace definitions made in the example. The 1st definition is the same as the first example above and the 2nd definition will replace all the occurrences "city-code" with "cityCode" in the response XML.

 

Timeout (Accepts MScript)

If some circumstances web services do not respond the requests and therefore the execution may hang. To avoid this a timeout duration (in milliseconds) can be given to this property.

User Name (Accepts MScript)

The name of the user authentication is required.

Password (Accepts MScript)

The password of the user if authentication is required.