SEND SOAP FAULT

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2003


SEND SOAP FAULT (faultType; description)

ParameterTypeDescription
faultTypeLongint1 = Client fault, 2 = Server fault
descriptionStringDescription of error to be sent to SOAP client

Description

The SEND SOAP FAULT command is used to return an error to a SOAP client indicating the origin of the fault: client or server. Using this command enables you to indicate an error to a client without having to return a result.

For instance, a fault on the client side may be detected when you publish a "Square_root" Web Service and a client sends a request with a negative number; you can use this command in order to indicate to the client that a positive value is required.

A possible fault on the server side may be, for instance, a lack of memory occurring during method execution.

Pass the origin of the error in faultType. You can use the following predefined constants, located in the "Web Services (Server)" theme:

ConstantTypeValue
SOAP Client FaultLongint1
SOAP Server FaultLongint2

Pass a description of the error in description. If the client implementation is in conformity, the error can be processed.

Example

To go back to the example of the "Square_root" Web Service provided in the command description, the following command can be used to process requests with negative numbers:

   SEND SOAP FAULT(SOAP Client Fault;"Positive values required")

See Also

Get SOAP info, SOAP DECLARATION.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next