SOAPWS Function

Calls a Web service by using WS-Security authentication; credentials are provided in the arguments.

Category:

Web Service

Syntax

SOAPWS (IN, URL<,options>)

Required Arguments

IN

specifies a character value that is the fileref. IN is used to input XML data that contains the SOAP request.

URL

specifies a character value that is the URL of the Web service endpoint.

Optional Arguments

OUT

specifies a character value that is the fileref where the SOAP response output XML will be written.

SOAPACTION

specifies a character value that is a SOAPAction element to invoke on the Web service.

WSSUSERNAME

specifies a character value that is a WS-Security user name.

WSSPASSWORD

specifies a character value that is a WS-Security password, which is the password for WSSUSERNAME. Encodings that are produced by PROC PWENCODE are supported.

MUSTUNDERSTAND

specifies a numeric value that is the setting for the mustUnderstand attribute in the SOAP header.

PROXYPORT

specifies a numeric value that is an HTTP proxy server port.

PROXYHOST

specifies a character value that is an HTTP proxy server host.

PROXYUSERNAME

specifies a character value that is an HTTP proxy server user name.

PROXYPASSWORD

specifies a character value that is an HTTP proxy server password. Encodings that are produced by PROC PWENCODE are supported.

CONFIGFILE

specifies a character value that is a Spring configuration file that is used primarily to set time-out values.

DEBUG

specifies a character value that is the full path to a file that is used for debugging logging output.

Example

The following example shows how to use the SOAPWS function in a DATA step:

FILENAME request 'C:\temp\Request.xml';
FILENAME response 'C:\temp\Response.xml';

data _null_;
   url="http://somemachine.na.abc.com/SASBIWS/ProcSoapServices.asmx";
   soapaction="http://tempuri.org/ProcSoapServices/copyintoout_xml_att";
   WSSUSERNAME="sasuser";
   WSSPASSWORD="password";

   rc = soapws("request", url, "response", soapaction, wssusername, 
                wsspassword);
run;