SOAPWEBMETA Function

Calls a Web service by using basic Web authentication; credentials for the authentication domain are retrieved from metadata.

Category:

Web Service

Syntax

SOAPWEBMETA (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.

WEBAUTHDOMAIN

specifies a character value that is the authentication domain from which to retrieve a user name and password from metadata for basic Web authentication.

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 SOAPWEBMETA function with the DATA step:

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

OPTIONS metauser="metadata-user"
        metapass="password"
        metaprotocol=bridge
        metaport=8561
        metaserver="somemachine.abc.xyz.com";

data _null_;
   url="http://somemachine/basicauth/AddService.asmx";
   soapaction="http://tempuri.org/Add";
   webauthdomain="DefaultAuth";

   rc = soapwebmeta("request", url, "response", soapaction, webauthdomain);
run;