Caché Web Service Proxy Class Requirements
A class used by Caché as a proxy to an external Web Service must satisfy the following requirements:
-
The class must extend %SOAP.WebClientOpens in a new tab
-
The methods projected into the class by the Web Service producer must be instance methods and must be tagged with the WebMethod attribute.
Classes that extend %SOAP.WebClientOpens in a new tab automatically contain values for the following parameters. These parameters specify important characteristics of the Web Service:
Parameter | Description and Values |
---|---|
LOCATION | The value of this parameter is the URL that a client uses to access the Web Service. The URL is included in the WSDL document for the Web Service. |
NAMESPACE | The value of this parameter is a URI. It provides a namespace for the service, so that its name does not conflict with that of another service. By default, Caché assigns the value http://tempuri.org. Developers traditionally use this value during Web Service development. It should be changed prior to deployment. |
SERVICENAME | The value of this parameter provides the client's name for the service. It should be a valid identifier. That is, it should start with a letter and contain only alphanumeric characters. |
In most situations, you will use Caché to automatically generate the proxy classes using the Web Service producer's WSDL document. The proxy classes will fulfill all of these requirements.